Amazon Translate 的身分型政策範例

根據預設，使用者和角色沒有建立或修改 Amazon Translate 資源的許可。他們也無法使用 AWS Management Console AWS CLI、 或 執行任務 AWS API。IAM 管理員必須建立IAM政策，授予許可，以對他們所需的特定資源執行特定API操作。管理員接著必須將這些政策連接至需要這些許可的 使用者或角色。

若要了解如何使用下列範例政策文件建立身分IAM型JSON政策，請參閱 IAM 使用者指南 中的在 JSON索引標籤上建立政策。

身分型政策最佳實務

身分型政策會決定某人是否可以在帳戶中建立、存取或刪除 Amazon Translate 資源。這些動作可能會讓您的 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 Translate 主控台

若要存取 Amazon Translate 主控台，您必須具有一組最低許可。這些許可必須允許您列出和檢視 AWS 帳戶中 Amazon Translate 資源的詳細資訊。如果您建立的身分型政策比最低必要許可更嚴格，則主控台將無法使用該政策對實體 （使用者、群組或角色） 發揮預期作用。

對於 Amazon Translate 主控台許可，您可以將TranslateFullAccess AWS 受管政策連接至實體。如需詳細資訊，請參閱AWS Amazon Translate 的 受管政策。

您也需要下列政策中所示動作的許可。這些許可包含在TranslateFullAccess政策中。

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

        }
    ]
}

對於僅對 AWS CLI 或 進行呼叫的使用者，您不需要允許最低主控台許可 AWS API。相反地，僅允許存取與其API嘗試執行的操作相符的動作。如需詳細資訊，請參閱 使用者指南 中的將許可新增至使用者。 IAM

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

此範例示範如何建立政策，允許使用者檢視連接至其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 Translate API動作，您可以透過指定動作允許 （或不允許） 的資源來限制政策的範圍。如需可指定資源的動作清單，請參閱 Amazon Translate 定義的動作。您可以在政策中指定下列資源：

• Custom terminology – 使用下列ARN格式：

  arn:partition:translate:region:account:terminology/terminology-name/LATEST

• Parallel data – 使用下列ARN格式：

  arn:partition:translate:region:account:parallel-data/parallel-data-name

您可以使用萬用字元在政策中指定多個資源。下列範例政策允許所有 Amazon Translate 動作的所有自訂術語資源。

{
        "Sid": "Example1",
        "Effect": "Allow",
        "Action": "translate:*",
        "Resource": [
             "arn:aws:translate:us-west-2:123456789012:terminology/*"
        ]
}          

下列範例政策拒絕存取GetParallelData動作的特定平行資料資源。

{
        "Sid": "Example2",
        "Effect": "Deny",
        "Action": "translate:GetParallelData",
        "Resource": [
             "arn:aws:translate:us-west-2:123456789012:parallel-data/test-parallel-data"
        ]
}           

使用客戶受管金鑰搭配自訂術語的許可

如果您將 AWS Key Management Service （AWS KMS） 客戶受管金鑰與 Amazon Translate 自訂術語搭配使用，您可能需要KMS金鑰政策中的其他許可。

若要使用客戶受管金鑰呼叫 ImportTerminology操作，請將下列許可新增至現有的KMS金鑰政策。

{
    "Id": "key-consolepolicy-3",
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Allow access for use with Amazon Translate",
            "Effect": "Allow",
            "Principal": {
                "AWS": "IAM USER OR ROLE ARN"
            },
            "Action": [
                "kms:CreateAlias",
                "kms:CreateGrant",
                "kms:DescribeKey",
                "kms:GenerateDataKey",
                "kms:GetKeyPolicy",
                "kms:PutKeyPolicy",
                "kms:RetireGrant"
            ],
            "Resource": "*"
        }
    ]
}

若要呼叫使用KMS客戶受管金鑰匯入的自訂術語GetTerminology的操作，請在KMS金鑰政策中新增下列許可。

{
    "Id": "key-consolepolicy-3",
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Allow access for use with Amazon Translate",
            "Effect": "Allow",
            "Principal": {
                "AWS": "IAM USER OR ROLE ARN"
            },
            "Action": [
                "kms:Decrypt",
                "kms:GetKeyPolicy",
                "kms:PutKeyPolicy"
            ],
            "Resource": "*"
        }
    ]
}

若要呼叫 ListTerminologies或 DeleteTermionlogy操作以客戶受管金鑰匯入的自訂術語，您不需要擁有任何特殊 AWS KMS 許可。

若要在所有自訂術語操作中使用客戶受管金鑰，請在KMS金鑰政策中新增下列許可。

{
    "Id": "key-consolepolicy-3",
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "Allow access for use with Amazon Translate",
            "Effect": "Allow",
            "Principal": {
                "AWS": "IAM USER OR ROLE ARN"
            },
            "Action": [
                "kms:CreateGrant",
                "kms:Decrypt",
                "kms:DescribeKey",
                "kms:GenerateDataKey",
                "kms:GetKeyPolicy",
                "kms:PutKeyPolicy",
                "kms:RetireGrant"
            ],
            "Resource": "*"
        }
    ]
}

如需 Amazon Translate 操作和資源的詳細資訊，請參閱服務授權參考 中的 Amazon Translate 的動作、資源和條件金鑰。