适用于 Amazon CloudTrail 的基于身份的策略示例 - Amazon CloudTrail
策略最佳实践示例：允许和拒绝针对指定跟踪的操作示例：对针对特定跟踪记录的操作创建和应用策略示例：拒绝基于标签创建或删除事件数据存储的访问权限使用控制台允许用户查看他们自己的权限向 CloudTrail 用户授予自定义权限
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

适用于 Amazon CloudTrail 的基于身份的策略示例

默认情况下，用户和角色没有创建或修改 CloudTrail 资源的权限。要授予用户对所需资源执行操作的权限，IAM 管理员可以创建 IAM 策略。

要了解如何使用这些示例 JSON 策略文档创建基于 IAM 身份的策略，请参阅《IAM 用户指南》中的创建 IAM 策略（控制台）。

有关 CloudTrail 定义的操作和资源类型的详细信息，包括每种资源类型的 ARN 格式，请参阅《服务授权参考》中的 Amazon CloudTrail 的操作、资源和条件键。

策略最佳实践

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

  • Amazon 托管式策略及转向最低权限许可入门 – 要开始向用户和工作负载授予权限，请使用 Amazon 托管式策略来为许多常见使用场景授予权限。您可以在 Amazon Web Services 账户 中找到这些策略。我们建议通过定义特定于您的使用场景的 Amazon 客户托管式策略来进一步减少权限。有关更多信息，请参阅《IAM 用户指南》中的 Amazon 托管式策略或工作职能的 Amazon 托管式策略。

  • 应用最低权限：在使用 IAM 策略设置权限时，请仅授予执行任务所需的权限。为此，您可以定义在特定条件下可以对特定资源执行的操作，也称为最低权限许可。有关使用 IAM 应用权限的更多信息，请参阅《IAM 用户指南》中的 IAM 中的策略和权限。

  • 使用 IAM 策略中的条件进一步限制访问权限：您可以向策略添加条件来限制对操作和资源的访问。例如，您可以编写策略条件来指定必须使用 SSL 发送所有请求。如果通过特定 Amazon Web Services 服务（例如 Amazon CloudFormation）使用服务操作，您还可以使用条件来授予对服务操作的访问权限。有关更多信息，请参阅《IAM 用户指南》中的 IAM JSON 策略元素：条件。

  • 使用 IAM Access Analyzer 验证您的 IAM 策略，以确保权限的安全性和功能性 – IAM Access Analyzer 会验证新策略和现有策略，以确保策略符合 IAM 策略语言（JSON）和 IAM 最佳实践。IAM Access Analyzer 提供 100 多项策略检查和可操作的建议，以帮助您制定安全且功能性强的策略。有关更多信息，请参阅《IAM 用户指南》中的使用 IAM Access Analyzer 验证策略。

  • 需要多重身份验证（MFA）：如果您所处的场景要求您的 Amazon Web Services 账户 中有 IAM 用户或根用户，请启用 MFA 来提高安全性。若要在调用 API 操作时需要 MFA，请将 MFA 条件添加到您的策略中。有关更多信息，请参阅《IAM 用户指南》中的使用 MFA 保护 API 访问。

有关 IAM 中的最佳实操的更多信息，请参阅《IAM 用户指南》中的 IAM 中的安全最佳实践。

CloudTrail 没有可在策略语句的 Condition 元素中使用的服务特定上下文键。

示例：允许和拒绝针对指定跟踪的操作

以下示例演示了一个策略，该策略允许具有此策略的用户查看跟踪的状态和配置，并为名为 My-First-Trail 的跟踪启动和停止日志记录。此跟踪在 ID 为 123456789012 的 Amazon Web Services 账户 的美国东部（俄亥俄州）区域（其主区域）中创建。

JSON
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
      {
          "Effect": "Allow",
          "Action": [
              "cloudtrail:StartLogging",
              "cloudtrail:StopLogging",
              "cloudtrail:GetTrail",
              "cloudtrail:GetTrailStatus",
              "cloudtrail:GetEventSelectors"
          ],
          "Resource": [
              "arn:aws:cloudtrail:us-east-2:123456789012:trail/My-First-Trail"
          ]
      }
  ]
}

下面的示例中演示的策略明确地拒绝对任何名称不为 My-First-Trail 的跟踪执行 CloudTrail 操作。

JSON
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
      {
          "Effect": "Deny",
          "Action": [
              "cloudtrail:*"
          ],
          "NotResource": [
              "arn:aws:cloudtrail:us-east-2:123456789012:trail/My-First-Trail"
          ]
      }
  ]
}

示例：对针对特定跟踪记录的操作创建和应用策略

您可以使用权限和策略来控制用户对 CloudTrail 跟踪记录执行特定操作的能力。

例如，您不想公司开发人员组中的用户开始或停止对特定跟踪的日志记录。但是，您可能想授予他们在跟踪中执行 DescribeTrails 和 GetTrailStatus 操作的权限。您希望开发人员组的用户能够对自己管理的跟踪记录执行 StartLogging 或 StopLogging 操作。

您可以创建两条策略语句，然后将它们附加到您在 IAM 中创建的开发人员组。有关 IAM 中的组的更多信息，请参阅 IAM 用户指南中的 IAM 组。

在第一条策略中，您拒绝对您指定的跟踪 ARN 执行 StartLogging 和 StopLogging 操作。在下面的示例中，跟踪 ARN 为 arn:aws:cloudtrail:us-east-2:123456789012:trail/Example-Trail。

JSON
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "Stmt1446057698000",
            "Effect": "Deny",
            "Action": [
                "cloudtrail:StartLogging",
                "cloudtrail:StopLogging"
            ],
            "Resource": [
                "arn:aws:cloudtrail:us-east-2:123456789012:trail/Example-Trail"
            ]
        }
    ]
}

在第二条策略中，允许对所有 CloudTrail 资源执行 DescribeTrails 和 GetTrailStatus 操作：

JSON
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "Stmt1446072643000",
            "Effect": "Allow",
            "Action": [
                "cloudtrail:DescribeTrails",
                "cloudtrail:GetTrail",
                "cloudtrail:GetTrailStatus"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}

如果开发人员组中的用户尝试针对您在第一条策略中指定的跟踪启动或停止日志记录，该用户会收到拒绝访问异常。该开发人员组中的用户可针对自己创建和管理的跟踪记录启动和停止日志记录。

以下示例显示在名为 devgroup 的 Amazon CLI 配置文件中配置的开发人员组。首先，devgroup 的用户运行 describe-trails 命令。

$ aws --profile devgroup cloudtrail describe-trails

该命令成功完成并返回以下输出：

{
    "trailList": [
        {
            "IncludeGlobalServiceEvents": true, 
            "Name": "Default", 
            "TrailARN": "arn:aws:cloudtrail:us-east-2:123456789012:trail/Example-Trail", 
            "IsMultiRegionTrail": false, 
            "S3BucketName": "amzn-s3-demo-bucket", 
            "HomeRegion": "us-east-2"
        }
    ]
}

然后，该用户针对您在第一条策略中指定的跟踪运行 get-trail-status 命令。

$ aws --profile devgroup cloudtrail get-trail-status --name Example-Trail

该命令成功完成并返回以下输出：

{
    "LatestDeliveryTime": 1449517556.256, 
    "LatestDeliveryAttemptTime": "2015-12-07T19:45:56Z", 
    "LatestNotificationAttemptSucceeded": "", 
    "LatestDeliveryAttemptSucceeded": "2015-12-07T19:45:56Z", 
    "IsLogging": true, 
    "TimeLoggingStarted": "2015-12-07T19:36:27Z", 
    "StartLoggingTime": 1449516987.685, 
    "StopLoggingTime": 1449516977.332, 
    "LatestNotificationAttemptTime": "", 
    "TimeLoggingStopped": "2015-12-07T19:36:17Z"
}

接下来，devgroup 组中的一位用户针对同一个跟踪运行 stop-logging 命令。

$ aws --profile devgroup cloudtrail stop-logging --name Example-Trail

该命令返回拒绝访问异常，示例如下：

A client error (AccessDeniedException) occurred when calling the StopLogging operation: Unknown

该用户针对同一个跟踪运行 start-logging 命令。

$ aws --profile devgroup cloudtrail start-logging --name Example-Trail

该命令再次返回拒绝访问异常，示例如下：

A client error (AccessDeniedException) occurred when calling the StartLogging operation: Unknown

示例：拒绝基于标签创建或删除事件数据存储的访问权限

在如下策略示例中，如果以下条件一条都无法满足，使用 CreateEventDataStore 创建事件数据存储的权限将被拒绝：

  • 事件数据存储自身并没有应用 stage 标签键。

  • 阶段标签的值不是 alpha、beta、gamma 或 prod。

JSON
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Deny",
            "Action": "cloudtrail:CreateEventDataStore",
            "Resource": "*",
            "Condition": {
                "Null": {
                    "aws:RequestTag/stage": "true"
                }
            }
        },
        {
            "Effect": "Deny",
            "Action": "cloudtrail:CreateEventDataStore",
            "Resource": "*",
            "Condition": {
                "ForAnyValue:StringNotEquals": {
                    "aws:RequestTag/stage": [
                        "alpha",
                        "beta",
                        "gamma",
                        "prod"
                    ]
                }
            }
        }
    ]
}

在以下策略示例中，如果事件数据存储有 stage 标签且值为 prod，使用 DeleteEventDataStore 删除事件数据存储的权限将被拒绝。类似策略可以帮助保护事件数据存储免遭意外删除。

JSON
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Deny",
            "Action": "cloudtrail:DeleteEventDataStore",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/stage": "prod"
                }
            }
        }
    ]
}

使用 CloudTrail 控制台

要访问 Amazon CloudTrail控制台，您必须拥有一组最低的权限。这些权限必须允许您列出和查看有关您 Amazon Web Services 账户 中的 CloudTrail 资源的详细信息。如果创建比必需的最低权限更为严格的基于身份的策略，对于附加了该策略的实体（用户或角色），控制台将无法按预期正常运行。

对于只需要调用 Amazon CLI 或 Amazon API 的用户，无需为其提供最低控制台权限。相反，只允许访问与其尝试执行的 API 操作相匹配的操作。

授予 CloudTrail 管理权限

要允许 IAM 角色或用户管理 CloudTrail 资源（例如跟踪、事件数据存储或通道），您必须授予显式权限，使其能够执行与 CloudTrail 任务关联的操作。在大多数情况下，您可以使用包含预定义权限的 Amazon 托管策略。

注意

您向用户授予的执行 CloudTrail 管理任务的权限不同于 CloudTrail 将日志文件传输到 Amazon S3 存储桶或将通知发送到 Amazon SNS 主题所需的权限。有关这些权限的更多信息，请参阅 针对 CloudTrail 的 Simple Storage Service（Amazon S3）存储桶策略。

如果您配置与 Amazon CloudWatch Logs 的集成，则 CloudTrail 还需要一个角色，可通过代入此角色来将事件传送到 Amazon CloudWatch Logs 日志组。您必须创建 CloudTrail 要使用的角色。有关更多信息，请参阅 授予在 CloudTrail 控制台上查看和配置 Amazon CloudWatch Logs 信息的权限 和 将事件发送到 CloudWatch Logs。

以下 Amazon 托管策略适用于 CloudTrail：

  • AWSCloudTrail_FullAccess – 此策略提供对 CloudTrail 资源上的 CloudTrail 操作的完全访问权限，例如跟踪、事件数据存储和通道。此策略提供创建、更新和删除 CloudTrail 跟踪、事件数据存储和通道所需的权限。

    此策略还提供管理 Amazon S3 存储桶、CloudWatch Logs 的日志组以及跟踪的 Amazon SNS 主题的权限。但是，AWSCloudTrail_FullAccess 托管策略不提供删除 Amazon S3 存储桶、CloudWatch Logs 的日志组或 Amazon SNS 主题的权限。有关其他 Amazon Web Services 服务 的托管式策略的信息，请参阅《Amazon 托管式策略参考指南》。

    注意

    AWSCloudTrail_FullAccess 策略不旨在跨您的 Amazon Web Services 账户 账户广泛共享。拥有此角色的用户能够关闭或重新配置他们的 Amazon Web Services 账户 账户中最敏感且最重要的审计功能。因此，您只能将此策略应用于账户管理员。您必须严格控制和监控此策略的使用。

  • AWSCloudTrail_ReadOnlyAccess – 此策略可授予查看 CloudTrail 控制台的权限，包括近期事件和事件历史记录。此策略还支持查看现有跟踪、事件数据存储和通道。拥有此策略的角色和用户可以下载事件历史记录，但他们无法创建或更新跟踪、事件数据存储或通道。

要提供访问权限，请为您的用户、组或角色添加权限：

其他资源

要详细了解如何使用 IAM 授予用户和角色等身份对您账户中资源的访问权限，请参阅《IAM 用户指南》中的开始设置 IAM 和适用于 Amazon 资源的 Access Management。

对于只需要调用 Amazon CLI 或 Amazon API 的用户，无需为其提供最低控制台权限。相反，只允许访问与您尝试执行的 API 操作相匹配的操作。

允许用户查看他们自己的权限

该示例说明了您如何创建策略，以允许 IAM 用户查看附加到其用户身份的内联和托管式策略。此策略包括在控制台上完成此操作或者以编程方式使用 Amazon CLI 或 Amazon 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": "*"
        }
    ]
}

向 CloudTrail 用户授予自定义权限

CloudTrail 策略向使用 CloudTrail 的用户授予权限。如果您需要向用户授予不同权限，可将 CloudTrail 策略挂载到 IAM 组或用户。您可以编辑策略，使之包括或排除特定权限。您还可以创建自己的自定义策略。策略是一些 JSON 文档，它们定义了允许用户执行的操作以及允许用户对哪些资源执行这些操作。有关特定示例，请参阅示例：允许和拒绝针对指定跟踪的操作和示例：对针对特定跟踪记录的操作创建和应用策略。

只读访问权限

以下示例展示了一个策略，该策略授予对 CloudTrail 跟踪记录的只读访问权。这等同于托管策略 AWSCloudTrail_ReadOnlyAccess。它对用户授予查看跟踪信息的权限，而不是创建或更新跟踪记录的权限。

JSON
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "cloudtrail:Get*",
                "cloudtrail:Describe*",
                "cloudtrail:List*",
                "cloudtrail:LookupEvents"
            ],
            "Resource": "*"
        }
    ]
}

在这些策略语句中，Effect 元素指定是允许还是拒绝操作。Action 元素列出了允许用户执行的特定操作。Resource 元素列出允许用户对其执行这些操作的 Amazon 资源。对于控制对 CloudTrail 操作的访问的策略，Resource 元素通常设置为 *（一个表示“所有资源”的通配符）。

Action 元素中的值对应于服务支持的 API。操作前附加了 cloudtrail: 以表示其指的是 CloudTrail 操作。您可以在 * 元素中使用 Action 通配符，如以下示例所示：

  • "Action": ["cloudtrail:*Logging"]

    这允许以“Logging”结尾的所有 CloudTrail 操作（StartLogging、StopLogging）。

  • "Action": ["cloudtrail:*"]

    这允许所有 CloudTrail 操作，但不允许其他 Amazon 服务的操作。

  • "Action": ["*"]

    这将允许所有 Amazon 操作。此权限适合授予充当您账户的 Amazon 管理员的用户。

只读策略不对用户授予执行 CreateTrail、UpdateTrail、StartLogging 和 StopLogging 操作的权限。具有此策略的用户不能够创建跟踪记录、更新跟踪记录或启用和关闭日志记录。有关 CloudTrail 操作的完整列表，请参阅 Amazon CloudTrail API 参考。

完全访问

以下示例展示了一个授予对 CloudTrail 的完全访问权限的策略。这等同于托管策略 AWSCloudTrail_FullAccess。它对用户授予执行所有 CloudTrail 操作的权限。它还允许用户记录 Simple Storage Service（Amazon S3）和 Amazon Lambda 中的数据事件、管理 Simple Storage Service（Amazon S3）存储桶中的文件、管理 CloudWatch Logs 对 CloudTrail 日志事件的监控方式，以及管理与用户关联的账户中的 Amazon SNS 主题。

重要

未打算跨您的 Amazon 账户广泛共享 AWSCloudTrail_FullAccess 策略或等效权限。拥有此角色或等同访问权限的用户能够禁用或重新配置他们的 Amazon 账户中最敏感且最重要的审计功能。因此，此策略应仅应用于账户管理员，并且此策略的使用应受到密切控制和监控。

JSON
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "sns:AddPermission",
                "sns:CreateTopic",
                "sns:SetTopicAttributes",
                "sns:GetTopicAttributes"
            ],
            "Resource": [
                "arn:aws:sns:*:*:aws-cloudtrail-logs*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "sns:ListTopics"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:CreateBucket",
                "s3:PutBucketPolicy"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-logging-bucket1*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:ListAllMyBuckets",
                "s3:GetBucketLocation",
                "s3:GetBucketPolicy"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": "cloudtrail:*",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "logs:CreateLogGroup"
            ],
            "Resource": [
                "arn:aws:logs:*:*:log-group:aws-cloudtrail-logs*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "iam:ListRoles",
                "iam:GetRolePolicy",
                "iam:GetUser"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iam:PassRole"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "iam:PassedToService": "cloudtrail.amazonaws.com"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "kms:CreateKey",
                "kms:CreateAlias",
                "kms:ListKeys",
                "kms:ListAliases"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "lambda:ListFunctions"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "dynamodb:ListGlobalTables",
                "dynamodb:ListTables"
            ],
            "Resource": "*"
        }
    ]
}

授予在 CloudTrail 控制台中查看 Amazon Config 信息的权限

您可以在 CloudTrail 控制台中查看事件信息，包括与该事件相关的资源。对于这些资源，您可以选择 Amazon Config 图标在 Amazon Config 控制台中查看资源的时间表。可将此策略挂载到您的用户，以对其授予只读 Amazon Config 访问权。该策略不对他们授予在 Amazon Config 中更改设置的权限。

JSON
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [{
        "Effect": "Allow",
        "Action": [
            "config:Get*",
            "config:Describe*",
            "config:List*"
        ],
        "Resource": "*"
    }]
}

有关更多信息，请参阅 使用 Amazon Config 查看引用的资源。

授予在 CloudTrail 控制台上查看和配置 Amazon CloudWatch Logs 信息的权限

如果您具有足够的权限，则可以在 CloudTrail 控制台查看和配置将事件传送到 CloudWatch Logs 的行为。这些权限可能超出了为 CloudTrail 管理员授予的权限。将此策略附加到将配置和管理 CloudTrail 与 CloudWatch Logs 集成的管理员。该策略未在 CloudTrail 或 CloudWatch Logs 中直接授予他们权限，而是授予创建和配置 CloudTrail 将代入的角色所需的权限，此角色将事件成功地传送到您的 CloudWatch Logs 组。

JSON
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [{
        "Effect": "Allow",
        "Action": [
            "iam:CreateRole",
            "iam:PutRolePolicy",
            "iam:AttachRolePolicy",
            "iam:ListRoles",
            "iam:GetRolePolicy",
            "iam:GetUser"
        ],
        "Resource": "*"
    }]
}

有关更多信息，请参阅 使用 Amazon CloudWatch Logs 监控 CloudTrail 日志文件。

其他信息

要详细了解如何使用 IAM 授予用户和角色等身份对您账户中资源的访问权限，请参阅《IAM 用户指南》中的开始使用 和适用于 Amazon 资源的 Access Management。