本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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 帳戶 產生費用。當您建立或編輯身分型政策時,請遵循下列準則及建議事項:
-
開始使用 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 最佳安全實務。
使用 Amazon Comprehend 制台
若要存取 Amazon Comprehend 主控台,您必須擁有一組最低限度的許可。這些許可必須允許您列 Amazon Comprehend 和檢視您的. AWS 帳戶 如果您建立比最基本必要許可更嚴格的身分型政策,則對於具有該政策的實體 ( 使用者或角色) 而言,主控台就無法如預期運作。
對於僅呼叫 AWS CLI 或 AWS API 的使用者,您不需要允許其最基本主控台許可。反之,只需允許存取符合他們嘗試執行之 API 操作的動作就可以了。
對於 Amazon Comprehend 主控台的最低許可,您可以將
AWS受管政策附加到實體。如需詳細資訊,請參閱《IAM 使用者指南》中的新增許可到使用者。ComprehendReadOnly
若要使用 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 金鑰管理服務 (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 特有的:
-
ComprehendFullAccess— 授予對 Amazon Comprehend 資源的完整存取權,包括執行主題建模任務。包括列出和取得 IAM 角色的權限。
-
ComprehendReadOnly— 授予執行除
StartDominantLanguageDetectionJob
、StartEntitiesDetectionJob
、、和之外的所有 Amazon Comprehend 動作的權StartSentimentDetectionJob
限StartTargetedSentimentDetectionJob
。StartKeyPhrasesDetectionJob
StartTopicsDetectionJob
您必須將下列額外政策套用至將使用 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 能夠分析存放在加密 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 和 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" }