AWS X-Ray에서 IAM을 사용하는 방식 - AWS X-Ray

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS X-Ray에서 IAM을 사용하는 방식

IAM을 사용하여 X-Ray에 대한 액세스를 관리하기 전에 X-Ray에서 사용할 수 있는 IAM 기능이 무엇인지 이해해야 합니다. X-Ray 및 기타 방법을 개괄적으로 파악하려면AWS 서비스IAM으로 작업하려면 다음을 참조하십시오.AWS 서비스IAM과 함께 작동하는 방법... 에서IAM 사용자 가이드.

사용할 수 있습니다AWS Identity and Access Management(IAM) 을 사용하여 계정 내 사용자 및 컴퓨팅 리소스에 X-Ray 권한을 부여합니다. IAM은 API 수준에서 X-Ray 서비스에 대한 액세스를 제어하여 어떤 클라이언트 (콘솔,AWSSDK,AWS CLI) 사용자가 사용하는 경우

에게X-Ray 콘솔 사용서비스 맵과 세그먼트를 보려면 읽기 권한만 필요합니다. 콘솔 액세스를 활성화하려면 AWSXrayReadOnlyAccess 관리형 정책을 IAM 사용자에 추가합니다.

에 대해로컬 개발 및 테스트, 읽기 및 쓰기 권한이 있는 IAM 역할을 생성합니다. 역할을 맡으세요.그리고 역할에 대한 임시 자격 증명을 저장하세요. 이러한 자격 증명을 X-Ray 데몬과 함께 사용할 수 있습니다.AWS CLI, 그리고AWSSDK. 를 참조하십시오.다음과 같은 임시 보안 자격 증명 사용AWS CLI자세한 내용은

구성된 앱을 AWS에 배포하려면 쓰기 권한을 갖는 IAM 역할을 생성하여 애플리케이션을 실행하는 리소스에 할당합니다. AWSXRayDaemonWriteAccess에는 트레이스를 업로드할 권한과 샘플링 규칙 사용을 지원하기 위한 일부 읽기 권한도 포함됩니다.

읽기 및 쓰기 정책에는 암호화 키 설정 및 샘플링 규칙을 구성할 권한은 포함되지 않습니다. AWSXrayFullAccess을 사용하여 이러할 설정에 액세스하거나, 사용자 지정 정책에서 구성 API를 추가합니다. 생성하는 고객 관리형 키를 사용한 암호화 및 해독을 위해서는 해당 키를 사용할 권한도 필요합니다.

X-Ray ID 기반 정책

IAM 자격 증명 기반 정책을 사용하면 허용되거나 거부되는 태스크와 리소스뿐 아니라 작업이 허용되거나 거부되는 조건을 지정할 수 있습니다. X-Ray는 특정 작업, 리소스 및 조건 키를 지원합니다. JSON 정책에서 사용하는 모든 요소에 대해 알고 싶다면 IAM 사용 설명서IAM JSON 정책 요소 참조를 참조하세요.

작업

관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지를 지정할 수 있습니다. 즉, 어떤 보안 주체가 어떤 리소스와 어떤 조건에서 작업을 수행할 수 있는지를 지정할 수 있습니다.

JSON 정책의 Action 요소는 정책에서 액세스를 허용하거나 거부하는 데 사용할 수 있는 태스크를 설명합니다. 일반적으로 정책 작업의 이름은 연결된 AWS API 작업의 이름과 동일합니다. 일치하는 API 작업이 없는 권한 전용 작업 같은 몇 가지 예외도 있습니다. 정책에서 여러 작업이 필요한 몇 가지 작업도 있습니다. 이러한 추가 작업을 종속 작업이라고 합니다.

연결된 작업을 수행할 수 있는 권한을 부여하기 위한 정책에 작업을 포함시킵니다.

X-Ray의 정책 조치는 조치 앞에 다음 접두사를 사용합니다.xray:. 예를 들어, X-Ray를 사용하여 그룹 리소스 세부 정보를 검색할 수 있는 권한을 다른 사람에게 부여하는 경우GetGroupAPI 작업에는 다음이 포함됩니다.xray:GetGroup해당 정책에 조치를 적용하세요. 정책 문에는 Action 또는 NotAction 요소가 반드시 추가되어야 합니다. X-Ray는 이 서비스로 수행할 수 있는 작업을 설명하는 자체 작업 세트를 정의합니다.

명령문 하나에 여러 태스크를 지정하려면 다음과 같이 쉼표로 구분합니다.

"Action": [ "xray:action1", "xray:action2"

와일드카드(*)를 사용하여 여러 태스크를 지정할 수 있습니다. 예를 들어, Get라는 단어로 시작하는 모든 태스크를 지정하려면 다음 태스크를 포함합니다.

"Action": "xray:Get*"

X-Ray 작업 목록을 보려면 을 참조하십시오.에 의해 정의된 동작AWS X-Ray에서IAM 사용자 가이드.

리소스

관리자는 AWS JSON 정책을 사용하여 누가 무엇에 액세스할 수 있는지를 지정할 수 있습니다. 즉, 어떤 보안 주체가 어떤 리소스와 어떤 조건에서 작업을 수행할 수 있는지를 지정할 수 있습니다.

Resource JSON 정책 요소는 작업이 적용되는 하나 이상의 객체를 지정합니다. 문에는 Resource 또는 NotResource 요소가 반드시 추가되어야 합니다. 모범 사례에 따라 Amazon 리소스 이름(ARN)을 사용하여 리소스를 지정합니다. 리소스 수준 권한이라고 하는 특정 리소스 유형을 지원하는 작업에 대해 이 태스크를 수행할 수 있습니다.

작업 나열과 같이 리소스 수준 권한을 지원하지 않는 작업의 경우 와일드카드(*)를 사용하여 명령문이 모든 리소스에 적용됨을 나타냅니다.

"Resource": "*"

IAM 정책을 사용하여 리소스에 대한 액세스를 제어할 수 있습니다. 리소스 수준의 권한을 지원하는 작업은 Amazon 리소스 이름(ARN)을 사용하여 정책이 적용되는 리소스를 확인할 수 있습니다.

모든 X-Ray 작업을 IAM 정책에서 사용하여 사용자에게 해당 작업을 사용할 권한을 부여하거나 거부할 수 있습니다. 하지만 전부는 아닙니다.엑스레이 액션리소스 수준 권한을 지원하므로 작업을 수행할 수 있는 리소스를 지정할 수 있습니다.

리소스 수준 권한을 지원하지 않는 작업의 경우 "*"를 리소스로 사용해야 합니다.

다음 X-Ray 작업은 리소스 수준 권한을 지원합니다.

  • CreateGroup

  • GetGroup

  • UpdateGroup

  • DeleteGroup

  • CreateSamplingRule

  • UpdateSamplingRule

  • DeleteSamplingRule

다음은 CreateGroup 작업에 대한 자격 증명 기반 권한 정책 예제입니다. 이 예제에서는 와일드카드로 고유 ID를 가지는 그룹 이름 local-users와 관련된 ARN의 사용을 보여줍니다. 고유 ID는 그룹을 만들 때 생성되기 때문에 정책에서 미리 예측할 수 없습니다. GetGroup, UpdateGroup 또는 DeleteGroup을 사용할 때, 이는 ID를 포함하여 와일드카드 또는 정확한 ARN으로 정의될 수 있습니다.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "xray:CreateGroup" ], "Resource": [ "arn:aws:xray:eu-west-1:123456789012:group/local-users/*" ] } ] }

다음은 CreateSamplingRule 작업에 대한 자격 증명 기반 권한 정책 예제입니다.

{ "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가 없습니다.

X-Ray 리소스 유형 및 해당 ARN 목록을 보려면 을 참조하십시오.리소스 정의 기준AWS X-Ray... 에서IAM 사용자 가이드. 각 리소스의 ARN을 지정할 수 있는 작업을 알아보려면 AWS X-Ray가 정의한 작업을 참조하세요.

조건 키

X-Ray는 서비스별 조건 키를 제공하지 않지만 일부 글로벌 조건 키 사용은 지원합니다. 모든 AWS 전역 조건 키를 보려면 IAM 사용 설명서AWS 전역 조건 컨텍스트 키를 참조하세요.

예시

X-Ray ID 기반 정책의 예를 보려면 다음을 참조하십시오.AWS X-Ray 자격 증명 기반 정책 예제.

X-Ray 리소스 기반 정책

X-Ray는 현재와 미래의 리소스 기반 정책을 지원합니다.AWS 서비스통합 (예:아마존 SNS 액티브 트레이싱. X-Ray 리소스 기반 정책은 다른 사람이 업데이트할 수 있습니다.AWS Management Consoles 또는 다음을 통해AWSSDK 또는 CLI를 사용하십시오. 예를 들어, Amazon SNS 콘솔은 X-Ray로 트레이스를 전송하기 위한 리소스 기반 정책을 자동으로 구성하려고 시도합니다. 다음 정책 문서는 X-Ray 리소스 기반 정책을 수동으로 구성하는 예를 제공합니다.

예 Amazon SNS 액티브 트레이싱을 위한 X-Ray 리소스 기반 정책 예시

이 예제 정책 문서는 Amazon SNS가 추적 데이터를 X-Ray로 전송하는 데 필요한 권한을 지정합니다.

{ 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를 사용하여 Amazon SNS에 추적 데이터를 X-Ray로 전송할 수 있는 권한을 부여하는 리소스 기반 정책을 생성합니다.

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,region,account-id, 그리고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 조건 키를 사용하여 정책의 조건 요소에 태그 정보를 제공합니다. X-Ray 리소스 태깅에 대한 자세한 내용은 을 참조하십시오.X-Ray 샘플링 규칙 및 그룹에 태그 지정.

리소스의 태그를 기반으로 리소스에 대한 액세스를 제한하는 자격 증명 기반 정책의 예제는 X-Ray 그룹에 대한 액세스 관리 및 태그 기반 샘플링 규칙에서 확인할 수 있습니다.

로컬에서 애플리케이션 실행

계측된 애플리케이션은 X-Ray 데몬으로 추적 데이터를 전송합니다. 데몬은 문서를 버퍼링하여 일괄적으로 X-Ray 서비스에 업로드합니다. 데몬은 추적 데이터와 원격 분석을 X-Ray 서비스에 업로드하려면 쓰기 권한이 필요합니다.

다음과 같은 경우데몬을 로컬에서 실행할 수 있습니다., IAM 역할 생성,역할 맡기환경 변수나 이름이 지정된 파일에 임시 자격 증명을 저장합니다.credentials라는 폴더 내에.aws사용자 폴더에서 을 참조하십시오.다음과 같은 임시 보안 자격 증명 사용AWS CLI자세한 내용은

예 ~/.aws/credentials
[default] aws_access_key_id={access key ID} aws_secret_access_key={access key} aws_session_token={AWS session token}

함께 사용할 자격 증명을 이미 구성한 경우AWSSDK 또는AWS CLI, 데몬은 이를 사용할 수 있습니다. 여러 프로파일을 사용할 수 있을 경우 데몬은 기본 프로파일을 사용합니다.

에서 애플리케이션 실행AWS

에서 애플리케이션을 실행할 때AWS역할을 사용하여 데몬을 실행하는 Amazon EC2 인스턴스 또는 Lambda 함수에 권한을 부여하십시오.

  • 아마존 엘라스틱 컴퓨트 클라우드 (아마존 EC2)— IAM 역할을 생성하여 EC2 인스턴스에 다음과 같이 연결합니다.인스턴스 프로필.

  • 아마존 엘라스틱 컨테이너 서비스 (아마존 ECS)— IAM 역할을 생성하여 컨테이너 인스턴스에 다음과 같이 연결컨테이너 인스턴스 IAM 역할.

  • AWS Elastic Beanstalk(엘라스틱 빈스토크)— Elastic Beanstalk에는 X-Ray 권한이 포함되어 있습니다.기본 인스턴스 프로필. 기본 인스턴스 프로파일을 사용하거나 쓰기 권한을 사용자 지정 인스턴스 프로파일에 추가할 수 있습니다.

  • AWS Lambda(람다)— 함수의 실행 역할에 쓰기 권한을 추가합니다.

X-Ray에서 사용할 역할을 만들려면
  1. IAM 콘솔(IAM console)을 엽니다.

  2. [Roles]를 선택합니다.

  3. 새 역할 생성을 선택합니다.

  4. Role Name(역할 이름)xray-application을 입력합니다. 다음 단계(Next Step)를 선택합니다.

  5. [Role Type]에서 [Amazon EC2]를 선택합니다.

  6. 다음 관리형 정책을 첨부하여 애플리케이션에 액세스 권한을 부여하십시오.AWS 서비스:

    • AWSXRayDaemonWriteAccess— X-Ray 데몬에 추적 데이터를 업로드할 수 있는 권한을 부여합니다.

    애플리케이션이 AWS SDK를 사용하여 다른 서비스에 액세스하는 경우 해당 서비스에 대한 액세스를 부여하는 정책을 추가합니다.

  7. 다음 단계(Next Step)를 선택합니다.

  8. 역할 생성을 선택합니다.

암호화에 대한 사용자 권한

X-Ray는 기본적으로 모든 추적 데이터를 암호화하며 사용자는 다음을 수행할 수 있습니다.관리하는 키를 사용하도록 구성합니다.. 만약 하나를 선택한다면AWS Key Management Service고객 관리 키를 암호화하는 데 사용할 수 있는 권한을 X-Ray에 부여할 수 있도록 키의 액세스 정책을 적용해야 합니다. 계정 내 다른 사용자들도 X-Ray 콘솔에서 암호화된 추적 데이터를 보려면 해당 키에 액세스해야 합니다.

고객 관리 키의 경우 다음 작업을 허용하는 액세스 정책으로 키를 구성하십시오.

  • X-Ray에서 키를 구성하는 사용자는 전화를 걸 권한이 있습니다.kms:CreateGrantkms:DescribeKey.

  • 암호화된 추적 데이터에 액세스할 수 있는 사용자는 kms:Decrypt를 호출할 수 있는 권한을 가집니다.

사용자를 추가할 때주요 사용자IAM 콘솔의 키 구성 섹션에 있는 그룹은 이 두 작업 모두에 대한 권한을 가집니다. 키 정책에 대한 권한만 설정하면 되므로 권한이 필요하지 않습니다.AWS KMS사용자, 그룹 또는 역할에 대한 권한 자세한 내용은 AWS KMS 개발자 안내서의 키 정책 사용을 참조하십시오.

기본 암호화의 경우 또는 원하는 경우AWS관리형 CMK (aws/xray), 권한은 X-Ray API에 액세스할 수 있는 사용자를 기반으로 합니다. AWSXrayFullAccess에 포함된 PutEncryptionConfig에 액세스할 수 있는 사람은 누구나 암호화 구성을 변경할 수 있습니다. 사용자가 암호화 키를 변경하지 못하게 하려면 PutEncryptionConfig를 사용할 권한을 부여하지 마십시오.