AWS KMS permissions - AWS Key Management Service (original) (raw)

This table is designed to help you understand AWS KMS permissions so you can control access to your AWS KMS resources. Definitions of the column headings appear below the table.

For more information on which AWS KMS operations are valid for symmetric encryption KMS keys, asymmetric KMS keys, and HMAC KMS keys, see the Key type reference.

• Actions and permissions lists each AWS KMS API operation and the permission that allows the operation. You specify the operation inAction element of a policy statement.
• Policy type indicates whether the permission can be used in a key policy or IAM policy.
  Key policy means that you can specify the permission in the key policy. When the key policy contains the policy statement that enables IAM policies, you can specify the permission in an IAM policy.
  IAM policy means that you can specify the permission only in an IAM policy.
• Cross-account use shows the operations that authorized users can perform on resources in a different AWS account.
  A value of Yes means that principals can perform the operation on resources in a different AWS account.
  A value of No means that principals can perform the operation only on resources in their own AWS account.
  If you give a principal in a different account a permission that can't be used on a cross-account resource, the permission is not effective. For example, if you give a principal in a different account kms:TagResource permission to a KMS key in your account, their attempts to tag the KMS key in your account will fail.
• Resources lists the AWS KMS resources to which the permissions apply. AWS KMS supports two resource types: a KMS key and an alias. In a key policy, the value of the Resource element is always *, which indicates the KMS key to which the key policy is attached.
  Use the following values to represent an AWS KMS resource in an IAM policy.
  KMS key
  When the resource is a KMS key, use its key ARN. For help, see Find the key ID and key ARN.
  arn:`AWS_partition_name`:kms:`AWS_Region`:`AWS_account_ID`:key/`key_ID`
  For example:
  arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
  Alias
  When the resource is an alias, use its alias ARN. For help, see Find the alias name and alias ARN for a KMS key.
  arn:`AWS_partition_name`:kms:`AWS_region`:`AWS_account_ID`:alias/`alias_name`
  For example:
  arn:aws:kms:us-west-2:111122223333:alias/ExampleAlias
  * (asterisk)
  When the permission doesn't apply to a particular resource (KMS key or alias), use an asterisk (*).
  In an IAM policy for an AWS KMS permission, an asterisk in the Resource element indicates all AWS KMS resources (KMS keys and aliases). You can also use an asterisk in the Resource element when the AWS KMS permission doesn't apply to any particular KMS keys or aliases. For example, when allowing or denyingkms:CreateKey or kms:ListKeys permission, you must set theResource element to *.
• AWS KMS condition keys lists the AWS KMS condition keys that you can use to control access to the operation. You specify conditions in a policy'sCondition element. For more information, see AWS KMS condition keys. This column also includes AWS global condition keys that are supported by AWS KMS, but not by all AWS services.