本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 安全性 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 以实现您的安全性和合规性目标。您还将学习如何使用其他 AWS 服务 方法来帮助您监控和保护您的 X-Ray 资源。
**主题**
+ [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 始终对跟踪和相关静态数据进行加密。如果出于合规性要求或内部要求需要审核并禁用加密密钥，您可以配置 X-Ray 使用 AWS Key Management Service (AWS KMS) 密钥加密数据。
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 控制台将 X-Ray 配置为使用 KMS 密钥进行加密**
1. 登录 AWS 管理控制台并打开 CloudWatch 控制台（[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)）。
1. 在左侧导航窗格中，选择**设置**。
1. 在 **X-Ray 跟踪**部分中的**加密**下，选择**查看设置**。
1. 在**加密配置**部分，选择**编辑**。
1. 选择**使用 KMS 密钥**。
1. 从下拉菜单中选择一个密钥：
+ **aws/xray** – 使用 AWS 托管式密钥。
+ *密钥别名* - 在您的账户中使用客户托管 CMK。
+ **手动输入密钥** 使用另一账户中的客户托管密钥。在出现的字段中输入密钥的完整 Amazon 资源名称 (ARN)。
1. 选择**更新加密**。
------
#### [ X-Ray console ]
**使用 X-Ray 控制台将 X-Ray 配置为使用 KMS 密钥进行加密**
1. 打开 [X-Ray 控制台](https://console.aws.amazon.com/xray/home#)。
1. 选择**加密**。
1. 选择**使用 KMS 密钥**。
1. 从下拉菜单中选择一个密钥：
+ **aws/xray** – 使用 AWS 托管式密钥。
+ *密钥别名* - 在您的账户中使用客户托管 CMK。
+ **手动输入密钥** 使用另一账户中的客户托管密钥。在出现的字段中输入密钥的完整 Amazon 资源名称 (ARN)。
1. 选择**应用**。
------
**注意**
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)
+ [使用身份进行身份验证](#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)）
## 使用身份进行身份验证
身份验证是您 AWS 使用身份凭证登录的方式。您必须以 IAM 用户身份进行身份验证 AWS 账户根用户，或者通过担任 IAM 角色进行身份验证。
您可以使用来自身份源的证书 AWS IAM Identity Center （例如（IAM Identity Center）、单点登录身份验证或 Google/Facebook 证书，以联合身份登录。有关登录的更多信息，请参阅《AWS 登录 用户指南》**中的[如何登录您的 AWS 账户](https://docs.aws.amazon.com/signin/latest/userguide/how-to-sign-in.html)。
对于编程访问， AWS 提供 SDK 和 CLI 来对请求进行加密签名。有关更多信息，请参阅*《IAM 用户指南》*中的[适用于 API 请求的AWS 签名版本 4](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_sigv.html)。
### AWS 账户 root 用户
创建时 AWS 账户，首先会有一个名为 AWS 账户 *root 用户的*登录身份，该身份可以完全访问所有资源 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)*是对某个人员或应用程序具有特定权限的一个身份。建议使用临时凭证，而非具有长期凭证的 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 角色（控制台）](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-console.html)或调用 AWS CLI 或 AWS API 操作来代入角色。有关更多信息，请参阅《IAM 用户指南》**中的[担任角色的方法](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage-assume.html)。
IAM 角色对于联合用户访问、临时 IAM 用户权限、跨账户访问、跨服务访问以及在 Amazon EC2 上运行的应用程序非常有用。有关更多信息，请参阅《IAM 用户指南》**中的 [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 策略定义权限，与执行操作所用的方法无关。
### 基于身份的策略
基于身份的策略是您附加到身份（用户、组或角色）的 JSON 权限策略文档。这些策略控制身份可以执行什么操作、对哪些资源执行以及在什么条件下执行。要了解如何创建基于身份的策略，请参阅《IAM 用户指南》**中的[使用客户管理型策略定义自定义 IAM 权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)。
基于身份的策略可以是*内联策略*（直接嵌入到单个身份中）或*托管策略*（附加到多个身份的独立策略）。要了解如何在托管策略和内联策略之间进行选择，请参阅*《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 托管策略。
### 访问控制列表 (ACLs)
访问控制列表 (ACLs) 控制哪些委托人（账户成员、用户或角色）有权访问资源。 ACLs 与基于资源的策略类似，尽管它们不使用 JSON 策略文档格式。
Amazon S3 和 Amazon VPC 就是支持的服务示例 ACLs。 AWS WAF要了解更多信息 ACLs，请参阅《*亚马逊简单存储服务开发者指南*》中的[访问控制列表 (ACL) 概述](https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html)。
### 其他策略类型
AWS 支持其他策略类型，这些策略类型可以设置更常见的策略类型授予的最大权限：
+ **权限边界** – 设置基于身份的策略可以授予 IAM 实体的最大权限。有关更多信息，请参阅《 IAM 用户指南》**中的 [IAM 实体的权限边界](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html)。
+ **服务控制策略 (SCPs)**-在中指定组织或组织单位的最大权限 AWS Organizations。有关更多信息，请参阅《AWS Organizations 用户指南》**中的[服务控制策略](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html)。
+ **资源控制策略 (RCPs)**-设置账户中资源的最大可用权限。有关更多信息，请参阅《*AWS Organizations 用户指南》*中的[资源控制策略 (RCPs)](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 和其他人如何 AWS 服务 使用 IAM [AWS 服务 ，请参阅 IAM 用户指南中的与 I](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) *AM* 配合使用。
您可以使用 AWS Identity and Access Management (IAM) 向账户中的用户和计算资源授予 X-Ray 权限。无论您的用户使用哪个客户端（控制台、 AWS SDK AWS CLI），IAM 都会在 API 级别控制对 X-Ray 服务的访问权限，以统一强制执行权限。
要[使用 X-Ray 控制台](aws-xray-interface-console.md#xray-console)查看跟踪地图和分段，只需具有读取权限即可。要启用控制台访问，请向您的 IAM 用户添加 `AWSXrayReadOnlyAccess` [ 托管策略](security_iam_id-based-policy-examples.md#xray-permissions-managedpolicies)。
要进行[本地开发和测试](#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`访问这些设置，或在自定义策略 APIs中添加[配置](xray-api-configuration.md)。要使用您创建的客户托管密钥进行加密和解密，您还需要[使用该密钥的权限](#xray-permissions-encryption)。
**Topics**
+ [X-Ray 基于身份的策略](#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 基于身份的策略
通过使用 IAM 基于身份的策略，您可以指定允许或拒绝的操作和资源以及允许或拒绝操作的条件。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` 时，可将此定义为通配符或确切的 ARN（包括 ID）。
**注意**
采样规则的 ARN 由其名称定义。与组不同 ARNs，采样规则没有唯一生成的 ID。
要查看 X-Ray 资源类型及其列表 ARNs，请参阅 *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 支持基于资源的策略，用于当前和未来的 AWS 服务 集成，例如 [Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-active-tracing.html) 主动跟踪。基于 X-Ray 资源的策略可以由其他 AWS 管理控制台人更新，也可以通过 AWS SDK 或 CLI 进行更新。例如，Amazon SNS 控制台会尝试自动配置基于资源的策略，将跟踪发送给 X-Ray。以下策略文档提供手动配置 X-Ray 基于资源的策略的示例。
**Example 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` 条件键在策略的[条件元素](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 进程守护程序。进程守护程序缓存分段文档，并分批将它们上传到 X-Ray 服务。进程守护程序需要写入权限以将跟踪数据和遥测数据上传到 X-Ray 服务。
当[在本地运行进程守护程序](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，则守护程序可以使用这些凭据。如果有多个配置文件可用，则该进程守护程序使用默认配置文件。
## 在中运行您的应用程序 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 在其默认实例配置文件中包含 X-Ray 权限。](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/concepts-roles.html#concepts-roles-instance)您可以使用该默认实例配置文件，或在自定义实例配置文件中添加写入权限。
+ **AWS Lambda (Lambda)**-向函数的执行角色添加写入权限。
**如何创建角色来使用 X-Ray**
1. 打开 [IAM 控制台](https://console.aws.amazon.com/iam/home)。
1. 选择**角色**。
1. 选择**创建新角色**。
1. 对于**角色名称**，键入 **xray-application**。选择**下一步**。
1. 对于 **Role Type**，选择 **Amazon EC2**。
1. 附加以下托管策略以向您应用程序授予对 AWS 服务的访问权限。
+ **AWSXRayDaemonWriteAccess**— 授予 X-Ray 守护程序上传跟踪数据的权限。
如果您的应用程序使用 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-R APIs ay。包含在 `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 管理控制台 AWS CLI、或 AWS API 执行任务。管理员必须创建 IAM policy，以便为用户和角色授予权限以对所需的指定资源执行特定的 API 操作。然后，管理员必须将这些策略附加到需要这些权限的用户或组。
要了解如何使用这些示例 JSON 策略文档创建 IAM 基于身份的策略，请参阅《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)
## 策略最佳实践
基于身份的策略确定某个人是否可以创建、访问或删除您账户中的 X-Ray 资源。这些操作可能会使 AWS 账户产生成本。创建或编辑基于身份的策略时，请遵循以下指南和建议：
+ **开始使用 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 最佳实践。IAM Access Analyzer 提供 100 多项策略检查和可操作的建议，以帮助您制定安全且功能性强的策略。有关更多信息，请参阅《IAM 用户指南》**中的[使用 IAM Access Analyzer 验证策略](https://docs.aws.amazon.com/IAM/latest/UserGuide/access-analyzer-policy-validation.html)。
+ **需要多重身份验证 (MFA**)-如果 AWS 账户您的场景需要 IAM 用户或根用户，请启用 MFA 以提高安全性。若要在调用 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 账户。如果创建比必需的最低权限更为严格的基于身份的策略，对于附加了该策略的实体（用户或角色），控制台将无法按预期正常运行。
为确保这些实体仍然可以使用 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 用户查看附加到其用户身份的内联和托管式策略。此策略包括在控制台上或使用 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 采样规则和组](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 SDK 从 X-Ray API 获取跟踪数据、轨迹地图、见解和 X-Ray 配置的权限。 AWS CLI包括可观察性访问管理器 (OAM) `oam:ListSinks` 和`oam:ListAttachedSinks`权限，允许控制台查看作为[CloudWatch 跨](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html)账户可观察性一部分的源账户共享的跟踪记录。`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 SDK 将分段文档和遥测数据上传到 X-Ray API 的权限。 AWS CLI包含读取权限以获取[采样规则](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` - 授予创建、管理和查看 Observability Access Manager 链接的权限，在账户之间实现 X-Ray 资源共享。用于启用来源账户和监控[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 的权限 APIs，包括读取权限、写入权限以及配置加密密钥设置和采样规则的权限。包括可观察性访问管理器 (OAM) `oam:ListSinks` 和`oam:ListAttachedSinks`权限，允许控制台查看作为[CloudWatch 跨](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html)账户可观察性一部分的源账户共享的跟踪记录。
------
#### [ 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 源。
| 更改 | 描述 | 日期 |
| --- | --- | --- |
| [X-Ray 的 IAM 托管策略](#xray-permissions-managedpolicies) - 添加了新的 `AWSXrayCrossAccountSharingConfiguration`，并更新了 `AWSXrayReadOnlyAccess` 和 `AWSXrayFullAccess` 策略。 | X-Ray 在这些策略中添加了可观察性访问管理器 (OAM) 权限`oam:ListSinks`，允许控制台查看作为[CloudWatch 跨](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html)账户可观察性一部分的源账户共享的跟踪。`oam:ListAttachedSinks` | 2022 年 11 月 27 日 |
| [X-Ray 的 IAM 托管策略](#xray-permissions-managedpolicies) - 更新了 `AWSXrayReadOnlyAccess` 策略。 | X-Ray 添加了一项 API 操作，`ListResourcePolicies`。 | 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` 时，可将此定义为通配符或确切的 ARN（包括 ID）。
------
#### [ 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 由其名称定义。与组不同 ARNs，采样规则没有唯一生成的 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)
+ [我想允许我以外的人访问我 AWS 账户 的 X-Ray 资源](#security_iam_troubleshoot-cross-account-access)
## 我无权在 X-Ray 中执行操作
如果 AWS 管理控制台 告诉您您无权执行某项操作，则必须联系管理员寻求帮助。管理员是向您提供登录凭证的人。
当 `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` 操作。
如果您需要帮助，请联系您的 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)。
## 我想允许我以外的人访问我 AWS 账户 的 X-Ray 资源
您可以创建一个角色，以便其他账户中的用户或您组织外的人员可以使用该角色来访问您的资源。您可以指定谁值得信赖，可以代入角色。对于支持基于资源的策略或访问控制列表 (ACLs) 的服务，您可以使用这些策略向人们授予访问您的资源的权限。
要了解更多信息，请参阅以下内容：
+ 要了解 X-Ray 是否支持这些特征，请参阅 [如何 AWS X-Ray 与 IAM 配合使用](security_iam_service-with-iam.md)。
+ 要了解如何提供对您拥有的资源的访问权限 AWS 账户 ，请参阅 [IAM 用户*指南中的向您拥有 AWS 账户 的另一个 IAM 用户*提供访问](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_aws-accounts.html)权限。
+ 要了解如何向第三方提供对您的资源的访问[权限 AWS 账户，请参阅 *IAM 用户指南*中的向第三方提供](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_common-scenarios_third-party.html)访问权限。 AWS 账户
+ 要了解如何通过身份联合验证提供访问权限，请参阅《IAM 用户指南》**中的[为经过外部身份验证的用户（身份联合验证）提供访问权限](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 与 AWS CloudTrail 集成，以记录 X-Ray 中用户、角色或 AWS 服务的 API 操作。您可以使用 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 加密资源、审核 X-Ray 配置历史记录并基于资源更改发送通知。有关更多信息，请参阅 [使用 AWS Config 跟踪 X-Ray 加密配置更改](xray-api-config.md)。
**Amazon CloudWatch 监控**
您可以使用适用于 Java 的 X-Ray 开发工具包从收集的 X-Ray 分段中发布未采样的 Amazon CloudWatch 指标。这些指标来自分段的开始和结束时间以及错误、故障和限制状态标志。使用这些指标可暴露子分段里的重试和依赖项问题。有关更多信息，请参阅 [AWS X-Ray 适用于 Java 的 X-Ray SDK 的指标](xray-sdk-java.md#xray-sdk-java-monitoring)。
# 合规性验证 AWS X-Ray
要了解是否属于特定合规计划的范围，请参阅AWS 服务 “[按合规计划划分的范围](https://aws.amazon.com/compliance/services-in-scope/)” ”，然后选择您感兴趣的合规计划。 AWS 服务 有关一般信息，请参阅[AWS 合规计划AWS](https://aws.amazon.com/compliance/programs/)。
您可以使用下载第三方审计报告 AWS Artifact。有关更多信息，请参阅中的 “[下载报告” 中的 “ AWS Artifact](https://docs.aws.amazon.com/artifact/latest/ug/downloading-documents.html)。
您在使用 AWS 服务 时的合规责任取决于您的数据的敏感性、贵公司的合规目标以及适用的法律和法规。有关您在使用时的合规责任的更多信息 AWS 服务，请参阅[AWS 安全文档](https://docs.aws.amazon.com/security/)。
# 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。客户端必须支持以下内容：
+ 传输层安全性协议（TLS）。我们要求使用 TLS 1.2，建议使用 TLS 1.3。
+ 具有完全向前保密（PFS）的密码套件，例如 DHE（临时 Diffie-Hellman）或 ECDHE（临时椭圆曲线 Diffie-Hellman）。大多数现代系统（如 Java 7 及更高版本）都支持这些模式。
# 将 AWS X-Ray 与 VPC 端点结合使用
如果您使用 Amazon Virtual Private Cloud (Amazon VPC) 托管 AWS 资源，则可以在您的 VPC 和 X-Ray 之间建立私有连接。这让 Amazon VPC 中的资源能够与 X-Ray 服务进行通信而不用访问公共互联网。
Amazon VPC 是一项 AWS 服务，可用来启动在虚拟网络中定义的 AWS 资源。借助 VPC，您可以控制您的网络设置，如 IP 地址范围、子网、路由表和网络网关。要将 VPC 连接到 X-Ray，请定义一个[接口 VPC 端点](https://docs.aws.amazon.com/vpc/latest/privatelink/vpce-interface.html)。该端点提供了到 X-Ray 的可靠、可扩展的连接，无需 Internet 网关、网络地址转换 (NAT) 实例或 VPN 连接。有关更多信息，请参阅**《Amazon VPC 用户指南》中的[什么是 Amazon VPC](https://docs.aws.amazon.com/vpc/latest/userguide/)。
接口 VPC 端点由 AWS PrivateLink 提供支持，后者是一种AWS技术，可将弹性网络接口与私有 IP 地址结合使用来支持AWS 服务之间的私有通信。有关更多信息，请参阅*《Amazon VPC 用户指南》*中的[新功能 - 适用于 AWS 服务 的 AWS PrivateLink](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 端点
要开始将您的 X-Ray 与 VPC 一起使用，请为 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/zh_cn/xray/latest/devguide/images/xray-vpc-select-service.png)
1. 选择您想要的 VPC，然后在 VPC 中选择使用接口端点的子网。所选子网中创建一个端点网络接口。您可以在不同的可用区中指定多个子网（在服务支持的情况下），以帮助确保您的接口端点能够在出现可用区故障时复原。如果执行此操作，将在您指定的每个子网中创建一个接口网络接口。
![\[选择 VPC 和子网。\]](http://docs.aws.amazon.com/zh_cn/xray/latest/devguide/images/xray-vpc-select-vpc.png)
1. （可选）默认情况下，端点启用私有 DNS，以使您能够使用默认的 DNS 主机名向 X-Ray 发出请求。您可以选择将其禁用。
1. 指定要与端点网络接口关联的安全组。
![\[选择安全组\]](http://docs.aws.amazon.com/zh_cn/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*.monitoring** 端点，然后选择**策略**选项卡。
1. 选择**编辑策略**，然后进行更改。
## 支持的区域
X-Ray 当前在以下AWS 区域中支持 VPC 端点：
+ 美国东部（俄亥俄州）
+ 美国东部（弗吉尼亚州北部）
+ 美国西部（加利福尼亚北部）
+ 美国西部（俄勒冈州）
+ 非洲（开普敦）
+ 亚太地区（香港）
+ Asia Pacific (Mumbai)
+ 亚太地区（大阪）
+ 亚太地区（首尔）
+ 亚太地区（新加坡）
+ 亚太地区（悉尼）
+ 亚太地区（东京）
+ 加拿大（中部）
+ 欧洲地区（法兰克福）
+ 欧洲地区（爱尔兰）
+ 欧洲地区（伦敦）
+ 欧洲地区（米兰）
+ 欧洲地区（巴黎）
+ 欧洲地区（斯德哥尔摩）
+ 中东（巴林）
+ 南美洲（圣保罗）
+ AWS GovCloud（美国东部）
+ AWS GovCloud（美国西部）
# 防止跨服务混淆座席
混淆代理问题是一个安全性问题，即不具有操作执行权限的实体可能会迫使具有更高权限的实体执行该操作。在中 AWS，跨服务模仿可能会导致混乱的副手问题。一个服务（*呼叫服务*）调用另一项服务（*所谓的服务*）时，可能会发生跨服务模拟。可以操纵调用服务，使用其权限以在其他情况下该服务不应有访问权限的方式对另一个客户的资源进行操作。为防止这种情况， AWS 提供可帮助您保护所有服务的数据的工具，而这些服务中的服务主体有权限访问账户中的资源。
我们建议在资源策略中使用 [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) 全局条件上下文键，以限制 xraylong 为其他服务提供的资源访问权限。使用 `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)。
防范混淆代理问题最有效的方法是使用 `aws:SourceArn` 全局条件上下文键和资源的完整 ARN。如果不知道资源的完整 ARN，或者正在指定多个资源，请针对 ARN 未知部分使用带有通配符字符（`*`）的 `aws:SourceArn` 全局上下文条件键。例如 `arn:aws:servicename:*:123456789012:*`。
如果 `aws:SourceArn` 值不包含账户 ID，例如 Amazon S3 桶 ARN，您必须使用 `aws:SourceAccount` 和 `aws:SourceArn` 来限制权限。
要防范大规模混淆代理问题，请在基于资源的策略中将 `aws:SourceOrgID` 或 `aws:SourceOrgPaths` 全局条件上下文键与资源的组织 ID 或组织路径一起使用。包含 `aws:SourceOrgID` 或 `aws:SourceOrgPaths` 键的策略将自动包含正确的账户，并且当您在组织中添加、删除或移动账户时，无需手动更新策略。
以下示例演示如何使用 xray 中的 `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:*"
}
}
}
```