View a markdown version of this page

亚马逊 Textract Identity-Based 政策示例 - Amazon Textract
策略最佳实践允许用户查看他们自己的权限在 Amazon Textract 中提供同步操作的访问权限在 Amazon Textract 中提供异步操作的访问权限在 Amazon Textract 的推理操作中授予对特定适配器的访问权限禁止用户在推理操作中使用适配器允许用户在推理操作中仅使用一组特定的适配器，或者不使用适配器

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

亚马逊 Textract Identity-Based 政策示例

默认情况下，用户和角色无权创建或修改 Amazon Textract 资源。他们也无法使用 AWS 管理控制台 AWS CLI、或 AWS API 执行任务。管理员必须创建 IAM policy，以便为用户和角色授予权限以对所需的指定资源执行特定的 API 操作。然后，管理员通过临时安全证书向用户授予角色访问权限。

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

策略最佳实践

Identity-based 政策决定是否有人可以在您的账户中创建、访问或删除亚马逊 Textract 资源。这些操作可能会使 AWS 账户产生成本。创建或编辑基于身份的策略时，请遵循以下指南和建议：

  • 开始使用 AWS 托管策略并转向最低权限权限 — 要开始向用户和工作负载授权，请使用为许多常见用例授予权限的AWS 托管策略。它们可以在您的 AWS 账户. 我们建议您通过定义特定于您的用例的 AWS 客户管理策略来进一步减少权限。有关更多信息，请参阅《IAM 用户指南》中的 AWS 托管策略或工作职能的AWS 托管策略。

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

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

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

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

有关 IAM 中的最佳实操的更多信息，请参阅《IAM 用户指南》中的 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": "*"
        }
    ]
}

在 Amazon Textract 中提供同步操作的访问权限

此示例策略向您 AWS 账户中的 IAM 用户授予对 Amazon Textract 中同步操作的访问权限。

"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "textract:DetectDocumentText",
                "textract:AnalyzeDocument"
            ],
            "Resource": "*"
        }
    ]

在 Amazon Textract 中提供异步操作的访问权限

以下示例策略允许您 AWS 账户中的 IAM 用户访问在 Amazon Textract 中使用的所有异步操作。

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "textract:StartDocumentTextDetection",
                "textract:StartDocumentAnalysis",
                "textract:GetDocumentTextDetection",
                "textract:GetDocumentAnalysis"
            ],
            "Resource": "*"
        }
    ]
}

在 Amazon Textract 的推理操作中授予对特定适配器的访问权限

尽管您可以使用*来访问推理操作中的所有资源，但您可以控制用户对特定适配器的访问权限。

禁止用户在推理操作中使用适配器

允许用户在推理操作中仅使用一组特定的适配器，或者不使用适配器

使用TagResource操作标记要控制的特定适配器。以下示例控制对带有标签的适配器的访问权限{"env":"prod"}。

允许用户管理适配器和版本

所需的权限 CreateAdapterVersion

除"textract:CreateAdapterVersion"权限外，呼叫者身份还需要Amazon S3和 AWS Key Management Service (AWS KMS) 对您在Amazon S3中的训练数据以及用于加密数据的 KMS 密钥的权限。