AWS KMS permissions
The Actions and Resources Table is designed to help you define access control in key policies and IAM policies.
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 |
CMK |
Conditions for CMK 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 CMK) |
No |
CMK |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
| CreateCustomKeyStore
|
IAM policy | No |
|
|
|
|
Key policy |
Yes |
CMK |
Encryption context conditions: kms:EncryptionContext:context-key Grant conditions: Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
IAM policy |
No |
|
kms:BypassPolicyLockoutSafetyCheck Conditions for tagging: 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 |
CMK |
Conditions for cryptographic operations Encryption context conditions: kms:EncryptionContext:context-key Conditions for CMK 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 CMK) |
No |
CMK |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
| DeleteCustomKeyStore
|
IAM policy | No |
|
|
|
|
Key policy |
No |
CMK |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
| DescribeCustomKeyStores
|
IAM policy | No |
|
|
|
|
Key policy |
Yes |
CMK |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) Other conditions: |
|
|
Key policy |
No |
CMK |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
No |
CMK |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
| DisconnectCustomKeyStore
|
IAM policy | No |
|
|
|
|
Key policy |
No |
CMK |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
No |
CMK (symmetric only) |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
Yes |
CMK |
Conditions for cryptographic operations Encryption context conditions: kms:EncryptionContext:context-key Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
Yes |
CMK (symmetric only) |
Conditions for cryptographic operations Encryption context conditions: kms:EncryptionContext:context-key Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
Yes |
CMK (symmetric only)
|
Conditions for data key pairs: Conditions for cryptographic operations Encryption context conditions: kms:EncryptionContext:context-key Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
GenerateDataKeyPairWithoutPlaintext
|
Key policy |
Yes |
CMK (symmetric only)
|
Conditions for data key pairs: Conditions for cryptographic operations Encryption context conditions: kms:EncryptionContext:context-key Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
GenerateDataKeyWithoutPlaintext
|
Key policy |
Yes |
CMK (symmetric only) |
Conditions for cryptographic operations Encryption context conditions: kms:EncryptionContext:context-key Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
IAM policy |
N/A |
|
None |
|
|
Key policy |
No |
CMK |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
Yes |
CMK (symmetric only) |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
No |
CMK (symmetric only) |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
Yes |
CMK (asymmetric only) |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) Other conditions: |
|
|
Key policy |
No |
CMK (symmetric only) |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) Other conditions: kms:ExpirationModel |
|
|
IAM policy |
No |
|
None |
|
|
Key policy |
Yes |
CMK |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) Other conditions: |
|
|
Key policy |
No |
CMK |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
IAM policy |
No |
|
None |
|
|
Key policy |
No |
CMK |
Conditions for CMK 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 |
CMK |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) Other conditions: |
|
To use this operation, the caller needs permission on two CMKs:
|
Key policy |
Yes |
CMK |
Conditions for cryptographic operations Encryption context conditions: kms:EncryptionContext:context-key Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) Other conditions: |
|
To use this operation, the caller needs the following permissions:
|
Key policy |
No |
CMK |
Conditions for CMK 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 |
CMK |
aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
Yes |
CMK |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) Other conditions: |
|
|
Key policy |
No |
CMK |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
Yes |
CMK (asymmetric only) |
Conditions for signing and verification: kms:RequestAliasConditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
|
Key policy |
No |
CMK |
Conditions for CMK 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 |
CMK |
Conditions for CMK 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 CMKs) |
No |
CMK |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
| UpdateCustomKeyStore
|
IAM policy | No |
|
|
|
|
Key policy |
No |
CMK |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
|
To use this operation, the caller needs |
Key policy |
No |
CMK |
Conditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) Other conditions |
|
|
Key policy |
Yes |
CMK (asymmetric only) |
Conditions for signing and verification: kms:RequestAliasConditions for CMK operations: aws:ResourceTag/tag-key (AWS global condition key) |
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 CMK in your account, their attempts to tag the CMK in your account will fail.
-
Resources lists the AWS KMS resources to which the permissions apply. AWS KMS supports two resource types: a customer master key (CMK) and an alias. In a key policy, the value of the
Resourceelement is always*, which indicates the CMK to which the key policy is attached.Use the following values to represent an AWS KMS resource in an IAM policy.
- CMK
-
When the resource is a customer master key (CMK), use its key ARN. For help, see Finding the key ID and 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 (CMK or alias), use an asterisk (
*).In an IAM policy for an AWS KMS permission, an asterisk in the
Resourceelement indicates all AWS KMS resources (CMKs and aliases). You can also use an asterisk in theResourceelement when the AWS KMS permission doesn't apply to any particular CMKs 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.
