本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# Amazon WorkMail 基于身份的政策示例
默认情况下，IAM 用户和角色无权创建或修改 Amazon WorkMail 资源。他们也无法使用 AWS 管理控制台 AWS CLI、或 AWS API 执行任务。IAM 管理员必须创建 IAM 策略，以便为用户和角色授予权限以对所需的指定资源执行特定的 API 操作。然后，管理员必须将这些策略附加到需要这些权限的 IAM 用户或组。
要了解如何使用这些示例 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)
+ [使用亚马逊 WorkMail 控制台](#security_iam_id-based-policy-examples-console)
+ [允许用户查看他们自己的权限](#security_iam_id-based-policy-examples-view-own-permissions)
+ [允许用户以只读方式访问 Amazon WorkMail 资源](#security_iam_id-based-policy-examples-read-only-access)
## 策略最佳实践
基于身份的策略决定了是否有人可以在您的账户中创建、访问或删除亚马逊 WorkMail 资源。这些操作可能会使 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)。
## 使用亚马逊 WorkMail 控制台
要访问 Amazon WorkMail 控制台，您必须拥有一组最低权限。这些权限必须允许您列出和查看有关您 AWS 账户中的 Amazon WorkMail 资源的详细信息。如果您创建的基于身份的策略比所需的最低权限更严格，则无法为具有该策略的实体（IAM 用户或角色）正常运行控制台。
为确保这些实体仍然可以使用 Amazon WorkMail 控制台，还需将以下 AWS 托管策略附加到这些实体。**AmazonWorkMailFullAccess**有关更多信息，请参阅《IAM 用户指南》**中的[为用户添加权限](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_change-permissions.html#users_change_permissions-add-console)。
该**AmazonWorkMailFullAccess**政策授予 IAM 用户对 Amazon WorkMail 资源的完全访问权限。该政策允许用户访问所有亚马逊 WorkMail AWS Key Management Service、、亚马逊简单电子邮件服务和 AWS Directory Service 操作。这还包括亚马逊 WorkMail 需要代表您执行的多项 Amazon EC2 操作。电子邮件事件记录`logs`和在 Amazon WorkMail 控制台中查看指标需要和`cloudwatch`权限。审计日志使用 CloudWatch 日志、Amazon S3 和亚马逊数据 FireHose 进行存储`logs`。有关更多信息，请参阅 [在 Amazon 中记录和监控 WorkMail](monitoring-overview.md)。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "WorkMailAdministration",
"Effect": "Allow",
"Action": [
"ds:AuthorizeApplication",
"ds:CheckAlias",
"ds:CreateAlias",
"ds:CreateDirectory",
"ds:CreateIdentityPoolDirectory",
"ds:DeleteDirectory",
"ds:DescribeDirectories",
"ds:GetDirectoryLimits",
"ds:ListAuthorizedApplications",
"ds:UnauthorizeApplication",
"ec2:AuthorizeSecurityGroupEgress",
"ec2:AuthorizeSecurityGroupIngress",
"ec2:CreateNetworkInterface",
"ec2:CreateSecurityGroup",
"ec2:CreateSubnet",
"ec2:CreateTags",
"ec2:CreateVpc",
"ec2:DeleteSecurityGroup",
"ec2:DeleteSubnet",
"ec2:DeleteVpc",
"ec2:DescribeAvailabilityZones",
"ec2:DescribeRouteTables",
"ec2:DescribeSubnets",
"ec2:DescribeVpcs",
"ec2:RevokeSecurityGroupEgress",
"ec2:RevokeSecurityGroupIngress",
"kms:DescribeKey",
"kms:ListAliases",
"lambda:ListFunctions",
"route53:ChangeResourceRecordSets",
"route53:ListHostedZones",
"route53:ListResourceRecordSets",
"route53:GetHostedZone",
"route53domains:CheckDomainAvailability",
"route53domains:ListDomains",
"ses:*",
"workmail:*",
"iam:ListRoles",
"logs:DescribeLogGroups",
"logs:CreateLogGroup",
"logs:PutRetentionPolicy",
"logs:DeleteDeliveryDestination",
"logs:DeleteDeliveryDestinationPolicy",
"logs:DescribeDeliveryDestinations",
"logs:GetDeliveryDestination",
"logs:GetDeliveryDestinationPolicy",
"logs:PutDeliveryDestination",
"logs:PutDeliveryDestinationPolicy",
"logs:CreateDelivery",
"logs:DeleteDelivery",
"logs:DescribeDeliveries",
"logs:GetDelivery",
"logs:DeleteDeliverySource",
"logs:DescribeDeliverySources",
"logs:GetDeliverySource",
"logs:PutDeliverySource",
"logs:DescribeResourcePolicies",
"cloudwatch:GetMetricData",
"firehose:DescribeDeliveryStream",
"firehose:ListDeliveryStreams",
"s3:ListAllMyBuckets"
],
"Resource": "*"
},
{
"Sid": "AuditLogDeliveryThroughCWLogs",
"Effect": "Allow",
"Action": [
"firehose:TagDeliveryStream",
"logs:PutResourcePolicy",
"s3:GetBucketPolicy",
"s3:PutBucketPolicy"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:CalledViaLast": "logs.amazonaws.com"
}
}
},
{
"Sid": "InboundOutboundEmailEventsLink",
"Effect": "Allow",
"Action": "iam:CreateServiceLinkedRole",
"Resource": "*",
"Condition": {
"StringEquals": {
"iam:AWSServiceName": "events.workmail.amazonaws.com"
}
}
},
{
"Sid": "AuditLoggingLink",
"Effect": "Allow",
"Action": "iam:CreateServiceLinkedRole",
"Resource": "*",
"Condition": {
"StringEquals": {
"iam:AWSServiceName": "delivery.logs.amazonaws.com"
}
}
},
{
"Sid": "InboundOutboundEmailEventsUnlink",
"Effect": "Allow",
"Action": [
"iam:DeleteServiceLinkedRole",
"iam:GetServiceLinkedRoleDeletionStatus"
],
"Resource": "arn:aws:iam::*:role/aws-service-role/events.workmail.amazonaws.com/AWSServiceRoleForAmazonWorkMailEvents*"
},
{
"Sid": "InboundOutboundEmailEventsAuth",
"Effect": "Allow",
"Action": "iam:PassRole",
"Resource": "arn:aws:iam::*:role/*workmail*",
"Condition": {
"StringLike": {
"iam:PassedToService": "events.workmail.amazonaws.com"
}
}
}
]
}
```
------
对于仅调用 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": "*"
}
]
}
```
## 允许用户以只读方式访问 Amazon WorkMail 资源
以下政策声明向 IAM 用户授予对 Amazon WorkMail 资源的只读访问权限。此策略提供的访问权限级别与 AWS 托管策略相同**AmazonWorkMailReadOnlyAccess**。这两种策略都允许用户访问所有 Amazon WorkMail `Describe` 业务。需要访问该 AWS Directory Service `DescribeDirectories`操作才能获取有关您的 Directory Service 目录的信息。需要 Amazon SES 服务的访问权限才能获取有关已配置域的信息。需要访问才能 AWS Key Management Service 获得有关所用加密密钥的信息。`logs`和`cloudwatch`权限是电子邮件事件记录和在 Amazon WorkMail 控制台中查看指标所必需的。审计日志使用 CloudWatch 日志、Amazon S3 和亚马逊数据 FireHose 进行存储`logs`。有关更多信息，请参阅 [在 Amazon 中记录和监控 WorkMail](monitoring-overview.md)。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "WorkMailReadOnly",
"Effect": "Allow",
"Action": [
"ses:Describe*",
"ses:Get*",
"workmail:Describe*",
"workmail:Get*",
"workmail:List*",
"workmail:Search*",
"lambda:ListFunctions",
"iam:ListRoles",
"logs:DescribeLogGroups",
"logs:DescribeDeliveryDestinations",
"logs:GetDeliveryDestination",
"logs:GetDeliveryDestinationPolicy",
"logs:DescribeDeliveries",
"logs:DescribeDeliverySources",
"logs:GetDelivery",
"logs:GetDeliverySource",
"cloudwatch:GetMetricData"
],
"Resource": "*"
}
]
}
```
------