AWS X-Ray 자격 증명 기반 정책 예시

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

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

정책 모범 사례

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

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

X-Ray 콘솔 사용하기

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

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

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

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

이 예제는 IAM 사용자가 자신의 사용자 ID에 연결된 인라인 및 관리형 정책을 볼 수 있도록 허용하는 정책을 생성하는 방법을 보여줍니다. 이 정책에는 콘솔에서 또는 AWS CLI나 AWSAPI를 사용하여 프로그래밍 방식으로 이 태스크를 완료할 수 있는 권한이 포함됩니다.

{
    "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는 읽기 전용, 쓰기 전용 및 관리자를 위한 관리형 정책을 제공합니다.

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

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

IAM 정책 내에서 리소스 지정

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

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

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

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

다음은 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"
            ]
        }
    ]
}