本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

AWS X-Ray 基于身份的策略示例

默认情况下，用户和角色没有创建或修改 X-Ray 资源的权限。他们也无法使用 AWS Management Console AWS CLI、或执行任务 AWS API。管理员必须创建IAM策略，授予用户和角色对其所需的指定资源执行特定API操作的权限。然后，管理员必须将这些策略附加到需要这些权限的用户或组。

要了解如何使用这些示例策略文档创建IAM基于身份的JSON策略，请参阅IAM用户指南中的在JSON选项卡上创建策略。

策略最佳实践

基于身份的策略确定某个人是否可以创建、访问或删除您账户中的 X-Ray 资源。这些操作可能会使 AWS 账户产生成本。创建或编辑基于身份的策略时，请遵循以下指南和建议：

有关中最佳做法的更多信息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 组和采样规则的访问权限

您可以在基于身份的策略中使用条件，以便基于标签控制对 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用户指南》中的 “IAMJSON策略元素：条件”。

角色中附加有以下策略的用户无法将标签 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"
                }
            }
        }
    ]
}

IAMX-Ray 的托管策略

为便于授予权限，IAM支持每项服务的托管策略。服务可以在发布新权限时使用新权限更新这些托管策略APIs。 AWS X-Ray 为只读、只写和管理员用例提供托管策略。

AWS 托管策略的 X-Ray 更新

查看自该服务开始跟踪这些更改以来，X-Ray AWS 托管策略更新的详细信息。要获得有关此页面变更的自动提醒，请在 X-Ray 文档历史记录页面上订阅 RSS Feed。

在IAM策略中指定资源

您可以使用IAM策略控制对资源的访问权限。对于支持资源级权限的操作，您可以使用 Amazon 资源名称 (ARN) 来标识该策略适用的资源。

IAM策略中可以使用所有 X-Ray 操作来授予或拒绝用户使用该操作的权限。但是，并非所有 X-Ray 操作都支持资源级权限（这使您能够指定可对其执行操作的资源）。

对于不支持资源级权限的操作，您必须将“*”作为资源。

以下 X-Ray 操作支持资源级权限：

下面是 CreateGroup 操作基于身份的权限策略的示例：该示例显示了如何使用local-users具有唯一 ID 的ARN关联组名称作为通配符。该唯一 ID 在组创建时生成，因此策略中无法前提预测。使用GetGroupUpdateGroup、或时DeleteGroup，您可以将其定义为通配符或精确ARN值（包括 ID）。

{
    "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"
            ]
        }
    ]
}