政策最佳實務使用主控台允許使用者檢視他們自己的許可執行文件分析動作所需的許可使用KMS加密所需的許可 AWS Amazon Comprehend 的受管（預先定義）政策非同步操作所需的角色型許可允許所有 Amazon Comprehend 動作的許可允許主題建模動作的許可自訂非同步分析任務所需的許可

Amazon Comprehend 的身分型政策範例

根據預設，使用者和角色沒有建立或修改 Amazon Comprehend 資源的許可。他們也無法使用 AWS Management Console、 AWS Command Line Interface （AWS CLI）或來執行任務 AWS API。若要授予使用者對所需資源執行動作的許可，IAM管理員可以建立IAM政策。然後，管理員可以將IAM政策新增至角色，使用者可以擔任角色。

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

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

政策最佳實務

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

開始使用 AWS 受管政策並邁向最低權限許可 – 若要開始將許可授予您的使用者和工作負載，請使用將許可授予許多常見使用案例的 AWS 受管政策。它們可在您的中使用 AWS 帳戶。建議您定義特定於使用案例 AWS 的客戶受管政策，以進一步減少許可。如需詳細資訊，請參閱 IAM 使用者指南 中的 AWS 受管政策或 AWS 任務功能的受管政策。
套用最低權限許可 – 當您使用IAM政策設定許可時，只會授予執行任務所需的許可。為實現此目的，您可以定義在特定條件下可以對特定資源採取的動作，這也稱為最低權限許可。如需使用 IAM 套用許可的詳細資訊，請參閱 IAM 使用者指南 中的政策和許可IAM。
使用IAM政策中的條件來進一步限制存取：您可以將條件新增至政策，以限制對動作和資源的存取。例如，您可以撰寫政策條件來指定所有請求都必須使用傳送SSL。如果透過特定使用服務動作，例如 AWS 服務，您也可以使用條件來授予存取服務動作的權限 AWS CloudFormation。如需詳細資訊，請參閱 IAM 使用者指南 中的IAMJSON政策元素：條件。
使用 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 使用者指南中的使用安全API存取MFA。

如需中最佳實務的詳細資訊IAM，請參閱 IAM 使用者指南 中的安全最佳實務IAM。

使用 Amazon Comprehend 主控台

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

對於僅對 AWS CLI 或進行呼叫的使用者，您不需要允許最低主控台許可 AWS API。相反地，僅允許存取與其嘗試執行API的操作相符的動作。

若要取得最低 Amazon Comprehend 主控台許可，您可以將ComprehendReadOnly AWS 受管政策連接至實體。如需詳細資訊，請參閱 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角色的許可。
s3 存取包含主題建模資料之 Amazon S3 儲存貯體和物件的許可。

當您使用主控台建立非同步批次任務或主題建模任務時，您可以選擇讓主控台為您的任務建立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 建立角色和政策以及連接角色和政策的許可。此iam:PassRole動作可讓主控台將角色傳遞至 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、DetectDominantLanguage、DetectTargetedSentiment、 DetectSentiment和 DetectSyntax動作的許可。政策陳述式也授予使用兩種 Amazon Textract API方法的許可。Amazon Comprehend 會呼叫這些方法來從映像檔案和掃描PDF文件擷取文字。對於從未針對這些類型的輸入檔案執行自訂推論的使用者，您可以移除這些許可。

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

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

如需顯示所有 Amazon Comprehend API動作及其適用的資源的資料表，請參閱服務授權參考 中的 Amazon Comprehend 的動作、資源和條件索引鍵。

使用KMS加密所需的許可

若要在非同步任務中完全使用 Amazon Key Management Service （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 Amazon Comprehend 的受管（預先定義）政策

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

下列 AWS 受管政策可連接至您帳戶中的使用者，其專屬於 Amazon Comprehend ：

ComprehendFullAccess – 授予 Amazon Comprehend 資源的完整存取權，包括執行主題建模任務。包括列出和取得IAM角色的許可。
ComprehendReadOnly – 准許執行除 StartDominantLanguageDetectionJob、StartEntitiesDetectionJob、StartKeyPhrasesDetectionJob、StartSentimentDetectionJob、 StartTargetedSentimentDetectionJob和以外的所有 Amazon Comprehend 動作StartTopicsDetectionJob。

您需要將下列其他政策套用至將要使用 Amazon Comprehend 的任何使用者：


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

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

當您使用 AWS SDKs 或時，這些政策會運作 AWS CLI。

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

非同步操作所需的角色型許可

若要使用 Amazon Comprehend 非同步操作，您必須授予 Amazon Comprehend 存取包含文件集合的 Amazon S3 儲存貯體。您可以透過在帳戶中建立資料存取角色，並使用信任政策來信任 Amazon Comprehend 服務主體來執行此操作。如需建立角色的詳細資訊，請參閱 AWS Identity 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和ListBucket許可授予包含您輸入資料的 Amazon S3 儲存貯體，以及將 Amazon S3 PutObject許可授予您的 Amazon S3 輸出資料儲存貯體。

允許所有 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 能夠分析存放在加密 S3 儲存貯體中的文件，IAM角色必須具有 kms:Decrypt許可。
若要讓 Amazon Comprehend 加密連接至處理分析任務之運算執行個體的儲存磁碟區上儲存的文件，該IAM角色必須具有 kms:CreateGrant 許可。
若要讓 Amazon Comprehend 加密其 S3 儲存貯體中的輸出結果，IAM角色必須具有 kms:GenerateDataKey許可。

允許主題建模動作的許可

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


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

自訂非同步分析任務所需的許可

重要

如果您有限制模型存取IAM的政策，您將無法使用自訂模型完成推論任務。您的IAM政策應更新為具有自訂非同步分析任務的萬用字元資源。

如果您使用的是 StartDocumentClassificationJob 和 StartEntitiesDetectionJob APIs，則需要更新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"
}

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

Amazon Comprehend 如何使用 IAM

AWS 受管政策