정책 모범 사례 콘솔 사용 사용자가 자신이 권한을 볼 수 있도록 허용 태그에 기반한 X-Ray 그룹 및 샘플링 규칙에 대한 액세스 관리 X-Ray에 대한 IAM 관리 정책 AWS 관리형 정책으로 X-Ray 업데이트 IAM 정책 내에서 리소스 지정

AWS X-Ray ID 기반 정책 예제

기본적으로 사용자 및 역할에는 X-Ray 리소스를 생성하거나 수정할 수 있는 권한이 없습니다. 또한 AWS Management Console AWS CLI, 또는 AWS API를 사용하여 작업을 수행할 수 없습니다. 관리자는 지정된 리소스에서 특정 API 태스크를 수행할 수 있는 권한을 사용자와 역할에게 부여하는 IAM 정책을 생성해야 합니다. 그런 다음 관리자는 해당 권한이 필요한 사용자 또는 그룹에 이러한 정책을 연결해야 합니다.

이러한 예제 JSON 정책 문서를 사용하여 IAM 자격 증명 기반 정책을 생성하는 방법을 알아보려면 IAM 사용 설명서의 JSON 탭에서 정책 생성을 참조하십시오.

정책 모범 사례

ID 기반 정책에 따라 계정에서 사용자가 X-Ray 리소스를 생성, 액세스 또는 삭제할 수 있는지 여부가 결정됩니다. 이 작업으로 인해 AWS 계정에 비용이 발생할 수 있습니다. 자격 증명 기반 정책을 생성하거나 편집할 때는 다음 지침과 권장 사항을 따르십시오.

AWS 관리형 정책으로 시작하여 최소 권한 권한으로 이동 — 사용자와 워크로드에 권한을 부여하려면 여러 일반 사용 사례에 권한을 부여하는 AWS 관리형 정책을 사용하세요. 해당 내용은 에서 사용할 수 있습니다. AWS 계정사용 사례에 맞는 AWS 고객 관리형 정책을 정의하여 권한을 더 줄이는 것이 좋습니다. 자세한 정보는 IAM 사용 설명서의 AWS 관리형 정책 또는 AWS 직무에 대한 관리형 정책을 참조하세요.
최소 권한 적용 – IAM 정책을 사용하여 권한을 설정하는 경우 태스크를 수행하는 데 필요한 권한만 부여합니다. 이렇게 하려면 최소 권한으로 알려진 특정 조건에서 특정 리소스에 대해 수행할 수 있는 작업을 정의합니다. IAM을 사용하여 권한을 적용하는 방법에 대한 자세한 정보는 IAM 사용 설명서에 있는 IAM의 정책 및 권한을 참조하세요.
IAM 정책의 조건을 사용하여 액세스 추가 제한 – 정책에 조건을 추가하여 작업 및 리소스에 대한 액세스를 제한할 수 있습니다. 예를 들어 SSL을 사용하여 모든 요청을 전송해야 한다고 지정하는 정책 조건을 작성할 수 있습니다. 예를 AWS 서비스들어 특정 작업을 통해 서비스 작업을 사용하는 경우 조건을 사용하여 서비스 작업에 대한 액세스 권한을 부여할 수도 AWS CloudFormation있습니다. 자세한 정보는 IAM 사용 설명서의 IAM JSON 정책 요소: 조건을 참조하세요.
IAM Access Analyzer를 통해 IAM 정책을 검증하여 안전하고 기능적인 권한 보장 – IAM Access Analyzer에서는 IAM 정책 언어(JSON)와 모범 사례가 정책에서 준수되도록 신규 및 기존 정책을 검증합니다. IAM Access Analyzer는 100개 이상의 정책 확인 항목과 실행 가능한 추천을 제공하여 안전하고 기능적인 정책을 작성하도록 돕습니다. 자세한 정보는 IAM 사용 설명서의 IAM Access Analyzer 정책 검증을 참조하세요.
멀티 팩터 인증 (MFA) 필요 - IAM 사용자 또는 루트 사용자가 필요한 시나리오가 있는 경우 추가 보안을 위해 AWS 계정 MFA를 활성화하십시오. API 작업을 직접 호출할 때 MFA가 필요하면 정책에 MFA 조건을 추가합니다. 자세한 정보는 IAM 사용 설명서의 MFA 보호 API 액세스 구성을 참조하세요.

IAM의 모범 사례에 대한 자세한 내용은 IAM 사용 설명서의 IAM의 보안 모범 사례를 참조하세요.

X-Ray 콘솔 사용하기

AWS X-Ray 콘솔에 액세스하려면 최소한의 권한이 있어야 합니다. 이러한 권한을 통해 사용자의 X-Ray 리소스에 대한 세부 정보를 나열하고 볼 수 있어야 AWS 계정합니다. 최소 필수 권한보다 더 제한적인 자격 증명 기반 정책을 만들면 콘솔이 해당 정책에 연결된 엔터티(사용자 또는 역할)에 대해 의도대로 작동하지 않습니다.

이러한 개체가 여전히 X-Ray 콘솔을 사용할 수 있도록 하려면 AWSXRayReadOnlyAccess AWS 관리형 정책을 개체에 연결하십시오. 이 정책은 X-Ray의 IAM 관리형 정책에 자세히 설명되어 있습니다. 자세한 내용은 IAM 사용 설명서의 사용자에게 권한 추가를 참조하십시오.

AWS CLI 또는 AWS API만 호출하는 사용자에게 최소 콘솔 권한을 허용할 필요는 없습니다. 그 대신, 수행하려는 API 작업과 일치하는 작업에만 액세스할 수 있도록 합니다.

사용자가 자신이 권한을 볼 수 있도록 허용

이 예시는 IAM 사용자가 자신의 사용자 자격 증명에 연결된 인라인 및 관리형 정책을 볼 수 있도록 허용하는 정책을 생성하는 방법을 보여줍니다. 이 정책에는 콘솔에서 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 샘플링 규칙 및 그룹 태그 지정하기을 참조하십시오.

태그를 stage:prod 또는 stage:preprod를 사용하여 그룹을 생성, 업데이트 또는 삭제할 수 있는 사용자 액세스를 거부하려면 다음과 유사한 정책을 사용하여 사용자에게 역할을 할당하십시오.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowAllXRay",
            "Effect": "Allow",
            "Action": "xray:*",
            "Resource": "*"
        },
        {
            "Sid": "DenyCreateGroupWithStage",
            "Effect": "Deny",
            "Action": [
                "xray:CreateGroup"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:RequestTag/stage": [
                        "preprod",
                        "prod"
                    ]
                }
            }
        },
        {
            "Sid": "DenyUpdateGroupWithStage",
            "Effect": "Deny",
            "Action": [
                "xray:UpdateGroup",
                "xray:DeleteGroup"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/stage": [
                        "preprod",
                        "prod"
                    ]
                }
            }
        }
    ]
}

샘플링 규칙 생성을 거부하려면 aws:RequestTag을 사용하여 생성 요청의 일부로 전달할 수 없는 태그를 표시하세요. 샘플링 규칙의 업데이트 또는 삭제를 거부하려면 aws:ResourceTag를 사용하여 해당 리소스의 태그에 기반한 작업을 거부하십시오.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowAllXRay",
            "Effect": "Allow",
            "Action": "xray:*",
            "Resource": "*"
        },
        {
            "Sid": "DenyCreateSamplingRuleWithStage",
            "Effect": "Deny",
            "Action": "xray:CreateSamplingRule",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:RequestTag/stage": [
                        "preprod",
                        "prod"
                    ]
                }
            }
        },
        {
            "Sid": "DenyUpdateSamplingRuleWithStage",
            "Effect": "Deny",
            "Action": [
                "xray:UpdateSamplingRule",
                "xray:DeleteSamplingRule"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/stage": [
                        "preprod",
                        "prod"
                    ]
                }
            }
        }
    ]
}

계정 내 사용자에게 이러한 정책을 첨부(또는 단일 정책으로 결합한 다음 정책을 첨부)할 수 있습니다. 사용자가 그룹 또는 샘플링 규칙을 변경하려면 그룹 또는 샘플링 규칙에 stage=prepod 또는 stage=prod 태그를 지정해서는 안 됩니다. 조건 키 이름은 대소문자를 구분하지 않기 때문에 조건 태그 키 Stage는 Stage 및 stage 모두와 일치합니다. 조건 블록에 대한 자세한 내용은 IAM 사용 설명서의 IAM JSON 정책 요소: 조건을 참조하세요.

다음 정책이 연결된 역할을 가진 사용자는 리소스에 role:admin 태그를 추가할 수 없으며 role:admin가 연결된 리소스에서 태그를 제거할 수 없습니다.


{
    "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은 각 서비스에 대해 관리형 정책을 지원합니다. 서비스는 새 API를 출시할 때 새 권한으로 이러한 관리형 정책을 업데이트할 수 있습니다. AWS X-Ray 읽기 전용, 쓰기 전용, 관리자 사용 사례에 대한 관리형 정책을 제공합니다.

AWSXrayReadOnlyAccess— X-Ray 콘솔 또는 AWS SDK를 사용하여 X-Ray API에서 추적 데이터, 추적 맵, 통찰력 및 X-Ray 구성을 가져오기 위한 읽기 권한. AWS CLIOAM (Observability Access Manager) oam:ListSinks 및 계정 간 옵저버빌리티의 일환으로 소스 계정에서 공유된 트레이스를 콘솔에서 볼 수 있도록 하는 oam:ListAttachedSinks 권한이 포함됩니다. CloudWatch BatchGetTraceSummaryById및 GetDistinctTraceGraphs API 작업은 코드를 통해 호출되지 않으며, 및 SDK에 포함되지 않습니다. AWS CLI AWS


{
    "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 SDK를 사용하여 세그먼트 문서 및 원격 분석을 X-Ray API에 업로드하기 위한 쓰기 권한. AWS CLI샘플링 규칙을 가져오고 샘플링 결과를 보고할 읽기 권한이 포함됩니다. 자세한 정보는 샘플링 규칙을 구성합니다.을 참조하세요.


{
    "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 계정 간의 계정 간 가시성을 지원하는 데 사용됩니다.


{
    "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를 사용할 권한입니다. OAM (Observability Access Manager) oam:ListSinks 과 크로스 계정 옵저버빌리티의 일환으로 소스 계정에서 공유된 트레이스를 콘솔에서 볼 수 있는 oam:ListAttachedSinks 권한을 포함합니다. CloudWatch


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "xray:*",
                "oam:ListSinks"
            ],
            "Resource": [
                "*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "oam:ListAttachedLinks"
            ],
            "Resource": "arn:aws:oam:*:*:sink/*"
        }
    ]
}

관리형 정책을 IAM 사용자 그룹 또는 역할에 추가하는 방법

IAM 콘솔(IAM console)을 엽니다.
인스턴스 프로파일, IAM 사용자 또는 IAM 사용자 그룹과 연결된 역할을 엽니다.
권한에서 관리형 정책을 연결합니다.

AWS 관리형 정책으로 X-Ray 업데이트

이 서비스가 이러한 변경 사항을 추적하기 시작한 이후 X-Ray의 AWS 관리형 정책 업데이트에 대한 세부 정보를 확인하십시오. 이 페이지의 변경 사항에 대한 자동 알림을 받으려면 X-Ray 문서 기록 페이지에서 RSS 피드를 구독하세요.

변경 사항 설명 날짜

변경 사항	설명	날짜
X-Ray용 IAM 관리형 정책 — 새로운 `AWSXrayCrossAccountSharingConfiguration` 및 업데이트된 `AWSXrayReadOnlyAccess` 및 `AWSXrayFullAccess` 정책이 추가되었습니다.	X-Ray는 이러한 정책에 Observability Access Manager (OAM) 권한을 `oam:ListSinks` 추가하여 콘솔에서 계정 CloudWatch 간 관찰 가능성의 일환으로 소스 계정에서 공유된 트레이스를 볼 수 있도록 했습니다. `oam:ListAttachedSinks`	2022년 11월 27일
X-Ray용 IAM 관리형 정책 — `AWSXrayReadOnlyAccess` 정책 업데이트	X-Ray가 `ListResourcePolicies` API 작업을 추가했습니다.	2022년 11월 15일
X-Ray 콘솔 사용 — `AWSXrayReadOnlyAccess` 정책 업데이트	X-Ray는 두 개의 새로운 API 작업 `BatchGetTraceSummaryById`과 `GetDistinctTraceGraphs`를 추가했으며, 이 작업들은 코드로 호출되는 것이 아닙니다. 따라서 이러한 API 작업은 및 SDK에 포함되지 않습니다. AWS CLI AWS	2022년 11월 11일

X-Ray용 IAM 관리형 정책 — 새로운 AWSXrayCrossAccountSharingConfiguration 및 업데이트된 AWSXrayReadOnlyAccess 및 AWSXrayFullAccess 정책이 추가되었습니다.

X-Ray는 이러한 정책에 Observability Access Manager (OAM) 권한을 oam:ListSinks 추가하여 콘솔에서 계정 CloudWatch 간 관찰 가능성의 일환으로 소스 계정에서 공유된 트레이스를 볼 수 있도록 했습니다. oam:ListAttachedSinks

2022년 11월 27일

X-Ray용 IAM 관리형 정책 — AWSXrayReadOnlyAccess 정책 업데이트

X-Ray가 ListResourcePolicies API 작업을 추가했습니다.

2022년 11월 15일

X-Ray 콘솔 사용 — AWSXrayReadOnlyAccess 정책 업데이트

X-Ray는 두 개의 새로운 API 작업 BatchGetTraceSummaryById과 GetDistinctTraceGraphs를 추가했으며,

이 작업들은 코드로 호출되는 것이 아닙니다. 따라서 이러한 API 작업은 및 SDK에 포함되지 않습니다. AWS CLI AWS

2022년 11월 11일

IAM 정책 내에서 리소스 지정

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

IAM 정책에서 모든 X-Ray 작업을 사용하여 해당 작업을 사용하기 위한 사용자 권한을 부여하거나 거부할 수 있습니다. 하지만 모든 X-Ray 작업이 리소스 수준 권한을 지원하는 것은 아닙니다. 여기에서 리소스 수준 권한이란 작업이 가능한 리소스를 지정할 수 있는 권한을 말합니다.

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

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

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

AWS X-Ray IAM과의 작동 방식

문제 해결