Amazon Transcribe 身分型政策範例 - Amazon Transcribe
政策最佳實務使用 AWS Management ConsoleIAM角色所需的許可Amazon S3加密金鑰所需的權限允許使用者檢視他們自己的許可AWS KMS加密內容政策預防政策混淆代理人根據標籤檢視轉錄任務

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

Amazon Transcribe 身分型政策範例

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

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

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

政策最佳實務

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

  • 開始使用 AWS 受管政策並朝向最低權限許可的目標邁進 – 若要開始授予許可給使用者和工作負載，請使用 AWS 受管政策，這些政策會授予許可給許多常用案例。它們可在您的 AWS 帳戶 中使用。我們建議您定義特定於使用案例的 AWS 客戶管理政策，以便進一步減少許可。如需詳細資訊，請參閱 IAM 使用者指南中的 AWS 受管政策或任務職能的 AWS 受管政策。

  • 套用最低權限許可 – 設定 IAM 政策的許可時，請僅授予執行任務所需的許可。為實現此目的，您可以定義在特定條件下可以對特定資源採取的動作，這也稱為最低權限許可。如需使用 IAM 套用許可的詳細資訊，請參閱 IAM 使用者指南中的 IAM 中的政策和許可。

  • 使用 IAM 政策中的條件進一步限制存取權 – 您可以將條件新增至政策，以限制動作和資源的存取。例如，您可以撰寫政策條件，指定必須使用 SSL 傳送所有請求。您也可以使用條件來授予對服務動作的存取權，前提是透過特定 AWS service (例如 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 安全最佳實務。

使用 AWS Management Console

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

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

若要確保實體 (使用者和角色) 可以使用 AWS Management Console，請將下列其中一個AWS受管理的原則附加至這些實體。

  • AmazonTranscribeFullAccess：授予建立、讀取、更新、刪除和執行所有Amazon Transcribe資源的完整存取權。它還允許訪問存Amazon S3儲桶名稱transcribe中的存儲桶。

  • AmazonTranscribeReadOnlyAccess：授予Amazon Transcribe資源的唯讀存取權，以便您取得和列出轉錄工作和自訂字彙。

注意

您可以登入政策名稱IAMAWS Management Console並搜尋政策名稱，來檢閱受管許可政策政策範例。搜尋「轉錄」會傳回上述 (AmazonTranscribeReadOnly和 AmazonTranscribeFullAccess) 兩個政策。

您也可以建立自訂 IAM 政策，授予執行 Amazon Transcribe API 動作的相關許可。您可以將這些自訂政策連接至需要這些許可的實體。

IAM角色所需的許可

如果您建立要呼叫的IAM角色Amazon Transcribe，則該角色必須具有存取Amazon S3值區的權限。如果適用，也KMS key必須使用來加密值區的內容。如需政策範例，請參閱下列各節範例。

信任政策

您用來提出轉錄要求的IAM實體必須具有信任原則，Amazon Transcribe才能擔任該角色。請使用下列Amazon Transcribe信任政策。請注意，如果您在啟用通話後分析的情況下提出即時通話分析要求，則必須使用「即時通話分析的信任政策」。

信任政策Amazon Transcribe

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": [
          "transcribe.amazonaws.com"
        ]
      },
      "Action": [
        "sts:AssumeRole"
      ],      
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "111122223333"
        },
        "StringLike": {
          "aws:SourceArn": "arn:aws:transcribe:us-west-2:111122223333:*"
        }
      }
    }
  ]
}

即時通話分析的信任政策

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": [
          "transcribe.streaming.amazonaws.com"
        ]
      },
      "Action": [
        "sts:AssumeRole"
      ],      
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "111122223333"
        },
        "StringLike": {
          "aws:SourceArn": "arn:aws:transcribe:us-west-2:111122223333:*"
        }
      }
    }
  ]
}

Amazon S3輸入桶政策

下列原則授予IAM角色存取指定輸入值區中檔案的權限。

{
    "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角色權限，可將檔案寫入指定的輸出值區。

{
    "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開發人員指南KMS key中的允許外部AWS 帳戶存取。

{
  "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 加密內容。

{
  "Version": "2012-10-17",
  "Statement": [
      {
          "Effect": "Allow",
          "Principal": {
              "AWS": "arn:aws:iam::111122223333:role/ExampleRole"
          },
          "Action": [
              "kms:Decrypt",
              "kms:DescribeKey",
              "kms:Encrypt",
              "kms:GenerateDataKey*",
              "kms:ReEncrypt*"
          ],
          "Resource": "*",
          "Condition": {
              "StringEquals": {
                  "kms:EncryptionContext:color":"indigoBlue"
              }
           }
        }
   ]
}

預防政策混淆代理人

以下是假設角色原則的範例，其中顯示如何使用aws:SourceArn和使aws:SourceAccount用Amazon Transcribe來防止混淆的副問題。有關混淆副預防的更多信息，請參閱預防跨服務混淆代理人。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "transcribe.amazonaws.com"
      },
      "Action": [
        "sts:AssumeRole",
      ],
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "111122223333"
        },
        "StringLike": {
          "aws:SourceArn": "arn:aws:transcribe:us-west-2:111122223333:*"
        }
      }
    }
  ]
}

根據標籤檢視轉錄任務

您可以在身分型政策中使用條件，來根據標籤控制存取 Amazon Transcribe 資源。此範例會示範範範範範範範範例會示範範範範範範例建立政策範例，示範範範例 不過，只有在轉錄作業標籤Owner具有該使用者的使用者名稱值時，才會授予許可。此政策也會授予使用完成此動作的必要許可AWS Management Console。

您可以將此政策連接至您帳戶中的IAM實體。如果名為的角色test-role嘗試檢視轉錄工作，則轉錄工作必須加上標籤Owner=test-role或owner=test-role (條件索引鍵名稱不區分大小寫)，否則會拒絕存取。如需詳細資訊，請參閱《IAM使用者指南》中的 IAMJSON 政策元素：條件。

若要取得有關中標籤的更多資訊Amazon Transcribe，請參閱標記 資源。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "ListTranscriptionJobsInConsole",
            "Effect": "Allow",
            "Action": "transcribe:ListTranscriptionJobs",
            "Resource": "*"
        },
        {
            "Sid": "ViewTranscriptionJobsIfOwner",
            "Effect": "Allow",
            "Action": "transcribe:GetTranscriptionJobs",
            "Resource": "arn:aws:transcribe:*:*:transcription-job/*",
            "Condition": {
                "StringEquals": {"aws:ResourceTag/Owner": "${aws:username}"}
            }
        }
    ]
}