AWS Security ChangesHomeSearch

AWS kms medium security documentation change

Service: kms · 2026-05-22 · Security-related medium

File: kms/latest/developerguide/grant-authorization.md

Summary

Added documentation for new grant condition keys and updated descriptions for existing keys

Security assessment

Added new condition keys (kms:GrantConstraintSourceArn, kms:GranteeServicePrincipal, kms:RetiringServicePrincipal) that enforce granular access controls for grant creation. These changes directly enable stricter security policies by allowing resource-based constraints and service principal restrictions, reducing privilege escalation risks.

Diff

diff --git a/kms/latest/developerguide/grant-authorization.md b/kms/latest/developerguide/grant-authorization.md
index ab7818a4c..09ca8e04d 100644
--- a//kms/latest/developerguide/grant-authorization.md
+++ b//kms/latest/developerguide/grant-authorization.md
@@ -20,0 +21,5 @@ When you use a key policy or IAM policy to control access to operations that cre
+[kms:GrantConstraintSourceArn](./conditions-kms.html#conditions-kms-grant-constraint-source-arn)
+    
+
+Allows principals to create a grant only when the grant includes a `SourceArn` constraint with the specified value.
+
@@ -25,0 +31,10 @@ Allows principals to create a grant only when the grant includes the specified [
+[kms:GranteePrincipal](./conditions-kms.html#conditions-kms-grantee-principal)
+    
+
+Allows principals to create a grant only for the specified [grantee principal](./grants.html#terms-grantee-principal).
+
+[kms:GranteeServicePrincipal](./conditions-kms.html#conditions-kms-grantee-service-principal)
+    
+
+Allows principals to create a grant only when the grant specifies a particular grantee service principal.
+
@@ -36 +51 @@ Allows principals to create a grant, but limits the grant to the specified opera
-[kms:GranteePrincipal](./conditions-kms.html#conditions-kms-grantee-principal)
+[kms:RetiringPrincipal](./conditions-kms.html#conditions-kms-retiring-principal)
@@ -39 +54 @@ Allows principals to create a grant, but limits the grant to the specified opera
-Allows principals to create a grant only for the specified [grantee principal](./grants.html#terms-grantee-principal).
+Allows principals to create a grant only when the grant specifies a particular [retiring principal](./grants.html#terms-retiring-principal).
@@ -41 +56 @@ Allows principals to create a grant only for the specified [grantee principal](.
-[kms:RetiringPrincipal](./conditions-kms.html#conditions-kms-retiring-principal)
+[kms:RetiringServicePrincipal](./conditions-kms.html#conditions-kms-retiring-service-principal)
@@ -44 +59 @@ Allows principals to create a grant only for the specified [grantee principal](.
-Allows principals to create a grant only when the grant specifies a particular [retiring principal](./grants.html#terms-retiring-principal).
+Allows principals to create a grant only when the grant specifies a particular retiring service principal.