기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 의 보안 AWS X-Ray
의 클라우드 보안이 최우선 순위 AWS 입니다. AWS 고객은 보안에 가장 민감한 조직의 요구 사항을 충족하도록 구축된 데이터 센터 및 네트워크 아키텍처의 이점을 누릴 수 있습니다.
보안은 AWS 와 사용자 간의 공동 책임입니다. [공동 책임 모델](https://aws.amazon.com/compliance/shared-responsibility-model/)은 이를 클라우드*의* 보안과 클라우드 *내* 보안으로 설명합니다.
+ **클라우드 보안 **- AWS 는 AWS 서비스 에서 실행되는 인프라를 보호할 책임이 있습니다 AWS 클라우드. AWS 또한는 안전하게 사용할 수 있는 서비스를 제공합니다. 서드 파티 감사자는 정기적으로 [AWS 규정 준수 프로그램](https://aws.amazon.com/compliance/programs/)의 일환으로 보안 효과를 테스트하고 검증합니다. X-Ray에 적용되는 규정 준수 프로그램에 대한 자세한 내용은 [규정 준수 프로그램 제공 범위 내의AWS 서비스](https://aws.amazon.com/compliance/services-in-scope/)를 참조하세요.
+ **클라우드의 보안** - 사용자의 책임은 AWS 서비스 사용하는에 따라 결정됩니다. 또한 데이터의 민감도, 조직의 요건 및 관련 법률 및 규정을 비롯한 기타 요소에 대해서도 책임이 있습니다.
이 설명서는 X-Ray 사용 시 공동 책임 모델을 적용하는 방법을 이해하는 데 도움이 됩니다. 다음 주제에서는 보안 및 규정 준수 목표를 충족하도록 X-Ray를 구성하는 방법을 보여줍니다. 또한 X-Ray 리소스를 모니터링하고 보호하는 데 도움이 AWS 서비스 되는 다른를 사용하는 방법도 알아봅니다.
**주제**
+ [의 데이터 보호AWS X-Ray](xray-console-encryption.md)
+ [에 대한 자격 증명 및 액세스 관리 AWS X-Ray](security-iam.md)
+ [에 대한 규정 준수 검증 AWS X-Ray](compliance-validation.md)
+ [AWS X-Ray의 복원성](disaster-recovery-resiliency.md)
+ [AWS X-Ray에서 인프라 보안](infrastructure-security.md)
# 의 데이터 보호AWS X-Ray
AWS X-Ray는 항상 트레이스 및 관련 유휴 데이터를 암호화합니다. 규정 준수 또는 내부 요건 때문에 암호화 키를 감사하고 비활성화해야 하는 경우, 데이터 암호화에 AWS Key Management Service (AWS KMS) 키를 사용하도록 X-Ray를 구성할 수 있습니다.
X-Ray는 `aws/xray`라는 이름의 AWS 관리형 키을 제공합니다. [AWS CloudTrail에서 키 사용을 감사](https://docs.aws.amazon.com/kms/latest/developerguide/logging-using-cloudtrail.html)하고 키 자체를 관리할 필요가 없으면 이 키를 사용하십시오. 키에 대한 액세스를 관리하거나 키 교체를 구성해야 할 경우 [고객 관리 키를 생성](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html)할 수 있습니다.
암호화 설정을 변경하면 X-Ray가 데이터 키를 생성하고 전파하느라 시간이 다소 소모됩니다. 새 키를 처리하는 동안 X-Ray가 새 설정과 기존 설정을 조합하여 데이터를 암호화할 수 있습니다. 암호화 설정을 변경할 때 기존 데이터는 재암호화하지 않습니다.
**참고**
X-Ray가 KMS 키로 추적 데이터를 암호화하거나 암호화를 해제할 때 AWS KMS 요금이 부과됩니다.
**기본 암호화** – 무료.
**AWS 관리형 키**— 키 사용료를 지불하세요.
**고객 관리 키** – 키 보관 및 사용료가 부과됩니다.
자세한 내용은 [AWS Key Management Service 요금](https://aws.amazon.com/kms/pricing/)을 참조하세요.
**참고**
X-Ray 인사이트 알림은 현재 고객 관리 키를 지원하지 않는 Amazon EventBridge로 이벤트를 전송합니다. 자세한 내용은 [Amazon EventBridge의 데이터 보호](https://docs.aws.amazon.com/eventbridge/latest/userguide/data-protection.html)를 참조하십시오.
고객 관리 키를 사용하여 암호화된 트레이스를 보도록 X-Ray를 구성하려면 고객 관리 키에 대한 사용자 수준 액세스 권한이 있어야 합니다. 자세한 정보는 [암호화에 대한 사용자 권한](security_iam_service-with-iam.md#xray-permissions-encryption)을 참조하세요.
------
#### [ CloudWatch console ]
**CloudWatch 콘솔을 사용하여 암호화에 KMS 키를 사용하도록 X-Ray를 구성하려면**
1. AWS Management Console에 로그인하고 [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)에서 CloudWatch 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **설정**을 선택합니다.
1. **X-Ray 추적** 섹션의 **암호화**에서 **설정 보기**를 선택합니다.
1. **암호화 구성** 섹션에서 **편집**을 선택합니다.
1. **KMS 키 사용**을 선택합니다.
1. 드롭다운 메뉴에서 키를 선택합니다.
+ **aws/xray** — AWS 관리형 키를 사용하십시오.
+ *키 별칭* – 계정에서 고객 관리형 CMK를 사용합니다.
+ **키 ARN 수동 입력** – 다른 계정에 있는 고객 관리 키를 사용합니다. 나타나는 필드에 키의 Amazon 리소스 이름(ARN)을 전체 다 입력합니다.
1. **Update encryption (암호화 업데이트)**를 선택합니다.
------
#### [ X-Ray console ]
**X-Ray 콘솔을 사용하여 암호화에 KMS 키를 사용하도록 X-Ray를 구성하려면**
1. [X-Ray 콘솔](https://console.aws.amazon.com/xray/home#)을 엽니다.
1. **암호화**를 선택합니다.
1. **KMS 키 사용**을 선택합니다.
1. 드롭다운 메뉴에서 키를 선택합니다.
+ **aws/xray** — AWS 관리형 키를 사용하십시오.
+ *키 별칭* – 계정에서 고객 관리형 CMK를 사용합니다.
+ **키 ARN 수동 입력** – 다른 계정에 있는 고객 관리 키를 사용합니다. 나타나는 필드에 키의 Amazon 리소스 이름(ARN)을 전체 다 입력합니다.
1. **Apply(적용)**를 선택합니다.
------
**참고**
X-Ray는 비대칭 KMS 키를 지원하지 않습니다.
X-Ray가 암호화 키에 액세스하지 못하면 데이터 저장이 중단됩니다. KMS 키가 액세스를 잃어버리거나 현재 사용 중인 키를 비활성화하는 경우 이런 일이 발생합니다. 이 경우 X-Ray가 탐색 창에 알림을 표시합니다.
X-Ray API로 암호화 설정을 구성하려면 [AWS X-Ray API를 사용하여 샘플링, 그룹 및 암호화 설정 구성](xray-api-configuration.md) 섹션을 참조하십시오.
# 에 대한 자격 증명 및 액세스 관리 AWS X-Ray
AWS Identity and Access Management (IAM)는 관리자가 AWS 리소스에 대한 액세스를 안전하게 제어하는 데 도움이 AWS 서비스 되는 입니다. IAM 관리자는 누가 X-Ray 리소스를 사용하도록 *인증*되고(로그인됨) *권한이 부여*되는지(권한 있음)를 제어합니다. IAM은 추가 비용 없이 사용할 수 AWS 서비스 있는 입니다.
**Topics**
+ [대상](#security_iam_audience)
+ [ID를 통한 인증](#security_iam_authentication)
+ [정책을 사용하여 액세스 관리](#security_iam_access-manage)
+ [AWS X-Ray 에서 IAM을 사용하는 방법](security_iam_service-with-iam.md)
+ [AWS X-Ray 자격 증명 기반 정책 예제](security_iam_id-based-policy-examples.md)
+ [AWS X-Ray 자격 증명 및 액세스 문제 해결](security_iam_troubleshoot.md)
## 대상
AWS Identity and Access Management (IAM)를 사용하는 방법은 역할에 따라 다릅니다.
+ **서비스 사용자** - 기능에 액세스할 수 없는 경우 관리자에게 권한 요청(참조[AWS X-Ray 자격 증명 및 액세스 문제 해결](security_iam_troubleshoot.md))
+ **서비스 관리자** - 사용자 액세스 결정 및 권한 요청 제출([AWS X-Ray 에서 IAM을 사용하는 방법](security_iam_service-with-iam.md) 참조)
+ **IAM 관리자** - 액세스를 관리하기 위한 정책 작성([AWS X-Ray 자격 증명 기반 정책 예제](security_iam_id-based-policy-examples.md) 참조)
## ID를 통한 인증
인증은 자격 증명 자격 증명을 AWS 사용하여에 로그인하는 방법입니다. AWS 계정 루트 사용자, IAM 사용자 또는 IAM 역할을 수임하여 인증해야 합니다.
AWS IAM Identity Center (IAM Identity Center), Single Sign-On 인증 또는 Google/Facebook 자격 증명과 같은 자격 증명 소스의 자격 증명을 사용하여 페더레이션 자격 증명으로 로그인할 수 있습니다. 로그인하는 방법에 대한 자세한 내용은 *AWS Sign-In 사용 설명서*의 [AWS 계정에 로그인하는 방법](https://docs.aws.amazon.com/signin/latest/userguide/how-to-sign-in.html) 섹션을 참조하세요.
프로그래밍 방식 액세스를 위해는 요청에 암호화 방식으로 서명할 수 있는 SDK 및 CLI를 AWS 제공합니다. 자세한 내용은 *IAM 사용 설명서*의 [API 요청용AWS Signature Version 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html) 섹션을 참조하세요.
### AWS 계정 루트 사용자
를 생성할 때 모든 AWS 서비스 및 리소스에 대한 완전한 액세스 권한이 있는 AWS 계정 *theroot 사용자*라는 하나의 로그인 자격 증명으로 AWS 계정시작합니다. 일상적인 태스크에 루트 사용자를 사용하지 않을 것을 강력히 권장합니다. 루트 사용자가 필요한 작업 목록은 *IAM 사용자 설명서*의 [루트 사용자 자격 증명이 필요한 작업](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)을 참조하세요.
### IAM 사용자 및 그룹
*[IAM 사용자](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users.html)*는 단일 개인 또는 애플리케이션에 대한 특정 권한을 가진 ID입니다. 장기 자격 증명이 있는 IAM 사용자 대신 임시 자격 증명을 사용하는 것이 좋습니다. 자세한 내용은 *IAM 사용 설명서*의 자격 [증명 공급자와의 페더레이션을 사용하여 임시 자격 증명을 AWS 사용하여에 액세스하도록 인간 사용자에게 요구](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp)하기를 참조하세요.
[https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups.html](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups.html)은 IAM 사용자 모음을 지정하고 대규모 사용자 집합에 대한 관리 권한을 더 쉽게 만듭니다. 자세한 내용은 *IAM 사용 설명서*의 [IAM 사용자 사용 사례](https://docs.aws.amazon.com/IAM/latest/UserGuide/gs-identities-iam-users.html) 섹션을 참조하세요.
### IAM 역할
*[IAM 역할](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)*은 임시 자격 증명을 제공하는 특정 권한이 있는 자격 증명입니다. [사용자에서 IAM 역할(콘솔)로 전환하거나 또는 API 작업을 호출하여 역할을](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-console.html) 수임할 수 있습니다. AWS CLI AWS 자세한 내용은 *IAM 사용 설명서*의 [역할 수임 방법](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage-assume.html)을 참조하세요.
IAM 역할은 페더레이션 사용자 액세스, 임시 IAM 사용자 권한, 교차 계정 액세스, 교차 서비스 액세스 및 Amazon EC2에서 실행되는 애플리케이션에 유용합니다. 자세한 내용은 *IAM 사용 설명서*의 [교차 계정 리소스 액세스](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)를 참조하세요.
## 정책을 사용하여 액세스 관리
정책을 AWS 생성하고 자격 증명 또는 리소스에 연결하여 AWS 에서 액세스를 제어합니다. 정책은 자격 증명 또는 리소스와 연결될 때 권한을 정의합니다.는 보안 주체가 요청할 때 이러한 정책을 AWS 평가합니다. 대부분의 정책은에 JSON 문서 AWS 로 저장됩니다. JSON 정책 문서에 대한 자세한 내용은 *IAM 사용 설명서*의 [JSON 정책 개요](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#access_policies-json) 섹션을 참조하세요.
정책을 사용하여 관리자는 어떤 **보안 주체**가 어떤 **리소스**에 대해 어떤 **조건**에서 **작업**을 수행할 수 있는지 정의하여 누가 무엇을 액세스할 수 있는지 지정합니다.
기본적으로 사용자 및 역할에는 어떠한 권한도 없습니다. IAM 관리자는 IAM 정책을 생성하고 사용자가 수임할 수 있는 역할에 추가합니다. IAM 정책은 작업을 수행하기 위해 사용하는 방법과 관계없이 작업에 대한 권한을 정의합니다.
### ID 기반 정책
ID 기반 정책은 ID(사용자, 사용자 그룹 또는 역할)에 연결하는 JSON 권한 정책 문서입니다. 이러한 정책은 자격 증명이 수행할 수 있는 작업, 대상 리소스 및 이에 관한 조건을 제어합니다. ID 기반 정책을 생성하는 방법을 알아보려면 *IAM 사용 설명서*에서 [고객 관리형 정책으로 사용자 지정 IAM 권한 정의](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)를 참조하세요.
ID 기반 정책은 *인라인 정책*(단일 ID에 직접 포함) 또는 *관리형 정책*(여러 ID에 연결된 독립 실행형 정책)일 수 있습니다. 관리형 정책 또는 인라인 정책을 선택하는 방법을 알아보려면 *IAM 사용 설명서*의 [관리형 정책 및 인라인 정책 중에서 선택](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-choosing-managed-or-inline.html) 섹션을 참조하세요.
### 리소스 기반 정책
리소스 기반 정책은 리소스에 연결하는 JSON 정책 설명서입니다. 예를 들어 IAM *역할 신뢰 정책* 및 Amazon S3 *버킷 정책*이 있습니다. 리소스 기반 정책을 지원하는 서비스에서 서비스 관리자는 이러한 정책을 사용하여 특정 리소스에 대한 액세스를 통제할 수 있습니다. 리소스 기반 정책에서 [보안 주체를 지정](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html)해야 합니다.
리소스 기반 정책은 해당 서비스에 있는 인라인 정책입니다. 리소스 기반 정책에서는 IAM의 AWS 관리형 정책을 사용할 수 없습니다.
### 액세스 제어 목록(ACL)
액세스 제어 목록(ACL)은 어떤 위탁자(계정 멤버, 사용자 또는 역할)가 리소스에 액세스할 수 있는 권한을 가지고 있는지를 제어합니다. ACL은 JSON 정책 문서 형식을 사용하지 않지만 리소스 기반 정책과 유사합니다.
Amazon S3 AWS WAF및 Amazon VPC는 ACLs. ACL에 관한 자세한 내용은 *Amazon Simple Storage Service 개발자 가이드*의 [액세스 제어 목록(ACL) 개요](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html)를 참조하세요.
### 기타 정책 타입
AWS 는 보다 일반적인 정책 유형에서 부여한 최대 권한을 설정할 수 있는 추가 정책 유형을 지원합니다.
+ **권한 경계** - ID 기반 정책에서 IAM 엔터티에 부여할 수 있는 최대 권한을 설정합니다. 자세한 정보는 *IAM 사용 설명서*의 [IAM 엔터티의 권한 범위](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html)를 참조하세요.
+ **서비스 제어 정책(SCP)** - AWS Organizations내 조직 또는 조직 단위에 대한 최대 권한을 지정합니다. 자세한 내용은AWS Organizations 사용 설명서의 [서비스 제어 정책](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html)을 참조하세요.**
+ **리소스 제어 정책(RCP)** – 계정의 리소스에 사용할 수 있는 최대 권한을 설정합니다. 자세한 내용은 *AWS Organizations 사용 설명서*의 [리소스 제어 정책(RCP)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_rcps.html)을 참조하세요.
+ **세션 정책** – 역할 또는 페더레이션 사용자에 대해 임시 세션을 프로그래밍 방식으로 생성할 때 파라미터로 전달하는 고급 정책입니다. 자세한 내용은 *IAM 사용 설명서*의 [세션 정책](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html#policies_session)을 참조하세요.
### 여러 정책 유형
여러 정책 유형이 요청에 적용되는 경우, 결과 권한은 이해하기가 더 복잡합니다. 에서 여러 정책 유형이 관련될 때 요청을 허용할지 여부를 AWS 결정하는 방법을 알아보려면 *IAM 사용 설명서*의 [정책 평가 로직](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_evaluation-logic.html)을 참조하세요.
# AWS X-Ray 에서 IAM을 사용하는 방법
IAM을 사용하여 X-Ray에 대한 액세스를 관리하려면 먼저 어떤 IAM 기능을 X-Ray와 함께 사용할 수 있는지를 이해해야 합니다. X-Ray 및 기타에서 IAM을 AWS 서비스 사용하는 방법을 개괄적으로 알아보려면 *IAM 사용 설명서의* [AWS 서비스 IAM으로 작업하기를](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) 참조하세요.
AWS Identity and Access Management (IAM)를 사용하여 계정의 사용자 및 컴퓨팅 리소스에 X-Ray 권한을 부여할 수 있습니다. IAM은 API 수준에서 X-Ray 서비스에 대한 액세스를 제어하여 사용자가 사용하는 클라이언트(콘솔, AWS SDK AWS CLI)에 관계없이 권한을 균일하게 적용합니다.
[X-Ray 콘솔을 사용](aws-xray-interface-console.md#xray-console)하여 트레이스 맵과 세그먼트를 보려면 읽기 권한만 있으면 됩니다. 콘솔 액세스를 활성화하려면 `AWSXrayReadOnlyAccess` [관리형 정책](security_iam_id-based-policy-examples.md#xray-permissions-managedpolicies)을 IAM 사용자에 추가합니다.
[로컬 개발 및 테스트](#xray-permissions-local)를 위해서는 읽기 및 쓰기 권한을 갖는 IAM 역할을 생성합니다. [역할을 맡고](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html) 역할에 대한 임시 자격 증명을 저장합니다. 이러한 자격 증명을 X-Ray 데몬, AWS CLI및 AWS SDK와 함께 사용할 수 있습니다. 자세한 내용은 [AWS CLI임시 보안 자격 증명 사용](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html#using-temp-creds-sdk-cli)을 참조하세요.
계[측된 앱을에 배포 AWS](#xray-permissions-aws)하려면 쓰기 권한이 있는 IAM 역할을 생성하고 애플리케이션을 실행하는 리소스에 할당합니다. `AWSXRayDaemonWriteAccess`에는 트레이스를 업로드할 수 있는 권한과 [샘플링 규칙](xray-console-sampling.md) 사용을 지원하는 몇 가지 읽기 권한도 포함되어 있습니다.
읽기 및 쓰기 정책에는 [암호화 키 설정](xray-console-encryption.md) 및 샘플링 규칙을 구성할 권한은 포함되지 않습니다. `AWSXrayFullAccess`을 사용하여 이러할 설정에 액세스하거나, 사용자 지정 정책에서 [구성 API](xray-api-configuration.md)를 추가합니다. 생성하는 고객 관리형 키를 사용한 암호화 및 해독을 위해서는 [해당 키를 사용할 권한](#xray-permissions-encryption)도 필요합니다.
**Topics**
+ [X-Ray identity-based 자격 증명 기반 정책](#security_iam_service-with-iam-id-based-policies)
+ [X-Ray 리소스 기반 정책](#security_iam_service-with-iam-resource-based-policies)
+ [X-Ray 태그 기반 인증](#security_iam_service-with-iam-tags)
+ [로컬에서 애플리케이션 실행](#xray-permissions-local)
+ [에서 애플리케이션 실행 AWS](#xray-permissions-aws)
+ [암호화에 대한 사용자 권한](#xray-permissions-encryption)
## X-Ray identity-based 자격 증명 기반 정책
IAM ID 기반 정책을 사용하면 허용되거나 거부되는 작업과 리소스뿐 아니라 작업이 허용되거나 거부되는 조건을 지정할 수 있습니다. X-Ray는 특정 작업, 리소스 및 조건 키를 지원합니다. JSON 정책에서 사용하는 모든 요소에 대해 알고 싶다면 *IAM 사용 설명서*의 [IAM JSON 정책 요소 참조](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)를 참조하세요.
### 작업
관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 **보안 주체**가 어떤 **리소스**와 어떤 **조건**에서 **작업**을 수행할 수 있는지를 지정할 수 있습니다.
JSON 정책의 `Action`요소는 정책에서 액세스를 허용하거나 거부하는 데 사용할 수 있는 작업을 설명합니다. 연결된 작업을 수행할 수 있는 권한을 부여하기 위한 정책에 작업을 포함하세요.
X-Ray의 정책 작업은 작업 앞에 다음 접두사를 사용합니다. `xray:` 예를 들어 X-Ray `GetGroup` API 작업을 사용하여 그룹 리소스 세부 정보를 검색하는 권한을 부여하려면 해당 정책에 `xray:GetGroup` 작업을 포함합니다. 정책 문에는 `Action` 또는 `NotAction` 요소가 포함되어야 합니다. X-Ray는 이 서비스로 수행할 수 있는 작업을 설명하는 고유한 작업 세트를 정의합니다.
명령문 하나에 여러 태스크를 지정하려면 다음과 같이 쉼표로 구분합니다.
```
"Action": [
"xray:action1",
"xray:action2"
```
와일드카드(\$1)를 사용하여 여러 작업을 지정할 수 있습니다. 예를 들어, `Get`라는 단어로 시작하는 모든 작업을 지정하려면 다음 작업을 포함합니다.
```
"Action": "xray:Get*"
```
X-Ray 작업 목록을 보려면 *IAM 사용 설명서*의 [AWS X-Ray에서 정의한 작업](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awsx-ray.html)을 참조하세요.
### 리소스
관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지 지정할 수 있습니다. 즉, 어떤 **보안 주체**가 어떤 **리소스**와 어떤 **조건**에서 **작업**을 수행할 수 있는지를 지정할 수 있습니다.
`Resource` JSON 정책 요소는 작업이 적용되는 하나 이상의 객체를 지정합니다. 모범 사례에 따라 [Amazon 리소스 이름(ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html)을 사용하여 리소스를 지정합니다. 리소스 수준 권한을 지원하지 않는 작업의 경우, 와일드카드(\$1)를 사용하여 해당 문이 모든 리소스에 적용됨을 나타냅니다.
```
"Resource": "*"
```
IAM 정책을 사용하여 리소스에 대한 액세스를 제어할 수 있습니다. 리소스 수준의 권한을 지원하는 작업은 Amazon 리소스 이름(ARN)을 사용하여 정책이 적용되는 리소스를 확인할 수 있습니다.
IAM 정책에서 모든 X-Ray 작업을 사용하여 해당 작업을 사용하기 위한 사용자 권한을 부여하거나 거부할 수 있습니다. 하지만 모든 [X-Ray 작업](https://docs.aws.amazon.com/xray/latest/api/API_Operations.html)이 리소스 수준 권한을 지원하는 것은 아닙니다. 여기에서 리소스 수준 권한이란 작업이 가능한 리소스를 지정할 수 있는 권한을 말합니다.
리소스 수준 권한을 지원하지 않는 작업의 경우 "`*`"를 리소스로 사용해야 합니다.
다음 X-Ray 작업은 리소스 수준 권한을 지원합니다.
+ `CreateGroup`
+ `GetGroup`
+ `UpdateGroup`
+ `DeleteGroup`
+ `CreateSamplingRule`
+ `UpdateSamplingRule`
+ `DeleteSamplingRule`
다음은 `CreateGroup` 작업에 대한 자격 증명 기반 권한 정책 예제입니다. 이 예제에서는 와일드카드로 고유 ID를 가지는 그룹 이름 `local-users`와 관련된 ARN의 사용을 보여줍니다. 고유 ID는 그룹을 만들 때 생성되기 때문에 정책에서 미리 예측할 수 없습니다. `GetGroup`, `UpdateGroup` 또는 `DeleteGroup`을 사용할 때, 이는 ID를 포함하여 와일드카드 또는 정확한 ARN으로 정의될 수 있습니다.
**참고**
샘플링 규칙의 ARN은 규칙의 이름으로 정의됩니다. 그룹 ARN과 달리 샘플링 규칙은 따로 생성되는 고유 ID가 없습니다.
X-Ray 리소스 유형 및 해당 ARN의 목록을 보려면 *IAM 사용 설명서*의 [AWS X-Ray에서 정의된 리소스](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awsx-ray.html#awsx-ray-resources-for-iam-policies)를 참조하세요. 각 리소스의 ARN을 지정할 수 있는 작업을 알아보려면 [AWS X-Ray가 정의한 작업](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_awsx-ray.html)을 참조하세요.
### 조건 키
X-Ray는 서비스별 조건 키를 제공하지 않지만, 일부 전역 조건 키 사용을 지원합니다. 모든 AWS 전역 조건 키를 보려면 *IAM 사용 설명서*의 [AWS 전역 조건 컨텍스트 키를 참조하세요](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html).
### 예제
X-Ray 자격 증명 기반 정책의 예를 보려면 [AWS X-Ray 자격 증명 기반 정책 예제](security_iam_id-based-policy-examples.md) 단원을 참조하세요.
## X-Ray 리소스 기반 정책
X-Ray는 [Amazon SNS 활성 추적](https://docs.aws.amazon.com/sns/latest/dg/sns-active-tracing.html)과 같은 현재 및 향후 AWS 서비스 통합을 위한 리소스 기반 정책을 지원합니다. X-Ray 리소스 기반 정책은 다른 AWS Management Console또는 AWS SDK 또는 CLI를 통해 업데이트할 수 있습니다. 예를 들어, Amazon SNS 콘솔은 X-Ray로 추적을 전송하기 위한 리소스 기반 정책을 자동으로 구성하려고 시도합니다. 다음 정책 문서에서는 X-Ray 리소스 기반 정책을 수동으로 구성하는 예제를 제공합니다.
**Example Amazon SNS 활성 추적에 대한 X-Ray 리소스 기반 정책 예시**
이 예시 정책 문서는 추적 데이터를 X-Ray로 전송하는 데 필요한 Amazon SNS의 권한을 지정합니다.
```
{
Version: "2012-10-17",
Statement: [
{
Sid: "SNSAccess",
Effect: Allow,
Principal: {
Service: "sns.amazonaws.com",
},
Action: [
"xray:PutTraceSegments",
"xray:GetSamplingRules",
"xray:GetSamplingTargets"
],
Resource: "*",
Condition: {
StringEquals: {
"aws:SourceAccount": "account-id"
},
StringLike: {
"aws:SourceArn": "arn:partition:sns:region:account-id:topic-name"
}
}
}
]
}
```
CLI를 사용하여 추적 데이터를 X-Ray로 전송할 수 있는 Amazon SNS 권한을 부여하는 리소스 기반 정책을 생성합니다.
```
aws xray put-resource-policy --policy-name MyResourcePolicy --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Sid": "SNSAccess", "Effect": "Allow", "Principal": { "Service": "sns.amazonaws.com" }, "Action": [ "xray:PutTraceSegments", "xray:GetSamplingRules", "xray:GetSamplingTargets" ], "Resource": "*", "Condition": { "StringEquals": { "aws:SourceAccount": "account-id" }, "StringLike": { "aws:SourceArn": "arn:partition:sns:region:account-id:topic-name" } } } ] }'
```
이러한 예제를 사용하려면 *`partition`*, *`account-id`*, 및 *`region`**`topic-name`*를 특정 AWS 파티션, 리전, 계정 ID 및 Amazon SNS 주제 이름으로 바꿉니다. 모든 Amazon SNS 주제가 추적 데이터를 X-Ray로 전송하도록 권한을 부여하려면 주제 이름을 `*`로 바꾸십시오.
## X-Ray 태그 기반 인증
X-Ray 그룹이나 샘플링 규칙에 태그를 첨부하거나 요청에 포함된 태그를 X-Ray에 전달할 수 있습니다. 태그에 근거하여 액세스를 제어하려면 `xray:ResourceTag/key-name`, `aws:RequestTag/key-name`또는 `aws:TagKeys`조건 키를 사용하여 정책의 [조건 요소](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)에 태그 정보를 제공합니다. X-Ray 리소스 태깅에 대한 자세한 내용은 [X-Ray 샘플링 규칙 및 그룹 태그 지정하기](xray-tagging.md) 단원을 참조하세요.
리소스의 태그를 기반으로 리소스에 대한 액세스를 제한하는 자격 증명 기반 정책의 예시는 [태그에 기반한 X-Ray 그룹 및 샘플링 규칙에 대한 액세스 관리](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-manage-sampling-tags)에서 확인할 수 있습니다.
## 로컬에서 애플리케이션 실행
계측된 애플리케이션은 추적 데이터를 X-Ray 대몬(daemon)으로 전송합니다. 대몬(daemon)은 세그먼트 문서를 버퍼링하여 X-Ray 서비스에 일괄적으로 업로드합니다. 대몬(daemon)이 추적 데이터와 원격 분석을 X-Ray 서비스에 업로드하려면 쓰기 권한이 필요합니다.
[대몬(daemon)을 로컬에서 실행하는](xray-daemon-local.md) 경우 IAM 역할을 생성하고 [역할을 수임한 다음](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use.html) 환경 변수나 사용자 폴더의 `.aws`라는 폴더 내 `credentials`라는 파일에 임시 자격 증명을 저장합니다. 자세한 내용은 [AWS CLI임시 보안 자격 증명 사용](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html#using-temp-creds-sdk-cli)을 참조하세요.
**Example \$1/.aws/credentials**
```
[default]
aws_access_key_id={access key ID}
aws_secret_access_key={access key}
aws_session_token={AWS session token}
```
AWS SDK 또는와 함께 사용할 자격 증명을 이미 구성한 경우 데몬 AWS CLI이 이를 사용할 수 있습니다. 여러 프로파일을 사용할 수 있을 경우 대몬(daemon)은 기본 프로파일을 사용합니다.
## 에서 애플리케이션 실행 AWS
에서 애플리케이션을 실행할 때 역할을 AWS사용하여 데몬을 실행하는 Amazon EC2 인스턴스 또는 Lambda 함수에 권한을 부여합니다.
+ **Amazon Elastic Compute Cloud(Amazon EC2)** – IAM 역할을 생성하고 [인스턴스 프로파일](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/iam-roles-for-amazon-ec2.html)로 EC2 인스턴스에 연결합니다.
+ **Amazon Elastic Container Service(Amazon ECS)** — IAM 역할을 생성하고 컨테이너 인스턴스에 [컨테이너 인스턴스 IAM 역할](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/instance_IAM_role.html)로 연결합니다.
+ **AWS Elastic Beanstalk (Elastic Beanstalk)** - Elastic Beanstalk는 [기본 인스턴스 프로파일](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/concepts-roles.html#concepts-roles-instance)에 X-Ray 권한을 포함합니다. 기본 인스턴스 프로파일을 사용하거나 쓰기 권한을 사용자 지정 인스턴스 프로파일에 추가할 수 있습니다.
+ **AWS Lambda (Lambda)** - 함수의 실행 역할에 쓰기 권한을 추가합니다.
**X-Ray에 사용할 역할을 생성하려면**
1. [IAM 콘솔](https://console.aws.amazon.com/iam/home)을 엽니다.
1. **역할**을 선택합니다.
1. **새 역할 생성**을 선택합니다.
1. **Role Name(역할 이름)**에 **xray-application**을 입력합니다. **다음 단계**를 선택합니다.
1. [**Role Type**]에서 [**Amazon EC2**]를 선택합니다.
1. 관리형 정책을 연결하여 애플리케이션에 AWS 서비스서비스에 대한 액세스를 부여합니다.
+ **AWSXRayDaemonWriteAccess** – X-Ray 대몬(daemon)에 추적 데이터를 업로드할 수 있는 권한을 부여합니다.
애플리케이션이 AWS SDK를 사용하여 다른 서비스에 액세스하는 경우 해당 서비스에 대한 액세스 권한을 부여하는 정책을 추가합니다.
1. **다음 단계**를 선택합니다.
1. **역할 생성**을 선택합니다.
## 암호화에 대한 사용자 권한
X-Ray는 모든 트레이스 데이터를 기본적으로 암호화하며, [관리하는 키를 사용하도록 구성](xray-console-encryption.md)할 수 있습니다. AWS Key Management Service 고객 관리형 키를 선택하는 경우 키의 액세스 정책을 통해 X-Ray에 암호화에 사용할 수 있는 권한을 부여할 수 있는지 확인해야 합니다. 계정의 다른 사용자도 X-Ray 콘솔에서 암호화된 추적 데이터를 보려면 키에 대한 액세스 권한이 필요합니다.
고객 관리형 키의 경우 다음 작업을 허용하는 액세스 정책으로 키를 구성합니다.
+ X-Ray에서 키를 구성하는 사용자는 `kms:CreateGrant` 및 `kms:DescribeKey`를 직접 호출할 수 있는 권한을 가집니다.
+ 암호화된 추적 데이터에 액세스할 수 있는 사용자는 `kms:Decrypt`를 호출할 수 있는 권한을 가집니다.
IAM 콘솔의 키 구성 섹션에서 **키 사용자** 그룹에 사용자를 추가하면 해당 사용자는 이 두 가지 작업에 대한 권한을 갖게 됩니다. 권한은 키 정책에만 설정하면 되므로 사용자, 그룹 또는 역할에 대한 AWS KMS 권한이 필요하지 않습니다. 자세한 내용은 [AWS KMS 개발자 안내서의 키 정책 사용을 참조하세요](https://docs.aws.amazon.com/kms/latest/developerguide/key-policies.html).
기본 암호화의 경우 또는 AWS 관리형 CMK(`aws/xray`)를 선택하는 경우 권한은 X-Ray APIs. `AWSXrayFullAccess`에 포함된 [https://docs.aws.amazon.com/xray/latest/api/API_PutEncryptionConfig.html](https://docs.aws.amazon.com/xray/latest/api/API_PutEncryptionConfig.html)에 액세스할 수 있는 사람은 누구나 암호화 구성을 변경할 수 있습니다. 사용자가 암호화 키를 변경하지 못하게 하려면 [https://docs.aws.amazon.com/xray/latest/api/API_PutEncryptionConfig.html](https://docs.aws.amazon.com/xray/latest/api/API_PutEncryptionConfig.html)를 사용할 권한을 부여하지 마세요.
# AWS X-Ray 자격 증명 기반 정책 예제
기본적으로 사용자 및 역할에는 X-Ray 리소스를 생성하거나 수정할 수 있는 권한이 없습니다. 또한 AWS Management Console AWS CLI또는 AWS API를 사용하여 작업을 수행할 수 없습니다. 관리자는 지정된 리소스에서 특정 API 태스크를 수행할 수 있는 권한을 사용자와 역할에게 부여하는 IAM 정책을 생성해야 합니다. 그런 다음 관리자는 해당 권한이 필요한 사용자 또는 그룹에 이러한 정책을 연결해야 합니다.
이러한 예제 JSON 정책 문서를 사용하여 IAM ID 기반 정책을 생성하는 방법을 알아보려면 *IAM 사용자 설명서*의 [JSON 탭에서 정책 생성](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-json-editor)을 참조하세요.
**Topics**
+ [정책 모범 사례](#security_iam_service-with-iam-policy-best-practices)
+ [X-Ray 콘솔 사용하기](#security_iam_id-based-policy-examples-console)
+ [사용자가 자신이 권한을 볼 수 있도록 허용](#security_iam_id-based-policy-examples-view-own-permissions)
+ [태그에 기반한 X-Ray 그룹 및 샘플링 규칙에 대한 액세스 관리](#security_iam_id-based-policy-examples-manage-sampling-tags)
+ [X-Ray에 대한 IAM 관리 정책](#xray-permissions-managedpolicies)
+ [AWS 관리형 정책에 대한 X-Ray 업데이트](#xray-permissions-managedpolicies-history)
+ [IAM 정책 내에서 리소스 지정](#xray-permissions-resources)
## 정책 모범 사례
ID 기반 정책에 따라 계정에서 사용자가 X-Ray 리소스를 생성, 액세스 또는 삭제할 수 있는지 여부가 결정됩니다. 이 작업으로 인해 AWS 계정에 비용이 발생할 수 있습니다. ID 기반 정책을 생성하거나 편집할 때는 다음 지침과 권장 사항을 따르세요.
+ ** AWS 관리형 정책을 시작하고 최소 권한으로 전환 -** 사용자 및 워크로드에 권한 부여를 시작하려면 많은 일반적인 사용 사례에 대한 권한을 부여하는 *AWS 관리형 정책을* 사용합니다. 에서 사용할 수 있습니다 AWS 계정. 사용 사례에 맞는 AWS 고객 관리형 정책을 정의하여 권한을 추가로 줄이는 것이 좋습니다. 자세한 내용은 *IAM 사용 설명서*의 [AWS 관리형 정책](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-vs-inline.html#aws-managed-policies) 또는 [AWS 직무에 대한 관리형 정책](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_job-functions.html)을 참조하세요.
+ **최소 권한 적용** – IAM 정책을 사용하여 권한을 설정하는 경우, 작업을 수행하는 데 필요한 권한만 부여합니다. 이렇게 하려면 *최소 권한*으로 알려진 특정 조건에서 특정 리소스에 대해 수행할 수 있는 작업을 정의합니다. IAM을 사용하여 권한을 적용하는 방법에 대한 자세한 정보는 *IAM 사용 설명서*에 있는 [IAM의 정책 및 권한](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)을 참조하세요.
+ **IAM 정책의 조건을 사용하여 액세스 추가 제한** – 정책에 조건을 추가하여 작업 및 리소스에 대한 액세스를 제한할 수 있습니다. 예를 들어, SSL을 사용하여 모든 요청을 전송해야 한다고 지정하는 정책 조건을 작성할 수 있습니다. AWS 서비스와 같은 특정를 통해 사용되는 경우 조건을 사용하여 서비스 작업에 대한 액세스 권한을 부여할 수도 있습니다 CloudFormation. 자세한 내용은 *IAM 사용 설명서*의 [IAM JSON 정책 요소: 조건](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)을 참조하세요.
+ **IAM Access Analyzer를 통해 IAM 정책을 확인하여 안전하고 기능적인 권한 보장** - IAM Access Analyzer에서는 IAM 정책 언어(JSON)와 모범 사례가 정책에서 준수되도록 새로운 및 기존 정책을 확인합니다. IAM Access Analyzer는 100개 이상의 정책 확인 항목과 실행 가능한 추천을 제공하여 안전하고 기능적인 정책을 작성하도록 돕습니다. 자세한 내용은 *IAM 사용 설명서*의 [IAM Access Analyzer에서 정책 검증](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-validation.html)을 참조하세요.
+ **다중 인증(MFA) 필요 -**에서 IAM 사용자 또는 루트 사용자가 필요한 시나리오가 있는 경우 추가 보안을 위해 MFA를 AWS 계정켭니다. API 작업을 직접적으로 호출할 때 MFA가 필요하면 정책에 MFA 조건을 추가합니다. 자세한 내용은 *IAM 사용 설명서*의 [MFA를 통한 보안 API 액세스](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa_configure-api-require.html)를 참조하세요.
IAM의 모범 사례에 대한 자세한 내용은 *IAM 사용 설명서*의 [IAM의 보안 모범 사례](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html)를 참조하세요.
## X-Ray 콘솔 사용하기
AWS X-Ray 콘솔에 액세스하려면 최소 권한 집합이 있어야 합니다. 이러한 권한은에서 X-Ray 리소스에 대한 세부 정보를 나열하고 볼 수 있도록 허용해야 합니다 AWS 계정. 최소 필수 권한보다 더 제한적인 ID 기반 정책을 생성하는 경우, 콘솔이 해당 정책에 연결된 엔티티(사용자 또는 역할)에 대해 의도대로 작동하지 않습니다.
이러한 엔터티가 여전히 X-Ray 콘솔을 사용할 수 있도록 하려면 `AWSXRayReadOnlyAccess` AWS 관리형 정책을 엔터티에 연결합니다. 이 정책은 [X-Ray의 IAM 관리형 정책](#xray-permissions-managedpolicies)에 자세히 설명되어 있습니다. 자세한 내용은 *IAM 사용 설명서*의 [사용자에게 권한 추가](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console)를 참조하십시오.
AWS CLI 또는 AWS API만 호출하는 사용자에게는 최소 콘솔 권한을 허용할 필요가 없습니다. 그 대신, 수행하려는 API 작업과 일치하는 작업에만 액세스할 수 있도록 합니다.
## 사용자가 자신이 권한을 볼 수 있도록 허용
이 예제는 IAM 사용자가 자신의 사용자 ID에 연결된 인라인 및 관리형 정책을 볼 수 있도록 허용하는 정책을 생성하는 방법을 보여줍니다. 이 정책에는 콘솔에서 또는 AWS CLI 또는 AWS API를 사용하여 프로그래밍 방식으로이 작업을 완료할 수 있는 권한이 포함됩니다.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "ViewOwnUserInfo",
"Effect": "Allow",
"Action": [
"iam:GetUserPolicy",
"iam:ListGroupsForUser",
"iam:ListAttachedUserPolicies",
"iam:ListUserPolicies",
"iam:GetUser"
],
"Resource": ["arn:aws:iam::*:user/${aws:username}"]
},
{
"Sid": "NavigateInConsole",
"Effect": "Allow",
"Action": [
"iam:GetGroupPolicy",
"iam:GetPolicyVersion",
"iam:GetPolicy",
"iam:ListAttachedGroupPolicies",
"iam:ListGroupPolicies",
"iam:ListPolicyVersions",
"iam:ListPolicies",
"iam:ListUsers"
],
"Resource": "*"
}
]
}
```
## 태그에 기반한 X-Ray 그룹 및 샘플링 규칙에 대한 액세스 관리
ID 기반 정책의 조건을 사용하여 태그를 기반으로 X-Ray 그룹 및 샘플링 규칙에 대한 액세스를 제어할 수 있습니다. 다음 예제 정책은 사용자 역할에 대해 태그 `stage:prod` 또는 `stage:preprod`를 사용하여 그룹을 생성, 삭제 또는 업데이트할 수 있는 사용자 역할의 권한을 거부하는 데 사용할 수 있습니다. X-Ray 샘플링 규칙 및 그룹 태깅에 대한 자세한 내용은 [X-Ray 샘플링 규칙 및 그룹 태그 지정하기](xray-tagging.md)을 참조하십시오.
샘플링 규칙 생성을 거부하려면 `aws:RequestTag`을 사용하여 생성 요청의 일부로 전달할 수 없는 태그를 표시하세요. 샘플링 규칙의 업데이트 또는 삭제를 거부하려면 `aws:ResourceTag`를 사용하여 해당 리소스의 태그에 기반한 작업을 거부하십시오.
계정 내 사용자에게 이러한 정책을 첨부(또는 단일 정책으로 결합한 다음 정책을 첨부)할 수 있습니다. 사용자가 그룹 또는 샘플링 규칙을 변경하려면 그룹 또는 샘플링 규칙에 `stage=prepod` 또는 `stage=prod` 태그를 지정해서는 안 됩니다. 조건 키 이름은 대소문자를 구분하지 않기 때문에 조건 태그 키 `Stage`는 `Stage` 및 `stage` 모두와 일치합니다. 조건 블록에 대한 자세한 내용은 *IAM 사용 설명서*의 [IAM JSON 정책 요소: 조건](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)을 참조하세요.
다음 정책이 연결된 역할을 가진 사용자는 리소스에 `role:admin` 태그를 추가할 수 없으며 `role:admin`가 연결된 리소스에서 태그를 제거할 수 없습니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowAllXRay",
"Effect": "Allow",
"Action": "xray:*",
"Resource": "*"
},
{
"Sid": "DenyRequestTagAdmin",
"Effect": "Deny",
"Action": "xray:TagResource",
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:RequestTag/role": "admin"
}
}
},
{
"Sid": "DenyResourceTagAdmin",
"Effect": "Deny",
"Action": "xray:UntagResource",
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:ResourceTag/role": "admin"
}
}
}
]
}
```
------
## X-Ray에 대한 IAM 관리 정책
권한 부여를 간소화하기 위해 IAM은 각 서비스에 대해 **관리형 정책**을 지원합니다. 서비스는 새 APIs.는 읽기 전용, 쓰기 전용 및 관리자 사용 사례에 대한 관리형 정책을 AWS X-Ray 제공합니다.
+ `AWSXrayReadOnlyAccess` - X-Ray 콘솔 AWS CLI또는 AWS SDK를 사용하여 X-Ray API에서 트레이스 데이터, 트레이스 맵, 인사이트 및 X-Ray 구성을 가져올 수 있는 읽기 권한입니다. 콘솔에서 [CloudWatch 교차 계정 통합 관찰성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html)의 일부로 소스 계정에서 공유된 추적을 볼 수 있도록 하는 통합 관찰성 액세스 관리자(OAM) `oam:ListSinks` 및 `oam:ListAttachedSinks` 권한이 포함되어 있습니다. `BatchGetTraceSummaryById` 및 `GetDistinctTraceGraphs` API 작업은 코드에서 호출하기 위한 것이 아니며 AWS CLI 및 AWS SDKs에 포함되지 않습니다.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"xray:GetSamplingRules",
"xray:GetSamplingTargets",
"xray:GetSamplingStatisticSummaries",
"xray:BatchGetTraces",
"xray:BatchGetTraceSummaryById",
"xray:GetDistinctTraceGraphs",
"xray:GetServiceGraph",
"xray:GetTraceGraph",
"xray:GetTraceSummaries",
"xray:GetGroups",
"xray:GetGroup",
"xray:ListTagsForResource",
"xray:ListResourcePolicies",
"xray:GetTimeSeriesServiceStatistics",
"xray:GetInsightSummaries",
"xray:GetInsight",
"xray:GetInsightEvents",
"xray:GetInsightImpactGraph",
"oam:ListSinks"
],
"Resource": [
"*"
]
},
{
"Effect": "Allow",
"Action": [
"oam:ListAttachedLinks"
],
"Resource": "arn:aws:oam:*:*:sink/*"
}
}
```
+ `AWSXRayDaemonWriteAccess` - X-Ray 데몬 AWS CLI또는 AWS SDK를 사용하여 세그먼트 문서 및 원격 측정을 X-Ray API에 업로드할 수 있는 쓰기 권한입니다. [샘플링 규칙](xray-console-sampling.md)을 가져오고 샘플링 결과를 보고할 읽기 권한이 포함됩니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"xray:PutTraceSegments",
"xray:PutTelemetryRecords",
"xray:GetSamplingRules",
"xray:GetSamplingTargets",
"xray:GetSamplingStatisticSummaries"
],
"Resource": [
"*"
]
}
]
}
```
------
+ `AWSXrayCrossAccountSharingConfiguration` – 계정 간에 X-Ray 리소스를 공유하기 위한 Observability Access Manager 링크를 만들고, 관리하고, 볼 수 있는 권한을 부여합니다. 소스 계정과 모니터링 계정 간의 [CloudWatch 계정 간 관찰성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html)을 활성화하는 데 사용됩니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"xray:Link",
"oam:ListLinks"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"oam:DeleteLink",
"oam:GetLink",
"oam:TagResource"
],
"Resource": "arn:aws:oam:*:*:link/*"
},
{
"Effect": "Allow",
"Action": [
"oam:CreateLink",
"oam:UpdateLink"
],
"Resource": [
"arn:aws:oam:*:*:link/*",
"arn:aws:oam:*:*:sink/*"
]
}
]
}
```
------
+ `AWSXrayFullAccess` – 읽기 권한, 쓰기 권한 및 암호화 키 설정과 샘플링 규칙을 구성할 권한을 포함하여 모든 X-Ray API를 사용할 권한입니다. 콘솔에서 [CloudWatch 교차 계정 통합 관찰성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html)의 일부로 소스 계정에서 공유된 추적을 볼 수 있도록 하는 통합 관찰성 액세스 관리자(OAM) `oam:ListSinks` 및 `oam:ListAttachedSinks` 권한이 포함되어 있습니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"xray:*",
"oam:ListSinks"
],
"Resource": [
"*"
]
},
{
"Effect": "Allow",
"Action": [
"oam:ListAttachedLinks"
],
"Resource": "arn:aws:oam:*:*:sink/*"
}
]
}
```
------
**관리형 정책을 IAM 사용자 그룹 또는 역할에 추가하는 방법**
1. [IAM 콘솔](https://console.aws.amazon.com/iam/home)을 엽니다.
1. 인스턴스 프로파일, IAM 사용자 또는 IAM 사용자 그룹과 연결된 역할을 엽니다.
1. **권한**에서 관리형 정책을 연결합니다.
## AWS 관리형 정책에 대한 X-Ray 업데이트
이 서비스가 이러한 변경 사항을 추적하기 시작한 이후부터 X-Ray의 AWS 관리형 정책 업데이트에 대한 세부 정보를 봅니다. 이 페이지의 변경 사항에 대한 자동 알림을 받으려면 X-Ray [문서 기록](document-history.md) 페이지에서 RSS 피드를 구독하세요.
| 변경 | 설명 | Date |
| --- | --- | --- |
| [X-Ray용 IAM 관리형 정책](#xray-permissions-managedpolicies) — 새로운 `AWSXrayCrossAccountSharingConfiguration` 및 업데이트된 `AWSXrayReadOnlyAccess` 및 `AWSXrayFullAccess` 정책이 추가되었습니다. | X-Ray는 콘솔에서 [CloudWatch 교차 계정 통합 관찰성](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html)의 일부로 소스 계정에서 공유된 추적을 볼 수 있도록 이러한 정책에 통합 관찰성 액세스 관리자(OAM) 권한 `oam:ListSinks` 및 `oam:ListAttachedSinks`가 추가되었습니다. | 2022년 11월 27일 |
| [X-Ray용 IAM 관리형 정책](#xray-permissions-managedpolicies) — `AWSXrayReadOnlyAccess` 정책 업데이트 | X-Ray가 `ListResourcePolicies` API 작업을 추가했습니다. | 2022년 11월 15일 |
| [X-Ray 콘솔 사용](#security_iam_id-based-policy-examples-console) — `AWSXrayReadOnlyAccess` 정책 업데이트 | X-Ray는 두 개의 새로운 API 작업 `BatchGetTraceSummaryById`과 `GetDistinctTraceGraphs`를 추가했으며, 이 작업들은 코드로 호출되는 것이 아닙니다. 따라서 이러한 API 작업은 AWS CLI 및 AWS SDKs에 포함되지 않습니다. | 2022년 11월 11일 |
## IAM 정책 내에서 리소스 지정
IAM 정책을 사용하여 리소스에 대한 액세스를 제어할 수 있습니다. 리소스 수준의 권한을 지원하는 작업은 Amazon 리소스 이름(ARN)을 사용하여 정책이 적용되는 리소스를 확인할 수 있습니다.
IAM 정책에서 모든 X-Ray 작업을 사용하여 해당 작업을 사용하기 위한 사용자 권한을 부여하거나 거부할 수 있습니다. 하지만 모든 [X-Ray 작업](https://docs.aws.amazon.com/xray/latest/api/API_Operations.html)이 리소스 수준 권한을 지원하는 것은 아닙니다. 여기에서 리소스 수준 권한이란 작업이 가능한 리소스를 지정할 수 있는 권한을 말합니다.
리소스 수준 권한을 지원하지 않는 작업의 경우 "`*`"를 리소스로 사용해야 합니다.
다음 X-Ray 작업은 리소스 수준 권한을 지원합니다.
+ `CreateGroup`
+ `GetGroup`
+ `UpdateGroup`
+ `DeleteGroup`
+ `CreateSamplingRule`
+ `UpdateSamplingRule`
+ `DeleteSamplingRule`
다음은 `CreateGroup` 작업에 대한 자격 증명 기반 권한 정책 예제입니다. 이 예제에서는 와일드카드로 고유 ID를 가지는 그룹 이름 `local-users`와 관련된 ARN의 사용을 보여줍니다. 고유 ID는 그룹을 만들 때 생성되기 때문에 정책에서 미리 예측할 수 없습니다. `GetGroup`, `UpdateGroup` 또는 `DeleteGroup`을 사용할 때, 이는 ID를 포함하여 와일드카드 또는 정확한 ARN으로 정의될 수 있습니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"xray:CreateGroup"
],
"Resource": [
"arn:aws:xray:eu-west-1:123456789012:group/local-users/*"
]
}
]
}
```
------
다음은 `CreateSamplingRule` 작업에 대한 자격 증명 기반 권한 정책 예제입니다.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"xray:CreateSamplingRule"
],
"Resource": [
"arn:aws:xray:eu-west-1:123456789012:sampling-rule/base-scorekeep"
]
}
]
}
```
------
**참고**
샘플링 규칙의 ARN은 규칙의 이름으로 정의됩니다. 그룹 ARN과 달리 샘플링 규칙은 따로 생성되는 고유 ID가 없습니다.
# AWS X-Ray 자격 증명 및 액세스 문제 해결
다음 정보를 사용하여 X-Ray 및 IAM에서 발생할 수 있는 공통적인 문제를 진단하고 수정할 수 있습니다.
**Topics**
+ [X-Ray에서 작업을 수행할 권한이 없음](#security_iam_troubleshoot-no-permissions)
+ [iam:PassRole을 수행할 권한이 없음](#security_iam_troubleshoot-passrole)
+ [관리자인데, 다른 사용자가 X-Ray에 액세스할 수 있게 허용하려고 합니다](#security_iam_troubleshoot-admin-delegate)
+ [내 외부의 사람이 내 X-Ray 리소스 AWS 계정 에 액세스하도록 허용하고 싶습니다.](#security_iam_troubleshoot-cross-account-access)
## X-Ray에서 작업을 수행할 권한이 없음
에서 작업을 수행할 권한이 없다는 AWS Management Console 메시지가 표시되면 관리자에게 문의하여 도움을 받아야 합니다. 관리자는 로그인 보안 인증 정보를 제공한 사람입니다.
다음 예의 오류는 `mateojackson` 사용자가 콘솔을 사용하여 샘플링 규칙에 대한 세부 정보를 보려고 하지만 `xray:GetSamplingRules` 권한이 없는 경우에 발생합니다.
```
User: arn:aws:iam::123456789012:user/mateojackson is not authorized to perform: xray:GetSamplingRules on resource: arn:${Partition}:xray:${Region}:${Account}:sampling-rule/${SamplingRuleName}
```
이 경우 Mateo는 `xray:GetSamplingRules` 작업을 사용하여 샘플링 규칙 리소스에 대한 액세스를 허용하도록 정책을 업데이트할 것을 관리자에게 요청합니다.
## iam:PassRole을 수행할 권한이 없음
`iam:PassRole` 작업을 수행할 수 있는 권한이 없다는 오류가 수신되면 X-Ray에 역할을 전달할 수 있도록 정책을 업데이트해야 합니다.
일부 AWS 서비스 에서는 새 서비스 역할 또는 서비스 연결 역할을 생성하는 대신 기존 역할을 해당 서비스에 전달할 수 있습니다. 이렇게 하려면 역할을 서비스에 전달할 권한이 있어야 합니다.
다음 예제 오류는 `marymajor`(이)라는 IAM 사용자가 콘솔을 사용하여 X-Ray에서 작업을 수행하려고 하는 경우에 발생합니다. 하지만 작업을 수행하려면 서비스 역할이 부여한 권한이 서비스에 있어야 합니다. Mary는 서비스에 역할을 전달할 권한이 없습니다.
```
User: arn:aws:iam::123456789012:user/marymajor is not authorized to perform: iam:PassRole
```
이 경우, Mary가 `iam:PassRole`작업을 수행할 수 있도록 Mary의 정책을 업데이트해야 합니다.
도움이 필요한 경우 AWS 관리자에게 문의하세요. 관리자는 로그인 자격 증명을 제공한 사람입니다.
## 관리자인데, 다른 사용자가 X-Ray에 액세스할 수 있게 허용하려고 합니다
다른 사용자가 X-Ray에 액세스할 수 있도록 허용하려면 액세스가 필요한 사용자 또는 애플리케이션에 권한을 부여해야 합니다. AWS IAM Identity Center 를 사용하여 사용자 및 애플리케이션을 관리하는 경우 사용자 또는 그룹에 권한 세트를 할당하여 액세스 수준을 정의합니다. 권한 세트는 IAM 정책을 자동으로 생성하고 사용자 또는 애플리케이션과 연결된 IAM 역할에 할당합니다. 자세한 내용은 *AWS IAM Identity Center 사용 설명서*에서 [권한 세트](https://docs.aws.amazon.com/singlesignon/latest/userguide/permissionsetsconcept.html)를 참조하세요.
IAM Identity Center를 사용하지 않는 경우 액세스가 필요한 사용자 또는 애플리케이션에 대한 IAM 엔터티(사용자 또는 역할)를 생성해야 합니다. 그런 다음 X-ray에 대한 올바른 권한을 부여하는 정책을 엔터티에 연결해야 합니다. 권한이 부여되면 사용자 또는 애플리케이션 개발자에게 자격 증명을 제공합니다. 이들은 이 자격 증명을 사용하여 AWS에 액세스합니다. IAM 사용자, 그룹, 정책 및 권한 생성에 대해 자세히 알아보려면 *IAM 사용자 설명서*의 [IAM 자격 증명](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html)과 [IAM의 권한 및 정책](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)을 참조하세요.
## 내 외부의 사람이 내 X-Ray 리소스 AWS 계정 에 액세스하도록 허용하고 싶습니다.
다른 계정의 사용자 또는 조직 외부의 사람이 리소스에 액세스할 때 사용할 수 있는 역할을 생성할 수 있습니다. 역할을 수임할 신뢰할 수 있는 사람을 지정할 수 있습니다. 리소스 기반 정책 또는 액세스 제어 목록(ACL)을 지원하는 서비스의 경우, 이러한 정책을 사용하여 다른 사람에게 리소스에 대한 액세스 권한을 부여할 수 있습니다.
자세한 내용은 다음을 참조하세요.
+ X-Ray에서 이러한 기능을 지원하는지 여부를 알아보려면 [AWS X-Ray 에서 IAM을 사용하는 방법](security_iam_service-with-iam.md) 단원을 참조하세요.
+ 소유 AWS 계정 한의 리소스에 대한 액세스 권한을 제공하는 방법을 알아보려면 [IAM 사용 설명서의 소유한 다른의 IAM 사용자에게 액세스 권한 제공을 참조 AWS 계정 하세요](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_aws-accounts.html). **
+ 리소스에 대한 액세스 권한을 타사에 제공하는 방법을 알아보려면 *IAM 사용 설명서*의 [타사 AWS 계정 소유에 대한 액세스 권한 제공을](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_third-party.html) AWS 계정참조하세요.
+ ID 페더레이션을 통해 액세스 권한을 제공하는 방법을 알아보려면 *IAM 사용 설명서*의 [외부에서 인증된 사용자에게 액세스 권한 제공(ID 페더레이션)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_federated-users.html)을 참조하세요.
+ 크로스 계정 액세스에 대한 역할과 리소스 기반 정책 사용의 차이점을 알아보려면 *IAM 사용 설명서*의 [IAM의 크로스 계정 리소스 액세스](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html)를 참조하세요.
# AWS X-Ray에서 로깅 및 모니터링
모니터링은 AWS 솔루션의 안정성, 가용성 및 성능을 유지하는 중요한 역할을 합니다. 다중 지점 실패가 발생할 경우 보다 쉽게 디버깅할 수 있도록 AWS 솔루션의 모든 부분으로부터 모니터링 데이터를 수집해야 합니다. AWS는 X-Ray 리소스를 모니터링하고 잠재적 인시던트에 대응하기 위한 여러 도구를 제공합니다.
**AWS CloudTrail 로그**
AWS X-Ray는 X-Ray에서 사용자, 역할 또는 AWS 서비스가 수행한 API 작업을 기록하기 위하여 AWS CloudTrail과 통합됩니다. CloudTrail을 사용하여 X-Ray API 요청을 실시간으로 모니터링하고 Amazon S3, Amazon CloudWatch Logs 및 Amazon CloudWatch Events에 로그를 저장할 수 있습니다. 자세한 내용은 [를 사용하여 X-Ray API 호출 로깅 AWS CloudTrail](xray-api-cloudtrail.md) 섹션을 참조하세요.
**AWS Config 추적**
AWS X-Ray는 AWS Config와 통합되어 X-Ray 암호화 리소스에 대한 구성 변경을 기록합니다. AWS Config을 사용하여 암호화 리소스를 인벤토리하고, X-Ray 구성 기록을 감사하고, 리소스 변경에 대한 알림을 보낼 수 있습니다. 자세한 내용은 [AWS Config를 사용하여 X-Ray 암호화 구성 변경 추적하기](xray-api-config.md) 섹션을 참조하세요.
**Amazon CloudWatch 모니터링**
Java용 X-Ray SDK를 사용하여 수집된 X-Ray 세그먼트에서 샘플링되지 않은 Amazon CloudWatch 지표를 게시할 수 있습니다. 이러한 지표는 세그먼트의 시작 및 종료 시간과 오류, 장애 및 스로틀된 상태 플래그에서 파생됩니다. 이러한 트레이스 지표를 사용하여 하위 세그먼트 내에서 재시도 및 종속성 문제를 표시할 수 있습니다. 자세한 내용은 [AWS X-Ray Java용 X-Ray SDK에 대한 지표](xray-sdk-java.md#xray-sdk-java-monitoring) 섹션을 참조하세요.
# 에 대한 규정 준수 검증 AWS X-Ray
AWS 서비스 가 특정 규정 준수 프로그램의 범위 내에 있는지 알아보려면 [AWS 서비스 규정 준수 프로그램 제공 범위 내](https://aws.amazon.com/compliance/services-in-scope/)를 참조하고 관심 있는 규정 준수 프로그램을 선택합니다. 일반 정보는 [AWS 규정 준수 프로그램](https://aws.amazon.com/compliance/programs/).
를 사용하여 타사 감사 보고서를 다운로드할 수 있습니다 AWS Artifact. 자세한 내용은 [Downloading Reports inDownloading AWS Artifact](https://docs.aws.amazon.com/artifact/latest/ug/downloading-documents.html)을 참조하세요.
사용 시 규정 준수 책임은 데이터의 민감도, 회사의 규정 준수 목표 및 관련 법률과 규정에 따라 AWS 서비스 결정됩니다. 사용 시 규정 준수 책임에 대한 자세한 내용은 [AWS 보안 설명서를](https://docs.aws.amazon.com/security/) AWS 서비스참조하세요.
# AWS X-Ray의 복원성
AWS 글로벌 인프라는 AWS 리전 및 가용 영역을 중심으로 구축됩니다. AWS 리전에서는 물리적으로 분리되고 격리된 다수의 가용 영역을 제공하며 이러한 가용 영역은 짧은 대기 시간, 높은 처리량 및 높은 중복성을 갖춘 네트워크에 연결되어 있습니다. 가용 영역을 사용하면 중단 없이 가용 영역 간에 자동으로 장애 조치가 이루어지는 애플리케이션 및 데이터베이스를 설계하고 운영할 수 있습니다. 가용 영역은 기존의 단일 또는 복수 데이터 센터 인프라보다 가용성, 내결함성, 확장성이 뛰어납니다.
AWS 리전 및 가용 영역에 대한 자세한 내용은 [AWS 글로벌 인프라](https://aws.amazon.com/about-aws/global-infrastructure/) 섹션을 참조하세요.
# AWS X-Ray에서 인프라 보안
관리형 서비스인 AWS X-Ray은 AWS 글로벌 네트워크 보안으로 보호됩니다. AWS 보안 서비스와 AWS의 인프라 보호 방법에 대한 자세한 내용은 [AWS 클라우드 보안](https://aws.amazon.com/security/)을 참조하세요. 인프라 보안에 대한 모범 사례를 사용하여 AWS 환경을 설계하려면 *보안 원칙 AWS Well‐Architected Framework*의 [인프라 보호](https://docs.aws.amazon.com/wellarchitected/latest/security-pillar/infrastructure-protection.html)를 참조하십시오.
AWS에서 게시한 API 직접 호출을 사용하여 네트워크를 통해 X-Ray에 액세스합니다. 고객은 다음을 지원해야 합니다.
+ Transport Layer Security(TLS) TLS 1.2는 필수이며 TLS 1.3을 권장합니다.
+ DHE(Ephemeral Diffie-Hellman) 또는 ECDHE(Elliptic Curve Ephemeral Diffie-Hellman)와 같은 완전 전송 보안(PFS)이 포함된 암호 제품군 Java 7 이상의 최신 시스템은 대부분 이러한 모드를 지원합니다.
# VPC 엔드포인트와 함께 AWS X-Ray 사용
Amazon Virtual Private Cloud(VPC)를 사용하여 AWS 리소스를 호스트하는 경우, VPC와 X-Ray간에 프라이빗 연결을 설정할 수 있습니다. 이 연결을 사용하면 X-Ray 서비스가 퍼블릭 인터넷을 통하지 않고 Amazon VPC의 리소스와 통신할 수 있게 해줍니다.
Amazon VPC란 사용자가 정의한 가상 네트워크에서 AWS 리소스를 시작할 때 사용할 수 있는 AWS 서비스입니다. VPC를 사용하여 IP 주소 범위, 서브넷, 라우팅 테이블, 네트워크 게이트웨이 등의 네트워크 설정을 제어할 수 있습니다. VPC를 X-Ray에 연결하려면 [인터페이스 VPC 엔드포인트](https://docs.aws.amazon.com/vpc/latest/privatelink/vpce-interface.html)를 정의하십시오. 이 엔드포인트를 이용하면 인터넷 게이트웨이나 Network Address Translation(NAT) 인스턴스, 또는 VPN 연결 없이도 X-Ray에 안정적이고 확장 가능하게 연결됩니다. 자세한 내용은 *Amazon VPC 사용 설명서*의 [Amazon VPC란 무엇입니까](https://docs.aws.amazon.com/vpc/latest/userguide/)를 참조하세요.
인터페이스 VPC 엔드포인트는 프라이빗 IP 주소와 함께 탄력적 네트워크 인터페이스를 사용하여 AWS 서비스 간 프라이빗 통신을 사용할 수 있는 AWS 기술인 AWS PrivateLink에 의해 구동됩니다. 자세한 내용은 *Amazon VPC 사용 설명서*의 [신규 — AWS PrivateLink AWS 서비스](https://aws.amazon.com/blogs/aws/new-aws-privatelink-endpoints-kinesis-ec2-systems-manager-and-elb-apis-in-your-vpc/) 블로그 게시물 및 [시작하기](https://docs.aws.amazon.com/vpc/latest/userguide/GetStarted.html)를 참조하십시오.
선택한 AWS 리전 항목에 X-Ray용 VPC 엔드포인트를 생성할 수 있는지 확인하려면 [지원되는 리전](#xray-vpc-availability)를 참조하십시오.
## X-Ray용 VPC 엔드포인트 생성
VPC에서 X-Ray를 사용하려면 X-Ray용 인터페이스 VPC 엔드포인트를 생성하세요.
1. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/)에서 Amazon VPC 콘솔을 엽니다.
1. 탐색 창에서 **엔드포인트**로 이동한 다음 **엔드포인트 생성**을 선택합니다.
1. AWS X-Ray 서비스 이름을 검색하여 선택합니다: `com.amazonaws.region.xray`.
![\[서비스를 선택합니다.\]](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/xray-vpc-select-service.png)
1. 원하는 VPC를 선택한 다음 인터페이스 엔드포인트를 사용할 VPC의 서브넷을 선택합니다. 선택한 서브넷에서 엔드포인트 네트워크 인터페이스가 생성됩니다. 각기 다른 가용 영역(서비스에 의해 지원)에서 하나 이상의 서브넷을 지정하여 인터페이스 엔드포인트가 가용 영역 장애 발생 시 복원을 지원합니다. 이렇게 하면 지정한 각 서브넷에 인터페이스 네트워크 인터페이스가 생성됩니다.
![\[VPC 및 서브넷을 선택합니다.\]](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/xray-vpc-select-vpc.png)
1. (선택 사항) 개인 DNS는 기본적으로 엔드포인트에 대해 활성화되어 있으므로 기본 DNS 호스트 이름을 사용하여 X-Ray에 요청할 수 있습니다. 필요에 따라 비활성화하도록 선택할 수 있습니다.
1. 보안 그룹을 지정하여 엔드포인트 네트워크 인터페이스와 연결합니다.
![\[보안 그룹 선택\]](http://docs.aws.amazon.com/ko_kr/xray/latest/devguide/images/xray-vpc-select-secgroup.png)
1. (선택 사항) X-Ray 서비스에 액세스할 수 있는 권한을 제어하는 사용자 지정 정책을 지정합니다. 기본적으로 전체 액세스 권한이 허용됩니다.
## X-Ray VPC 엔드포인트에 대한 액세스 제어
VPC 엔드포인트 정책은 엔드포인트를 만들거나 수정 시 엔드포인트에 연결하는 IAM 리소스 정책입니다. 엔드포인트를 생성할 때 정책을 연결하지 않으면 Amazon VPC는 서비스에 대한 전체 액세스를 허용하는 기본 정책을 자동으로 연결합니다. 엔드포인트 정책은 IAM 사용자 정책 또는 서비스별 정책을 재정의하거나 대체하지 않습니다. 이는 엔드포인트에서 지정된 서비스로의 액세스를 제어하기 위한 별도의 정책입니다. 엔드포인트 정책은 JSON 형식으로 작성해야 합니다. 자세한 내용은 *Amazon VPC 사용 설명서*의 [VPC 엔드포인트를 통해 서비스에 대한 액세스 제어](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-endpoints-access.html)를 참조하세요.
VPC 엔드포인트 정책을 통해 다양한 X-Ray 작업에 대한 권한을 제어할 수 있습니다. 예를 들어 PutTraceSegment만 허용하고 다른 모든 작업은 거부하도록 정책을 생성할 수 있습니다. 이렇게 하면 VPC의 워크로드 및 서비스가 추적 데이터만 X-Ray로 전송하고 데이터 검색, 암호화 구성 변경, 그룹 생성/업데이트와 같은 다른 작업은 거부하도록 제한됩니다.
다음은 X-Ray에 대한 엔드포인트 정책의 예입니다. 이 정책은 사용자가 VPC를 통해 X-Ray에 연결하여 X-Ray로 지표 데이터를 전송할 수 있도록 허용하고, 다른 X-Ray 작업을 수행하지 못하게 금지합니다.
```
{"Statement": [
{"Sid": "Allow PutTraceSegments",
"Principal": "*",
"Action": [
"xray:PutTraceSegments"
],
"Effect": "Allow",
"Resource": "*"
}
]
}
```
**X-Ray에 대한 VPC 엔드포인트 정책을 편집하려면**
1. [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/)에서 Amazon VPC 콘솔을 엽니다.
1. 탐색 창에서 **엔드포인트**를 선택합니다.
1. X-Ray용 엔드포인트를 아직 생성하지 않은 경우 [X-Ray용 VPC 엔드포인트 생성](#create-VPC-endpoint-for-xray)의 과정을 따르십시오.
1. **com.amazonaws.*region*.xray** 엔드포인트를 선택한 다음 **정책** 탭을 선택합니다.
1. **정책 편집**을 선택한 다음 변경합니다.
## 지원되는 리전
현재 X-Ray가 VPC 엔드포인트를 지원하는 AWS 리전은 다음과 같습니다.
+ 미국 동부(오하이오)
+ 미국 동부(버지니아 북부)
+ 미국 서부(캘리포니아 북부)
+ 미국 서부(오리건)
+ 아프리카(케이프타운)
+ 아시아 태평양(홍콩)
+ 아시아 태평양(뭄바이)
+ 아시아 태평양(오사카)
+ 아시아 태평양(서울)
+ 아시아 태평양(싱가포르)
+ 아시아 태평양(시드니)
+ 아시아 태평양(도쿄)
+ 캐나다(중부)
+ 유럽(프랑크푸르트)
+ 유럽(아일랜드)
+ 유럽(런던)
+ 유럽(밀라노)
+ 유럽(파리)
+ 유럽(스톡홀름)
+ 중동(바레인)
+ 남아메리카(상파울루)
+ AWS GovCloud(미국 동부)
+ AWS GovCloud(미국 서부)
# 교차 서비스 혼동된 대리인 방지
혼동된 대리자 문제는 작업을 수행할 권한이 없는 엔터티가 권한이 더 많은 엔터티에게 작업을 수행하도록 강요할 수 있는 보안 문제입니다. 에서 AWS교차 서비스 가장은 혼동된 대리자 문제를 초래할 수 있습니다. 교차 서비스 가장은 한 서비스(*직접 호출하는 서비스*)가 다른 서비스(*직접 호출되는 서비스*)를 직접 호출할 때 발생할 수 있습니다. 직접 호출하는 서비스는 다른 고객의 리소스에 대해 액세스 권한이 없는 방식으로 작동하게 권한을 사용하도록 조작될 수 있습니다. 이를 방지하기 위해 AWS 에서는 계정의 리소스에 대한 액세스 권한이 부여된 서비스 위탁자를 사용하여 모든 서비스에 대한 데이터를 보호하는 데 도움이 되는 도구를 제공합니다.
AWS X-Ray가 리소스에 대해 다른 서비스에 제공하는 권한을 제한하려면 리소스 정책에서 [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourcearn](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourcearn), [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceaccount](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceaccount), [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceorgid](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceorgid), [https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceorgpaths](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-sourceorgpaths) 글로벌 조건 컨텍스트 키를 사용하는 것이 좋습니다. `aws:SourceArn`을 사용하면 하나의 리소스만 교차 서비스 액세스 권한과 연결됩니다. `aws:SourceAccount`를 사용하면 해당 계정의 모든 리소스가 교차 서비스 사용 권한과 연결됩니다. `aws:SourceOrgID`를 사용하면 조직 내 모든 계정의 모든 리소스가 교차 서비스 사용 권한과 연결될 수 있습니다. `aws:SourceOrgPaths`를 사용하면 AWS Organizations 경로 내 계정의 모든 리소스가 교차 서비스 사용 권한과 연결됩니다. 경로 사용 및 이해에 대한 자세한 내용은 [AWS Organizations 개체 경로 이해를](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_access-advisor-view-data-orgs.html#access_policies_access-advisor-viewing-orgs-entity-path) 참조하세요.
혼동된 대리인 문제로부터 보호하는 가장 효과적인 방법은 리소스의 전체 ARN이 포함된 `aws:SourceArn`글로벌 조건 컨텍스트 키를 사용하는 것입니다. 리소스의 전체 ARN을 모르거나 여러 리소스를 지정하는 경우, ARN의 알 수 없는 부분에 대해 와일드카드 문자(`*`)를 포함한 `aws:SourceArn` 글로벌 조건 컨텍스트 키를 사용합니다. 예: `arn:aws:servicename:*:123456789012:*`
만약 `aws:SourceArn` 값에 Amazon S3 버킷 ARN과 같은 계정 ID가 포함되어 있지 않은 경우, 권한을 제한하려면 두 `aws:SourceAccount` 및 `aws:SourceArn`를 모두 사용해야 합니다.
혼동된 대리자 문제로부터 보호하려면 리소스 기반 정책에서 리소스의 조직 ID 또는 조직 경로와 함께 `aws:SourceOrgID` 또는 `aws:SourceOrgPaths` 글로벌 조건 컨텍스트 키를 사용합니다. `aws:SourceOrgID` 또는 `aws:SourceOrgPaths` 키가 포함된 정책에는 올바른 계정이 자동으로 포함되며 조직에서 계정을 추가, 제거 또는 이동할 때 정책을 수동으로 업데이트할 필요가 없습니다.
다음 예는 X-Ray의 `aws:SourceArn` 및 `aws:SourceAccount` 전역 조건 컨텍스트 키를 사용하여 혼동된 대리자 문제를 방지하는 방법을 보여줍니다.
```
{
"Sid": "BlockCrossAccountUnlessSameSource",
"Effect": "Deny",
"Principal": {
"AWS": "*"
},
"Action": [
"kms:Decrypt",
"kms:GenerateDataKeyWithoutPlaintext"
],
"Resource": "*",
"Condition": {
"StringNotEquals": {
"aws:PrincipalAccount": "123456789012",
"aws:SourceAccount": "123456789012"
},
"ArnNotLike": {
"aws:SourceArn": "arn:*:*:*:123456789012:*"
}
}
}
```