本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Amazon Comprehend 基於身份的政策示例

依預設，使用者和角色沒有建立或修改 Amazon Comprehend 資源的權限。他們也無法使用 AWS Management Console、AWS Command Line Interface (AWS CLI) 或 AWS API 執行任務。若要授與使用者對其所需資源執行動作的許可，IAM 管理員可以建立 IAM 政策。然後，管理員可以將 IAM 政策新增至角色，使用者便能擔任這些角色。

若要了解如何使用這些範例 JSON 政策文件建立 IAM 身分型政策，請參閱《IAM 使用者指南》中的建立 IAM 政策。

如需 Amazon Comprehend 定義的動作和資源類型的詳細資訊，包括每個資源類型的 ARN 格式，請參閱服務授權參考中的 Amazon Comprehend 的動作、資源和條件金鑰。

政策最佳實務

以身分識別為基礎的政策可決定某人是否可以在您的帳戶中建立、存取或刪除 Amazon Comprehend 資源。這些動作可能會讓您的 AWS 帳戶 產生費用。當您建立或編輯身分型政策時，請遵循下列準則及建議事項：

有關 IAM 中最佳實務的更多相關資訊，請參閱 IAM 使用者指南中的 IAM 最佳安全實務。

使用 Amazon Comprehend 制台

若要存取 Amazon Comprehend 主控台，您必須擁有一組最低限度的許可。這些許可必須允許您列 Amazon Comprehend 和檢視您的. AWS 帳戶 如果您建立比最基本必要許可更嚴格的身分型政策，則對於具有該政策的實體 ( 使用者或角色) 而言，主控台就無法如預期運作。

對於僅呼叫 AWS CLI 或 AWS API 的使用者，您不需要允許其最基本主控台許可。反之，只需允許存取符合他們嘗試執行之 API 操作的動作就可以了。

對於 Amazon Comprehend 主控台的最低許可，您可以將ComprehendReadOnlyAWS受管政策附加到實體。如需詳細資訊，請參閱《IAM 使用者指南》中的新增許可到使用者。

若要使用 Amazon Comprehend 主控台，您還需要下列政策所示動作的許可：

{
  "Version": "2012-10-17",
  "Statement": [
  {
      "Action": [
          "iam:ListRoles",
          "iam:GetRole",
          "s3:ListAllMyBuckets",
          "s3:ListBucket",
          "s3:GetBucketLocation"
      ],
      "Effect": "Allow",
      "Resource": "*"
  }
  ]
  }

Amazon Comprehend 台需要這些額外的許可，原因如下：

使用主控台建立非同步批次任務或主題建模工作時，您可以選擇讓主控台為您的工作建立 IAM 角色。若要建立 IAM 角色，使用者必須獲得下列其他許可，才能建立 IAM 角色和政策，以及將政策附加到角色：

{
  "Version": "2012-10-17",
  "Statement":
    [
      {
        "Action":
          [
          "iam:CreateRole",
          "iam:CreatePolicy",
          "iam:AttachRolePolicy"
          ],
        "Effect": "Allow",
        "Resource": "*"
      },
      {
        "Action":
          [
          "iam:PassRole"
          ],
        "Effect": "Allow",
        "Resource": "arn:aws:iam::*:role/*Comprehend*"
      }
    ]
  }

Amazon Comprehend 台需要這些額外的許可，原因如下：

允許使用者檢視他們自己的許可

此範例會示範如何建立政策，允許 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 Comprehend 文件分析動作的許可：

{
 "Version": "2012-10-17",
 "Statement": [{
    "Sid": "AllowDetectActions",
    "Effect": "Allow",
    "Action": [
              "comprehend:DetectEntities",
              "comprehend:DetectKeyPhrases",
              "comprehend:DetectDominantLanguage",
              "comprehend:DetectSentiment",
              "comprehend:DetectTargetedSentiment",
              "comprehend:DetectSyntax",
              "textract:DetectDocumentText",
              "textract:AnalyzeDocument"
           ],
    "Resource": "*"
    }
 ]
}
    

該政策具有一個聲明，授予使用DetectEntities、DetectKeyPhrases、DetectDominantLanguageDetectTargetedSentimentDetectSentiment、和DetectSyntax動作的權限。該政策聲明還授予使用兩種 Amazon Textract API 方法的許可。Amazon Comprehend 調用這些方法從圖像文件和掃描的 PDF 文檔中提取文本。您可以為從未針對這些類型的輸入檔案執行自訂推論的使用者移除這些權限。

具有此政策的使用者將無法在您的帳戶中執行批次處理動作或非同步動作。

此政策不指定 Principal 元素，因為您不會在以身分為基礎的政策中，指定取得許可的委託人。當您將政策連接至使用者時，這名使用者是隱含委託人。當您將許可政策連接至 IAM 角色，該角色的信任政策中所識別的委託人即取得許可。

如需顯示所有 Amazon Comprehend API 動作及其套用到的資源的表格，請參閱服務授權參考中適用於 Amazon Comprehend 的動作、資源和條件金鑰。

使用 KMS 加密所需的權限

若要在非同步任務中完全使用 Amazon 金鑰管理服務 (KMS) 進行資料和任務加密，您需要授與下列政策中顯示的動作的許可：

{
  "Version": "2012-10-17",
  "Statement": [
    {
        "Action": [
            "kms:CreateGrant"
        ],
        "Effect": "Allow",
        "Resource": "*"
    },
    {
        "Action": [
            "kms:Decrypt",
            "kms:GenerateDatakey"
        ],
        "Effect": "Allow",
        "Resource": "*",
        "Condition": {
            "StringEquals": {
                "kms:ViaService": [
                    "s3.region.amazonaws.com"
                ]
            }
        }
    }
  ]
}       

當您使用 Amazon Comprehend 建立非同步任務時，您可以使用存放在 Amazon S3 上的輸入資料。使用 S3 時，您可以選擇加密儲存的資料，這些資料是由 S3 加密，而不是由 Amazon Comprehend 加密。如果您提供將原始輸入資料加密到 Amazon Comprehend 任務所使用之資料存取角色的金鑰的kms:Decrypt權限，我們就可以解密和讀取該加密的輸入資料。

您也可以選擇使用 KMS 客戶管理金鑰 (CMK) 來加密 S3 上的輸出結果，以及任務處理期間使用的儲存磁碟區。執行此操作時，您可以對這兩種類型的加密使用相同的 KMS 金鑰，但這不是必要的。建立工作以指定用於輸出加密和磁碟區加密的金鑰時，會有不同的欄位可供使用，您甚至可以使用不同帳戶的 KMS 金鑰。

使用 KMS 加密時，需要kms:CreateGrant權限才能進行磁碟區加密，輸出資料加密需要kms:GenerateDataKey權限。對於讀取加密的輸入 (就像輸入資料已由 Amazon S3 加密時一樣)，需要kms:Decrypt許可。IAM 角色需要視需要授予這些許可。但是，如果金鑰來自與目前使用中不同的帳戶，則該 kms 金鑰的 KMS 金鑰原則也必須將這些權限授與工作的資料存取角色。

AWS亞馬遜管理 (預先定義) 政策

AWS 透過提供獨立的 IAM 政策來解決許多常用案例，這些政策由 AWS 所建立與管理。這些 AWS 受管政策授予常見使用案例的必要許可，讓您免於查詢需要哪些許可。如需詳細資訊，請參閱《IAM 使用者指南》中的 AWS 受管政策。

下列AWS受管政策 (您可以附加到帳戶中的使用者) 是 Amazon Comprehend 特有的：

您必須將下列額外政策套用至將使用 Amazon Comprehend 的任何使用者：

{
    "Version": "2012-10-17",
    "Statement":
      [
        {
          "Action":
            [
              "iam:PassRole"
            ],
          "Effect": "Allow",
          "Resource": "arn:aws:iam::*:role/*Comprehend*"
        }
      ]
  }

您可以登入 IAM 主控台並在該處搜尋特定政策，以檢閱受管許可政策。

當您使用 AWS SDK 或 AWS CLI 時，這些原則會運作。

您也可以建立自己的自訂 IAM 政策，以允許 Amazon Comprehend 動作和資源的許可。您可以將這些自訂原則附加到需要這些權限的使用者、群組或角色。

非同步作業所需的角色型權限

若要使用 Amazon Comprehend 非同步操作，您必須授與 Amazon Comprehend 存取權限，以存取包含您的文件收集的 Amazon S3 儲存貯體。您可以透過信任政策在帳戶中建立資料存取角色，以信任 Amazon Comprehend 服務主體來達到此目的。如需有關建立角色的詳細資訊，請參閱《AWSIdentity and Access Management 使用者指南》中的建立角色以將權限委派給AWS服務。

以下顯示您建立之角色的信任原則範例。若要協助避免混淆的副手，您可以使用一或多個全域條件內容索引鍵來限制權限範圍。將 aws:SourceAccount 值設定為您的帳戶 ID。如果您使用ArnEquals條件，請將aws:SourceArn值設定為工作的 ARN。使用萬用字元作為 ARN 中的任務編號，因為 Amazon Comprehend 會在任務建立過程中產生此號碼。

{
    "Version": "2012-10-17",
    "Statement": [
      {
        "Effect": "Allow",
        "Principal": {
          "Service": "comprehend.amazonaws.com"
        },
        "Action": "sts:AssumeRole",
        "Condition": {
          "StringEquals": {
            "aws:SourceAccount": "111122223333"
          },
          "ArnEquals": {
            "aws:SourceArn": "arn:aws:comprehend:us-west-2:111122223333:pii-entities-detection-job/*"
          }
        }
      }
    ]
 }

建立角色之後，請為該角色建立存取原則。這應該將 Amazon S3 GetObject 和PutObject許可授予包含您輸入資料的 Amazon S3 儲存貯體，以及 Amazon S3 輸出資料儲存貯體的ListBucket權限。

允許所有 Amazon Comprehend 動作的許可

註冊後AWS，您可以建立管理員使用者來管理您的帳戶，包括建立使用者和管理其權限。

您可以選擇建立具有所有 Amazon Comprehend 動作許可的使用者 (將此使用者視為服務特定的管理員)，以便與 Amazon Comprehend 合作。您可以將以下許可政策附加到此使用者。

{
  "Version": "2012-10-17",
  "Statement":
    [
      {
        "Sid": "AllowAllComprehendActions",
        "Effect": "Allow",
        "Action":
        [
            "comprehend:*",
            "iam:ListRoles",
            "iam:GetRole",
            "s3:ListAllMyBuckets",
            "s3:ListBucket",
            "s3:GetBucketLocation",
            "iam:CreateRole",
            "iam:CreatePolicy",
            "iam:AttachRolePolicy",
            "kms:CreateGrant",
            "kms:Decrypt",
            "kms:GenerateDatakey"
      ],
      "Resource": "*"
    },
    {
      "Action":
        [
          "iam:PassRole"
        ],
      "Effect": "Allow",
      "Resource": "arn:aws:iam::*:role/*Comprehend*"
    }
  ]
}

您可以透過下列方式修改這些加密權限：

允許主題建模動作的權限

下列許可政策授予使用者執行 Amazon Comprehend 主題建模操作的許可。

{
  "Version": "2012-10-17",
  "Statement": [{
  "Sid": "AllowTopicModelingActions",
  "Effect": "Allow",
  "Action": [
            "comprehend:DescribeTopicsDetectionJob",
            "comprehend:ListTopicsDetectionJobs",
            "comprehend:StartTopicsDetectionJob",
         ],
        "Resource": "*"
        ]
    }
  ]
  }

自訂非同步分析工作所需的權限

如果您使用StartDocumentClassificationJob 和 StartEntitiesDetectionJobAPI，則必須更新 IAM 政策，除非您目前使用萬用字元做為資源。如果您使用的是預先訓練的模型，則不會影響您，也不需要進行任何變更。StartEntitiesDetectionJob

下列範例原則包含過期的參照。

{
    "Action": [
        "comprehend:StartDocumentClassificationJob",
        "comprehend:StartEntitiesDetectionJob",
    ],
    "Resource": [
        "arn:aws:comprehend:us-east-1:123456789012:document-classifier/myClassifier",
        "arn:aws:comprehend:us-east-1:123456789012:entity-recognizer/myRecognizer"
    ],
    "Effect": "Allow"
}

這是您需要用來成功執行 StartDocumentClassificationJob 和的更新原則。 StartEntitiesDetectionJob

{
    "Action": [
        "comprehend:StartDocumentClassificationJob",
        "comprehend:StartEntitiesDetectionJob",
    ],
    "Resource": [
        "arn:aws:comprehend:us-east-1:123456789012:document-classifier/myClassifier",
        "arn:aws:comprehend:us-east-1:123456789012:document-classification-job/*",
        "arn:aws:comprehend:us-east-1:123456789012:entity-recognizer/myRecognizer",
        "arn:aws:comprehend:us-east-1:123456789012:entities-detection-job/*"
    ],
    "Effect": "Allow"
}