AWS KMS permissions
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.
You can also learn about AWS KMS permissions in the Actions, resources, and condition keys for AWS Key Management Service topic of the Service Authorization Reference. However, that topic doesn't list all of the condition keys that you can use to refine each permission.
Note
You might have to scroll horizontally or vertically to see all of the data in the table.
| Actions and permissions | Policy type | Cross-account use | Resources (for IAM policies) | AWS KMS condition keys |
|---|---|---|---|---|
|
|
Key policy |
No |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
| ConnectCustomKeyStore
|
IAM policy | No |
|
|
|
To use this operation, the caller needs
For details, see Controlling access to aliases. |
IAM policy (for the alias) |
No |
Alias |
None (when controlling access to the alias) |
|
Key policy (for the KMS key) |
No |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
| CreateCustomKeyStore
|
IAM policy | No |
|
|
|
|
Key policy |
Yes |
KMS key |
Encryption context conditions: kms:EncryptionContext:context-key Grant conditions: Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
IAM policy |
No |
|
kms:BypassPolicyLockoutSafetyCheck aws:RequestTag/tag-key (AWS global condition key) aws:ResourceTag/tag-key (AWS global condition key) aws:TagKeys (AWS global condition key) |
|
|
Key policy |
Yes |
KMS key |
Conditions for cryptographic operations Encryption context conditions: kms:EncryptionContext:context-key Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
To use this operation, the caller needs
For details, see Controlling access to aliases. |
IAM policy (for the alias) |
No |
Alias |
None (when controlling access to the alias) |
|
Key policy (for the KMS key) |
No |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
| DeleteCustomKeyStore
|
IAM policy | No |
|
|
|
|
Key policy |
No |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
| DescribeCustomKeyStores
|
IAM policy | No |
|
|
|
|
Key policy |
Yes |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) Other conditions: |
|
|
Key policy |
No |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
No |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
| DisconnectCustomKeyStore
|
IAM policy | No |
|
|
|
|
Key policy |
No |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
No |
KMS key (symmetric only) |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
Yes |
KMS key |
Conditions for cryptographic operations Encryption context conditions: kms:EncryptionContext:context-key Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
Yes |
KMS key (symmetric only) |
Conditions for cryptographic operations Encryption context conditions: kms:EncryptionContext:context-key Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
Yes |
KMS key (symmetric only) Generates an asymmetric data key pair that is protected by a symmetric encryption KMS key. |
Conditions for data key pairs: Conditions for cryptographic operations Encryption context conditions: kms:EncryptionContext:context-key Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
GenerateDataKeyPairWithoutPlaintext
|
Key policy |
Yes |
KMS key (symmetric only) Generates an asymmetric data key pair that is protected by a symmetric encryption KMS key. |
Conditions for data key pairs: Conditions for cryptographic operations Encryption context conditions: kms:EncryptionContext:context-key Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
GenerateDataKeyWithoutPlaintext
|
Key policy |
Yes |
KMS key (symmetric only) |
Conditions for cryptographic operations Encryption context conditions: kms:EncryptionContext:context-key Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
| GenerateMac
|
Key policy | Yes | KMS key | Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) Conditions for cryptographic operations: |
|
|
IAM policy |
N/A |
|
None |
|
|
Key policy |
No |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
Yes |
KMS key (symmetric only) |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
No |
KMS key (symmetric only) |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
Yes |
KMS key (asymmetric only) |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) Other conditions: |
|
|
Key policy |
No |
KMS key (symmetric only) |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) Other conditions: kms:ExpirationModel |
|
|
IAM policy |
No |
|
None |
|
|
Key policy |
Yes |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) Other conditions: |
|
|
Key policy |
No |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
IAM policy |
No |
|
None |
|
|
Key policy |
No |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
IAM policy |
The specified principal must be in the local account, but the operation returns grants in all accounts. |
|
None |
|
|
Key policy |
No |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) Other conditions: |
|
To use this operation, the caller needs permission on two KMS keys:
|
Key policy |
Yes |
KMS key |
Conditions for cryptographic operations Encryption context conditions: kms:EncryptionContext:context-key Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) Other conditions: |
|
To use this operation, the caller needs the following permissions:
|
Key policy |
No |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) Other conditions: |
|
Permission to retire a grant is determined primarily by the grant. A policy alone cannot allow access to this operation. For more information, see Retiring and revoking grants. |
IAM policy (This permission is not effective in a key policy.) |
Yes |
KMS key |
aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
Yes |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) Other conditions: |
|
|
Key policy |
No |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
Yes |
KMS key (asymmetric only) |
Conditions for signing and verification: kms:RequestAliasConditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
No |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) Conditions for tagging: aws:RequestTag/tag-key (AWS global condition key) aws:TagKeys (AWS global condition key) |
|
|
Key policy |
No |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) Conditions for tagging: aws:RequestTag/tag-key (AWS global condition key) aws:TagKeys (AWS global condition key) |
|
To use this operation, the caller needs
For details, see Controlling access to aliases. |
IAM policy (for the alias) |
No |
Alias |
None (when controlling access to the alias) |
|
Key policy (for the KMS keys) |
No |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
| UpdateCustomKeyStore
|
IAM policy | No |
|
|
|
|
Key policy |
No |
KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
To use this operation, the caller needs |
Key policy |
No | KMS key |
Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) Other conditions |
|
|
Key policy |
Yes | KMS key (asymmetric only) |
Conditions for signing and verification: kms:RequestAliasConditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) |
| VerifyMac
|
Key policy | Yes | KMS key | Conditions for KMS key operations: aws:ResourceTag/tag-key (AWS global condition key) Conditions for cryptographic operations: |
Column descriptions
The columns in this table provide the following information:
-
Actions and permissions lists each AWS KMS API operation and the permission that allows the operation. You specify the operation in
Actionelement 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
Resourceelement 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 Finding the key ID and key ARN.
arn:AWS_partition_name:kms:AWS_Region:AWS_account_ID:key/key_IDFor 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 Finding the alias name and alias ARN.
arn:AWS_partition_name:kms:AWS_region:AWS_account_ID:alias/alias_nameFor 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
Resourceelement indicates all AWS KMS resources (KMS keys and aliases). You can also use an asterisk in theResourceelement when the AWS KMS permission doesn't apply to any particular KMS keys or aliases. For example, when allowing or denyingkms:CreateKeyorkms:ListKeyspermission, you can set theResourceelement to*or to an account-specific variation, such asarn:.AWS_partition_name:kms:AWS_region:AWS_account_ID:*
-
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's
Conditionelement. 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.
