翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

タグへのアクセスを制御する

を使用してタグを追加、表示、削除するにはAPI、プリンシパルがIAMポリシーでタグのアクセス許可が必要です。

また、タグ AWS のグローバル条件キーを使用して、これらのアクセス許可を制限することもできます。 AWS Payment Cryptography では、これらの条件により、 TagResourceや などのタグ付けオペレーションへのアクセスを制御できますUntagResource。

ポリシーの例と詳細については、IAM「 ユーザーガイド」の「タグキーに基づくアクセスの制御」を参照してください。

タグを作成および管理するためのアクセス許可は、次のように機能します。

ポリシーのタグ付け許可

キーポリシーまたはIAMポリシーでタグ付けアクセス許可を指定できます。例えば、次のキーポリシーの例では、選択したユーザーにキーに対するタグ付け許可が付与されます。これにより、サンプルの管理者ロールまたはデベロッパーロールを引き受けることができるすべてのユーザーにタグを表示する許可が付与されます。

{
  "Version": "2012-10-17",
  "Id": "example-key-policy",
  "Statement": [
    { 
      "Sid": "",
      "Effect": "Allow",
      "Principal": {"AWS": "arn:aws:iam::111122223333:root"},
      "Action": "payment-cryptography:*",
      "Resource": "*"
    },
    {
      "Sid": "Allow all tagging permissions",
      "Effect": "Allow",
      "Principal": {"AWS": [
        "arn:aws:iam::111122223333:user/LeadAdmin",
        "arn:aws:iam::111122223333:user/SupportLead"
      ]},
      "Action": [
          "payment-cryptography:TagResource",
          "payment-cryptography:ListTagsForResource",
          "payment-cryptography:UntagResource"
      ],
      "Resource": "*"
    },
    {
      "Sid": "Allow roles to view tags",
      "Effect": "Allow",
      "Principal": {"AWS": [
        "arn:aws:iam::111122223333:role/Administrator",
        "arn:aws:iam::111122223333:role/Developer"
      ]},
      "Action": "payment-cryptography:ListResourceTags",
      "Resource": "*"
    }
  ]
}

プリンシパルに複数のキーに対するタグ付けアクセス許可を付与するには、 IAM ポリシーを使用できます。このポリシーを有効にするには、各キーのキーポリシーで、アカウントがIAMポリシーを使用してキーへのアクセスを制御することを許可する必要があります。

例えば、次のIAMポリシーでは、プリンシパルにキーの作成を許可します。指定したアカウントのすべてのキーでタグを作成および管理することもできます。この組み合わせにより、プリンシパルはCreateKeyオペレーションのタグパラメータを使用して、キーの作成中にキーにタグを追加できます。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "IAMPolicyCreateKeys",
      "Effect": "Allow",
      "Action": "payment-cryptography:CreateKey",
      "Resource": "*"
    },
    {
      "Sid": "IAMPolicyTags",
      "Effect": "Allow",
      "Action": [
        "payment-cryptography:TagResource",
        "payment-cryptography:UntagResource",
        "payment-cryptography:ListTagsForResource"
      ],
      "Resource": "arn:aws:payment-cryptography:*:111122223333:key/*"
    }    
  ]
}

タグ付け許可を制限する

ポリシー条件を使用して、タグ付け許可を制限できます。次のポリシー条件を payment-cryptography:TagResource および payment-cryptography:UntagResource 許可に適用できます。例えば、aws:RequestTag/tag-key 条件を使用して、プリンシパルが特定のタグのみを追加できるようにするか、プリンシパルが特定のタグキーを持つタグを追加しないように許可できます。

ベストプラクティスとして、タグを使用してキーへのアクセスを制御する場合は、aws:RequestTag/tag-keyまたはaws:TagKeys条件キーを使用して、許可するタグ (またはタグキー) を決定します。

例えば、次のIAMポリシーは前のポリシーと似ています。ただしこのポリシーでは、プリンシパルはタグ (TagResource) の作成とタグ UntagResource の削除を、Project タグキーを持つタグに対してのみ実行できます。

TagResource および UntagResourceリクエストには複数のタグを含めることができるため、aws:TagKeys 条件を使用して ForAllValuesまたは ForAnyValue セット演算子を指定する必要があります。ForAnyValue 演算子では、リクエスト内のタグキー 1 つ以上が、ポリシーのタグキーの 1 つと一致する必要があります。ForAllValues 演算子では、リクエスト内のタグキーすべてが、ポリシーのタグキーの 1 つと一致する必要があります。ForAllValues リクエストにタグがない場合も演算子trueは を返しますが、タグが指定されていない場合は TagResource と UntagResource は失敗します。セット演算子の詳細については、「 ユーザーガイド」の「複数のキーと値を使用する」を参照してください。 IAM

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "IAMPolicyCreateKey",
      "Effect": "Allow",
      "Action": "payment-cryptography:CreateKey",
      "Resource": "*"
    },
    {
      "Sid": "IAMPolicyViewAllTags",
      "Effect": "Allow",
      "Action": "payment-cryptography:ListResourceTags",
      "Resource": "arn:aws:payment-cryptography:*:111122223333:key/*"
    },
    {
      "Sid": "IAMPolicyManageTags",
      "Effect": "Allow",
      "Action": [
        "payment-cryptography:TagResource",
        "payment-cryptography:UntagResource"
      ],
      "Resource": "arn:aws:payment-cryptography:*:111122223333:key/*",
      "Condition": {
          "ForAllValues:StringEquals": {"aws:TagKeys": "Project"}
      }
    }
  ]
}