策略最佳实践使用控制台允许用户查看他们自己的权限客户托管式策略示例基于标签查看 Systems Manager 文档

Amazon Systems Manager 基于身份的策略示例

预设情况下，Amazon Identity and Access Management (IAM) 用户和角色没有创建或修改 Amazon Systems Manager 资源的权限。他们还无法使用 Systems Manager 控制台、Amazon Command Line Interface (Amazon CLI) 或 Amazon API 执行任务。IAM 管理员必须创建 IAM policy，以便为用户和角色授予权限以对所需的指定资源执行特定的 API 操作。然后，管理员必须将这些策略附加到需要这些权限的 IAM 用户或组。

以下示例权限策略允许用户删除位于美国东部（俄亥俄）（us-east-2）Amazon Web Services 区域的名称以 MyDocument- 开头的文档。


{
  "Version": "2012-10-17",
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : [
        "ssm:DeleteDocument"
      ],
      "Resource" : [
        "arn:aws:ssm:us-east-2:111122223333:document/MyDocument-*"
      ]
    }
  ]
}

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

主题

策略最佳实践
使用 Systems Manager 控制台
允许用户查看他们自己的权限
防止跨服务混淆代理
客户托管式策略示例
基于标签查看 Systems Manager 文档

策略最佳实践

基于身份的策略确定某个人是否可以创建、访问或删除您账户中的 Systems Manager 资源。这些操作可能会使 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 策略验证。
需要多重身份验证 (MFA) – 如果您的账户需要 IAM 用户或根用户，请启用 MFA 来提高安全性。若要在调用 API 操作时需要 MFA，请将 MFA 条件添加到您的策略中。有关更多信息，请参阅《IAM 用户指南》中的配置受 MFA 保护的 API 访问。

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

使用 Systems Manager 控制台

要访问 Systems Manager 控制台，您必须具有一组最低的权限。这些权限必须允许您列出和查看有关您 Amazon Web Services 账户中的 Systems Manager 资源和其他资源的详细信息。

要在 Systems Manager 控制台中充分使用 Systems Manager，您必须拥有来自以下服务的权限：

Amazon Systems Manager
Amazon Elastic Compute Cloud (Amazon EC2)
Amazon Identity and Access Management (IAM)

您可以使用以下策略声明授予所需权限。


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ssm:*",
                "ec2:describeInstances",
                "iam:ListRoles"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": "iam:PassRole",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "iam:PassedToService": "ssm.amazonaws.com"
                }
            }
        }
    ]
}

如果您创建的基于身份的策略比所需的最低权限更严格，则无法为具有该策略的实体（IAM 用户或角色）正常运行控制台。

对于只需要调用 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": "*"
        }
    ]
}

客户托管式策略示例

您可以创建在自己的 Amazon Web Services 账户中管理的独立策略。我们将它们称作客户托管策略。随后可以将这些策略附加到您 Amazon Web Services 账户中的多个主要委托人实体。将策略附加到主体实体时，便向实体授予了策略中定义的权限。有关更多信息，请参阅 IAM 用户指南中的客户托管式策略示例。

以下用户策略示例授予执行各种 Systems Manager 操作的权限。您可以使用它们限制 IAM 用户和角色对 Systems Manager 的访问权限。在 Systems Manager API、Amazon 开发工具包或 Amazon CLI 中执行操作时，这些策略将会发挥作用。对于使用控制台的用户，需要授予特定于控制台的其他权限。有关更多信息，请参阅使用 Systems Manager 控制台。

注意

所有示例都使用美国西部（俄勒冈）区域 (us-west-2) 和虚构的账户 ID。不应在 Amazon 公有文档（以 AWS-* 开头的文档）的 Amazon Resource Name (ARN) 中指定账户 ID。

示例

示例 1：允许用户在单个区域中执行 Systems Manager 操作
示例 2：允许用户列出某个区域的文档

示例 1：允许用户在单个区域中执行 Systems Manager 操作

以下示例授予在美国东部（俄亥俄）区域（us-east-2）中执行 Systems Manager 操作的权限。


{
  "Version": "2012-10-17",
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : [
        "ssm:*"
      ],
      "Resource" : [
        "arn:aws:ssm:us-east-2:aws-account-ID:*"
      ]
    }
  ]
}

示例 2：允许用户列出某个区域的文档

以下示例授予列出美国东部（俄亥俄）区域（us-east-2）中所有以 Update 开头的文档名称的权限。


{
  "Version": "2012-10-17",
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : [
        "ssm:ListDocuments"
      ],
      "Resource" : [
        "arn:aws:ssm:us-east-2:aws-account-ID:document/Update*"
      ]
    }
  ]
}

示例 3：允许用户使用特定 SSM 文档在特定节点上运行命令

以下示例 IAM policy 允许用户在美国东部（俄亥俄州）区域（us-east-2）执行以下操作：

列出 Systems Manager 文档（SSM 文档）和文档版本。
查看有关文档的详细信息。
使用策略中指定的文档发送命令。文档名称由以下条目确定。
```
arn:aws:ssm:us-east-2:aws-account-ID:document/Systems-Manager-document-name
```

将命令发送到三个节点。节点由第二个 Resource 部分中的以下条目确定。


"arn:aws:ssm:us-east-2:aws-account-ID:instance/i-02573cafcfEXAMPLE",
"arn:aws:ssm:us-east-2:aws-account-ID:instance/i-0471e04240EXAMPLE",
"arn:aws:ssm:us-east-2:aws-account-ID:instance/i-07782c72faEXAMPLE"

发送命令后查看有关命令的详细信息。
在自动化（Amazon Systems Manager 的一项功能）中启动和停止工作流。
获取有关自动化工作流的信息。

如果您要授予某个用户使用此文档向该用户有权访问（取决于其用户账户）的任何节点发送命令的权限，则可以在 Resource 部分指定与以下类似的条目并删除其他节点条目。以下示例使用美国东部（俄亥俄）区域（us-east-2）。


"arn:aws:ssm:us-east-2:*:instance/*"


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "ssm:ListDocuments",
                "ssm:ListDocumentVersions",
                "ssm:DescribeDocument",
                "ssm:GetDocument",
                "ssm:DescribeInstanceInformation",
                "ssm:DescribeDocumentParameters",
                "ssm:DescribeInstanceProperties"
            ],
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Action": "ssm:SendCommand",
            "Effect": "Allow",
            "Resource": [
                "arn:aws:ssm:us-east-2:aws-account-ID:instance/i-02573cafcfEXAMPLE",
                "arn:aws:ssm:us-east-2:aws-account-ID:instance/i-0471e04240EXAMPLE",
                "arn:aws:ssm:us-east-2:aws-account-ID:instance/i-07782c72faEXAMPLE",
                
                "arn:aws:ssm:us-east-2:aws-account-ID:document/Systems-Manager-document-name"
            ]
        },
        {
            "Action": [
                "ssm:CancelCommand",
                "ssm:ListCommands",
                "ssm:ListCommandInvocations"
            ],
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Action": "ec2:DescribeInstanceStatus",
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Action": "ssm:StartAutomationExecution",
            "Effect": "Allow",
            "Resource": [
                "arn:aws:ssm:us-east-2:aws-account-ID:automation-definition/*"
            ]
        },
        {
            "Action": "ssm:DescribeAutomationExecutions",
            "Effect": "Allow",
            "Resource": [
                "*"
            ]
        },
        {
            "Action": [
                "ssm:StopAutomationExecution",
                "ssm:GetAutomationExecution"
            ],
            "Effect": "Allow",
            "Resource": [
                "*"
            ]
        }
    ]
}

基于标签查看 Systems Manager 文档

您可以在基于身份的策略中使用条件，以便基于标签控制对 Systems Manager 资源的访问。此示例显示如何创建策略以允许查看 SSM 文档。但是，仅当文档标签 Owner 的值为该用户的用户名时，才能授予此权限。此策略还授予在控制台上完成此操作的必要权限。


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "ListDocumentsInConsole",
            "Effect": "Allow",
            "Action": "ssm:ListDocuments",
            "Resource": "*"
        },
        {
            "Sid": "ViewDocumentIfOwner",
            "Effect": "Allow",
            "Action": "ssm:GetDocument",
            "Resource": "arn:aws:ssm:*:*:document/*",
            "Condition": {
                "StringEquals": {"ssm:ResourceTag/Owner": "${aws:username}"}
            }
        }
    ]
}

您可以将该策略附加到您账户中的 IAM 用户。如果名为 richard-roe 的用户尝试查看 Systems Manager 文档，则必须将该文档标记为 Owner=richard-roe 或 owner=richard-roe。否则，他们将被拒绝访问。条件标签密钥 Owner 与 Owner 和 owner 匹配，因为条件密钥名称不区分大小写。有关更多信息，请参阅《IAM 用户指南》中的 IAM JSON 策略元素：条件。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

Amazon Systems Manager 如何与 IAM 协同工作

防止跨服务混淆代理