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

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

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

默认情况下，用户和角色没有创建或修改 CloudTrail 资源的权限。他们也无法使用 Amazon Web Services Management Console、Amazon Command Line Interface（Amazon CLI）或 Amazon API 执行任务。要用户用户在其需要的资源上执行操作的权限，IAM 管理员可以创建 IAM 策略。管理员随后可以向角色添加 IAM 策略，用户可以代入角色。

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

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

策略最佳实践

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

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

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

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

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

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

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

CloudTrail没有可以在策略声明Condition元素中使用的特定服务上下文密钥。

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

以下示例演示了一个策略，该策略允许拥有该策略的用户查看跟踪的状态和配置，并开始和停止记录名为 My-F irst Trail 的跟踪。这条步道是在美国东部（俄亥俄州）地区（其故乡地区）创建的，编号为 123456789012。Amazon Web Services 账户

{
  "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执行操作。

{
  "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。

{
    "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 操作：

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

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

以下示例显示配置的开发人员组位于名为的配置Amazon CLI文件中devgroup。首先，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": "myS3bucket ", 
            "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应用于自身

  • 舞台标签的值不是alphabeta、gamma、或prod。

{
    "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标签值DeleteEventDataStore为，则删除事件数据存储的权限将被拒绝prod。像这样的策略可以帮助保护事件数据存储免遭意外删除。

{
    "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管理任务的权限与向 Amazon S3 存储桶传输日志文件或向 Amazon SNS 主题发送通知CloudTrail所需的权限不同。有关这些权限的更多信息，请参阅的 Amazon S3 存储桶策略 CloudTrail。

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

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

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

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

    注意

    该AWSCloudTrail_FullAccess政策不打算在您之间广泛共享Amazon Web Services 账户. 具有此角色的用户可以关闭或重新配置其Amazon Web Services 账户中最敏感和最重要的审计功能。因此，您只能将此政策应用于账户管理员。您必须密切控制和监控本政策的使用。

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

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

其他资源

要了解有关使用 IAM 为身份（例如用户和角色）授予账户中资源的访问权限的更多信息，请参阅 IAM 用户指南中的 IAM 设置和Amazon资源访问权限管理。

对于只需要调用 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。它对用户授予查看跟踪信息的权限，而不是创建或更新跟踪记录的权限。

{
    "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 CloudTrailAPI 参考。

完全访问权限

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

重要

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

{
    "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:::aws-cloudtrail-logs*"
            ]
        },
        {
            "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 中更改设置的权限。

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

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

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

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

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

有关更多信息，请参阅使用亚马逊CloudTrail日志监控CloudWatch日志文件：

其他信息

要了解有关使用 IAM 为身份（例如用户和角色）授予账户中资源的访问权限的更多信息，请参阅 IAM 用户指南中的入门和Amazon资源访问权限管理。