本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Amazon Transcribe 身分型政策範例
根據預設，使用者和角色不具備建立或修改 Amazon Transcribe 資源的權限。若要授予使用者對其所需資源執行動作的許可，IAM 管理員可以建立 IAM 政策。
如需了解如何使用這些範例 JSON 政策文件建立 IAM 身分型政策，請參閱《*IAM 使用者指南*》中的[建立 IAM 政策 (主控台)](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create-console.html)。
如需 Amazon Transcribe 所定義之動作和資源類型的詳細資訊，包括每種資源類型的 ARN 格式，請參閱《服務授權參考》**中的[適用於 Amazon Transcribe 的動作、資源和條件索引鍵](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazontranscribe.html)。
**Topics**
+ [政策最佳實務](#security_iam_service-with-iam-policy-best-practices)
+ [使用 AWS 管理主控台](#security_iam_id-based-policy-examples-console)
+ [IAM 角色所需的許可](#auth-role-iam-user)
+ [Amazon S3 加密金鑰所需的許可](#auth-role-kms-key)
+ [允許使用者檢視他們自己的許可](#security_iam_id-based-policy-examples-view-own-permissions)
+ [AWS KMS 加密內容政策](#kms-context-policy)
+ [預防混淆代理人政策](#confused-deputy-policy)
+ [根據標籤檢視轉錄作業](#tagging-transcription-policy)
## 政策最佳實務
身分型政策會判斷您帳戶中的某個人員是否可以建立、存取或刪除 Amazon Transcribe 資源。這些動作可能會讓您的 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)** – 如果您的案例需要 IAM 使用者或 中的根使用者 AWS 帳戶，請開啟 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)。
## 使用 AWS 管理主控台
若要存取 Amazon Transcribe 主控台，您必須擁有最基本的一組許可。這些許可必須允許您列出和檢視 中 Amazon Transcribe 資源的詳細資訊 AWS 帳戶。如果您建立比最基本必要許可更嚴格的身分型政策，則對於具有該政策的實體 (使用者或角色) 而言，主控台就無法如預期運作。
對於僅呼叫 AWS CLI 或 AWS API 的使用者，您不需要允許最低主控台許可。反之，只需允許存取符合他們嘗試執行之 API 操作的動作就可以了。
為了確保實體 （使用者和角色） 可以使用 [AWS 管理主控台](https://console.aws.amazon.com/transcribe/)，請將下列其中一個 AWS受管政策連接到它們。
+ `AmazonTranscribeFullAccess`：授予建立、讀取、更新、刪除和執行所有 Amazon Transcribe 資源的完整存取權。它也允許存取儲存貯體名稱包含 `transcribe` 的 Amazon S3 儲存貯體。
+ `AmazonTranscribeReadOnlyAccess`：授與 Amazon Transcribe 資源唯讀存取權限，讓您可以取得並列出轉錄作業和自訂詞彙。
**注意**
您可以檢閱受管授權政策，只要登入 IAM AWS 管理主控台 ，並使用政策名稱進行搜尋。搜尋「轉錄」傳回上述列出的兩個政策 (*AmazonTranscribeReadOnly* 和 *AmazonTranscribeFullAccess*)。
您也可以建立自己的自訂 IAM 政策，以允許 Amazon Transcribe API 動作的許可。您可以將這些自訂政策連接至需要指定授權的實體。
## IAM 角色所需的許可
如果您建立要呼叫 IAM 的角色 Amazon Transcribe，它必須具有存取儲存 Amazon S3 貯體的許可。如果適用，也 KMS key 必須使用以加密儲存貯體的內容。請參考下列章節的範例政策。
### 信任政策
您用來提出轉錄請求的 IAM 實體必須具有信任政策，讓 Amazon Transcribe 能夠擔任該角色。使用下列 Amazon Transcribe 信任政策。請注意，如果您在啟用通話後分析的情況下提出即時通話分析要求，則必須使用「即時通話分析的信任政策」。
**的信任政策 Amazon Transcribe**
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": [
"transcribe.amazonaws.com"
]
},
"Action": [
"sts:AssumeRole"
],
"Condition": {
"StringEquals": {
"aws:SourceAccount": "111122223333"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:transcribe:us-west-2:111122223333:*"
}
}
}
]
}
```
------
**即時通話分析的信任政策**
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": [
"transcribe.streaming.amazonaws.com"
]
},
"Action": [
"sts:AssumeRole"
],
"Condition": {
"StringEquals": {
"aws:SourceAccount": "111122223333"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:transcribe:us-west-2:111122223333:*"
}
}
}
]
}
```
------
### Amazon S3 輸入儲存貯體政策
下列政策提供 IAM 角色從指定輸入儲存貯體存取檔案的許可。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::DOC-EXAMPLE-INPUT-BUCKET",
"arn:aws:s3:::DOC-EXAMPLE-INPUT-BUCKET/*"
]
}
}
```
------
### Amazon S3 輸出儲存貯體政策
下列政策提供 IAM 角色將檔案寫入指定輸出儲存貯體的許可。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Action": [
"s3:PutObject"
],
"Resource": [
"arn:aws:s3:::DOC-EXAMPLE-OUTPUT-BUCKET/*"
]
}
}
```
------
## Amazon S3 加密金鑰所需的許可
如果您使用 KMS key 來加密 儲存 Amazon S3 貯體，請在 KMS key 政策中包含下列項目。這可讓您 Amazon Transcribe 存取儲存貯體的內容。如需允許存取 的詳細資訊 KMS keys，請參閱《 *AWS KMS 開發人員指南*》中的[允許外部 AWS 帳戶 存取 KMS key](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying.html#key-policy-modifying-external-accounts)。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::111122223333:role/ExampleRole"
},
"Action": [
"kms:Decrypt"
],
"Resource": "arn:aws:kms:us-west-2:111122223333:key/KMS-Example-KeyId"
}
]
}
```
------
## 允許使用者檢視他們自己的許可
此範例會示範如何建立政策，允許 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": "*"
}
]
}
```
## AWS KMS 加密內容政策
下列政策會授予 IAM 角色「`ExampleRole`」許可，以針對此特定使用 AWS KMS *解密*和*加密*操作 KMS key。此原則**僅**適用於至少具有一個加密內容配對的要求，在本例中為「`color:indigoBlue`」。如需 AWS KMS 加密內容的詳細資訊，請參閱 [AWS KMS加密內容](data-encryption.md#kms-context)。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::111122223333:role/ExampleRole"
},
"Action": [
"kms:Decrypt",
"kms:Encrypt",
"kms:GenerateDataKey*",
"kms:ReEncrypt*"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"kms:EncryptionContext:color": "indigoBlue"
}
}
},
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::111122223333:role/ExampleRole"
},
"Action": "kms:DescribeKey",
"Resource": "*"
}
]
}
```
------
## 預防混淆代理人政策
以下是擔任角色政策的範例，示範如何使用 `aws:SourceArn`和 `aws:SourceAccount` Amazon Transcribe 來防止混淆代理人問題。如需防止混淆代理人的詳細資訊，請參閱 [預防跨服務混淆代理人](security-iam-confused-deputy.md)。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "transcribe.amazonaws.com"
},
"Action": [
"sts:AssumeRole"
],
"Condition": {
"StringEquals": {
"aws:SourceAccount": "111122223333"
},
"ArnLike": {
"aws:SourceArn": "arn:aws:transcribe:us-west-2:111122223333:*"
}
}
}
]
}
```
------
## 根據標籤檢視轉錄作業
您可以在身分型政策中使用條件，以根據標籤控制存取 Amazon Transcribe 資源。此範例會示範如何建立政策，允許檢視轉錄作業 。但是，只有在轉錄作業標籤 `Owner` 的值是該使用者的使用者名稱時，才會授予該權限。此政策也會使用 AWS 管理主控台，授予完成此動作的必要權限。
您可以將此政策連接至您帳戶中的 IAM 實體。如果名為 `test-role` 的角色嘗試檢視轉錄作業，則轉錄作業必須加上標籤 `Owner=test-role` 或 `owner=test-role`(條件索引鍵名稱不區分大小寫)，否則會拒絕存取。如需詳細資訊，請參閱《IAM 使用者指南》**中的 [IAM JSON 政策元素：條件](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html)。
如需在 中標記的詳細資訊 Amazon Transcribe，請參閱 [標記 資源](tagging.md)。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "ListTranscriptionJobsInConsole",
"Effect": "Allow",
"Action": "transcribe:ListTranscriptionJobs",
"Resource": "*"
},
{
"Sid": "ViewTranscriptionJobsIfOwner",
"Effect": "Allow",
"Action": "transcribe:GetTranscriptionJob",
"Resource": "arn:aws:transcribe:us-west-2:111122223333:transcription-job/*",
"Condition": {
"StringEquals": {"aws:ResourceTag/Owner": "${aws:username}"}
}
}
]
}
```
------