策略最佳实践使用控制台允许用户查看他们自己的权限访问 AWS Health Dashboard 和 AWS Health API 基于资源和基于操作的条件

AWS Health 基于身份的策略示例

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

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

策略最佳实践

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

AWS 托管策略及转向最低权限许可入门 – 要开始向用户和工作负载授予权限，请使用 AWS 托管策略来为许多常见使用场景授予权限。您可以在 AWS 账户中找到这些策略。我们建议通过定义特定于您的使用场景的 AWS 客户管理型策略来进一步减少权限。有关更多信息，请参阅《IAM 用户指南》中的 AWS 托管策略或工作职能的 AWS 托管策略。
应用最低权限 – 在使用 IAM 策略设置权限时，请仅授予执行任务所需的权限。为此，您可以定义在特定条件下可以对特定资源执行的操作，也称为最低权限许可。有关使用 IAM 应用权限的更多信息，请参阅《IAM 用户指南》中的 IAM 中的策略和权限。
使用 IAM 策略中的条件进一步限制访问权限 – 您可以向策略添加条件来限制对操作和资源的访问。例如，您可以编写策略条件来指定必须使用 SSL 发送所有请求。如果通过特定（AWS 服务例如 AWS CloudFormation）使用服务操作，您还可以使用条件来授予对服务操作的访问权限。有关更多信息，请参阅《IAM 用户指南》中的 IAM JSON 策略元素：条件。
使用 IAM Access Analyzer 验证您的 IAM 策略，以确保权限的安全性和功能性 – IAM Access Analyzer 会验证新策略和现有策略，以确保策略符合 IAM 策略语言 (JSON) 和 IAM 最佳实践。IAM Access Analyzer 提供 100 多项策略检查和可操作的建议，以帮助您制定安全且功能性强的策略。有关更多信息，请参阅《IAM 用户指南》中的使用 IAM Access Analyzer 验证策略。
需要多重身份验证（MFA） – 如果您所处的场景要求您的 AWS 账户中有 IAM 用户或根用户，请启用 MFA 来提高安全性。若要在调用 API 操作时需要 MFA，请将 MFA 条件添加到您的策略中。有关更多信息，请参阅《IAM 用户指南》中的使用 MFA 保护 API 访问。

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

使用 AWS Health控制台

要访问 AWS Health控制台，您必须拥有一组最低的权限。这些权限必须允许您列出和查看有关您的 AWS 账户中的 AWS Health 资源的详细信息。如果您创建的基于身份的策略比所需的最低权限更严格，则无法为具有该策略的实体（IAM 用户或角色）正常运行控制台。

为了确保这些实体仍然可以使用 AWS Health 控制台，您可以附加以下 AWS 托管策略 AWSHealthFullAccess。

AWSHealthFullAccess 策略授予实体对以下内容的完全访问权限：

为 AWS 组织中的所有账户启用或禁用 AWS Health 组织视图功能
AWS Health 控制台中的 AWS Health Dashboard。
AWS Health API 操作和通知
查看有关您 AWS 组织的账户的信息
查看管理账户的组织单位 (OU)

例 : AWSHealthFullAccess


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "organizations:EnableAWSServiceAccess",
                "organizations:DisableAWSServiceAccess"         
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "organizations:ServicePrincipal": "health.amazonaws.com"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "health:*",
                "organizations:DescribeAccount",    
                "organizations:ListAccounts",
                "organizations:ListDelegatedAdministrators",
                "organizations:ListParents"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": "iam:CreateServiceLinkedRole",
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "iam:AWSServiceName": "health.amazonaws.com"
                }
            }
        }
    ]
}

注意

您还可以使用 Health_OrganizationsServiceRolePolicy AWS 托管策略，以便 AWS Health 可以查看组织中其他账户的事件。有关更多信息，请参阅将服务相关角色用于 AWS Health。

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

有关更多信息，请参阅《IAM 用户指南》中的为用户添加权限。

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

该示例说明了您如何创建策略，以允许 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": "*"
        }
    ]
}

访问 AWS Health Dashboard 和 AWS Health API

AWS Health Dashboard 适用于所有 AWS 账户。AWS Health API 仅适用于具有商业、Enterprise On-Ramp 或 Enterprise Support 计划的账户。有关更多信息，请参阅 AWS Support。

您可以使用 IAM 创建实体（用户、组或角色），然后为这些实体授予权限，以访问 AWS Health Dashboard 和 AWS Health API。

默认情况下，IAM 用户无权访问 AWS Health Dashboard 或 AWS Health API。通过将 IAM 策略附加到单一用户、一组用户或角色，您可为用户授予对账户的 AWS Health 信息的访问权限。有关更多信息，请参阅身份 (用户、组和角色) 和 IAM 策略概述。

创建 IAM 用户以后，您可以为这些用户提供单独的密码。然后，他们可以使用特定于账户的登录页面登录账户并查看 AWS Health 信息。有关更多信息，请参阅用户如何登录您的账户。

注意

有权查看 AWS Health Dashboard 的 IAM 用户对账户上的所有 AWS 服务的运行状况信息具有只读访问权限，这些信息包括但不限于，AWS 资源 ID（例如，Amazon EC2 实例 ID）、EC2 实例 IP 地址和一般安全通知。

例如，如果某个 IAM policy 仅授予对 AWS Health Dashboard 和 AWS Health API 的访问权限，则该策略应用于的用户或角色可以访问已发布的有关 AWS 服务和相关资源的所有信息，即使其他 IAM policy 不允许该访问。

您可以为 AWS Health 使用两组 API。

单个账户 – 您可以使用 DescribeEvents 和 DescribeEventDetails 等此类操作来获取有关您账户的 AWS Health 事件的信息。
组织账户 – 您可以使用 DescribeEventsForOrganization 和 DescribeEventDetailsForOrganization 等此类操作来获取有关属于组织的账户的 AWS Health 事件的信息。

有关可用 API 操作的更多信息，请参阅 AWS Health API 参考。

单个操作

您可以将 IAM policy 的 Action 元素设置为 health:Describe*。这允许访问 AWS Health Dashboard 和 AWS Health。AWS Health 支持对基于 eventTypeCode 和服务的事件进行访问控制。

描述访问权限

此策略语句授予对 AWS Health Dashboard 和任何 Describe* AWS Health API 操作的访问权限。例如，具有此策略的 IAM 用户可以在 AWS Management Console 中访问 AWS Health Dashboard 并调用 AWS Health DescribeEvents API 操作。

例：描述访问权限


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

拒绝访问

此策略语句拒绝访问 AWS Health Dashboard 和 AWS Health API。具有此策略的 IAM 用户无法在 AWS Management Console 中查看 AWS Health Dashboard，也无法调用任何 AWS Health API 操作。

例：拒绝访问


{
  "Version": "2012-10-17",
  "Statement": [
  {
    "Effect": "Deny",
    "Action": [
      "health:*"
    ],
    "Resource": "*"
  }]
}

组织视图

如果要针对 AWS Health 启用组织视图，则必须允许访问 AWS Health 和 AWS Organizations 操作。

IAM 策略的 Action 元素必须包含以下权限：

iam:CreateServiceLinkedRole
organizations:EnableAWSServiceAccess
organizations:DescribeAccount
organizations:DisableAWSServiceAccess
organizations:ListAccounts
organizations:ListDelegatedAdministrators
organizations:ListParents

要了解每个 API 所需的确切权限，请参阅 IAM 用户指南中的 AWS Health APIs and Notifications 定义的操作。

注意

您必须使用来自组织的管理账户的凭证来访问 AWS Organizations 的 AWS Health API。有关更多信息，请参阅使用跨账户聚合 AWS Health 事件。

允许访问 AWS Health 组织视图

此策略语句授予对组织视图功能所需的全部 AWS Health 和 AWS Organizations 操作的访问权限。

例：允许 AWS Health 组织视图访问


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "organizations:EnableAWSServiceAccess",
                "organizations:DisableAWSServiceAccess"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "organizations:ServicePrincipal": "health.amazonaws.com"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "health:*",
                "organizations:DescribeAccount",
                "organizations:ListAccounts",
                "organizations:ListDelegatedAdministrators",  
                "organizations:ListParents"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": "iam:CreateServiceLinkedRole",
            "Resource": "arn:aws:iam::*:role/aws-service-role/health.amazonaws.com/AWSServiceRoleForHealth*"
        }
    ]
}

拒绝访问 AWS Health 组织视图

此策略语句拒绝访问 AWS Organizations 操作，但允许单个账户访问 AWS Health 操作。

例：拒绝 AWS Health 组织视图访问


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "health:*"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Deny",
            "Action": [
                "organizations:EnableAWSServiceAccess",
                "organizations:DisableAWSServiceAccess"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "organizations:ServicePrincipal": "health.amazonaws.com"
                }
            }
        },
        {
            "Effect": "Deny",
            "Action": [
                "organizations:DescribeAccount",
                "organizations:ListAccounts",
                "organizations:ListDelegatedAdministrators",
                "organizations:ListParents"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Deny",
            "Action": "iam:CreateServiceLinkedRole",
            "Resource": "arn:aws:iam::*:role/aws-service-role/health.amazonaws.com/AWSServiceRoleForHealth*"
        }
    ]
}

注意

如果您想要授予权限的用户或组已拥有 IAM policy，则可将特定于 AWS Health 的策略语句添加到该策略。

基于资源和基于操作的条件

AWS Health 支持 DescribeAffectedEntities 和 DescribeEventDetails API 操作的 IAM 条件。您可以使用基于资源和操作的条件来限制 AWS Health API 向用户、组或角色发送的事件。

为此，请更新 IAM policy 的 Condition 数据块或设置 Resource 元素。您可以使用字符串条件基于某些 AWS Health 事件字段来限制访问。

当在策略中指定 AWS Health 事件时，您可以使用以下字段：

eventTypeCode
service

注意

DescribeAffectedEntities 和 DescribeEventDetails API 操作支持资源级权限。例如，您可以创建策略，允许或拒绝特定 AWS Health 事件。
DescribeAffectedEntitiesForOrganization 和 DescribeEventDetailsForOrganization API 操作不支持资源级权限。
有关更多信息，请参阅服务授权参考中的 AWS Health APIs and Notifications 的操作、资源和条件键。

例：基于操作的条件

此策略语句授予对 AWS Health Dashboard 和 AWS Health Describe* API 操作的访问权限，但拒绝访问与 Amazon EC2 相关的任何 AWS Health 事件。


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "health:Describe*",
            "Resource": "*"
        },
        {
            "Effect": "Deny",
            "Action": [
                "health:DescribeAffectedEntities",
                "health:DescribeEventDetails"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "health:service": "EC2"
                }
            }
        }
    ]
}

例：基于资源的条件

以下策略具有相同的效果，但使用 Resource 元素。


{
  "Version": "2012-10-17",
  "Statement": [
  {
    "Effect": "Allow",
    "Action": [
      "health:Describe*"
    ],
    "Resource": "*"
  },
  {
    "Effect": "Deny",
    "Action": [
      "health:DescribeEventDetails",
      "health:DescribeAffectedEntities"
    ],
    "Resource": "arn:aws:health:*::event/EC2/*/*"
  }]
}

例：eventTypeCode 条件

此策略语句授予对 AWS Health Dashboard 和 AWS Health Describe* API 操作的访问权限，但拒绝访问 eventTypeCode 与 AWS_EC2_* 匹配的任何 AWS Health 事件。


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "health:Describe*",
            "Resource": "*"
        },
        {
            "Effect": "Deny",
            "Action": [
                "health:DescribeAffectedEntities",
                "health:DescribeEventDetails"
            ],
            "Resource": "*",
            "Condition": {
                "StringLike": {
                    "health:eventTypeCode": "AWS_EC2_*"
                }
            }
        }
    ]
}

重要

如果调用 DescribeAffectedEntities 和 DescribeEventDetails 操作但没有访问 AWS Health 事件的权限，则会出现 AccessDeniedException 错误。有关更多信息，请参阅对 AWS Health 身份和访问进行故障排除。

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

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

文档惯例

AWS Health 如何与 IAM 协同工作

故障排除