AWS singlesignon: Group: add GroupArn and Revision fields
Summary
Adds a GroupArn field, a Revision field for conditional UpdateGroup/DeleteGroup operations, and updates IdentityStoreId/GroupId length and pattern constraints to accept ARNs.
Security assessment
The Revision field enables optimistic-concurrency conditional updates, which is a correctness/consistency feature rather than a documented security control. The change is API documentation for the Group object and does not address a specific vulnerability.
Evidence
+The current revision of the group in the identity store. This value changes each time the group is modified. You can provide it as the `Revision` parameter of an `UpdateGroup` or `DeleteGroup` request to make the operation conditional on the group not having changed. Treat this value as an opaque token: don't parse it or rely on its format or ordering.
Diff
diff --git a/singlesignon/latest/IdentityStoreAPIReference/API_Group.md b/singlesignon/latest/IdentityStoreAPIReference/API_Group.md index 9e16ac8..1a63d3e 100644 --- a//singlesignon/latest/IdentityStoreAPIReference/API_Group.md +++ b//singlesignon/latest/IdentityStoreAPIReference/API_Group.md @@ -14,0 +15,13 @@ A group object that contains the metadata and attributes for a specified group. +**GroupArn** + + +The Amazon Resource Name (ARN) of the group in the identity store. For example, `arn:aws:identitystore:::group/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222`. + +Type: String + +Length Constraints: Minimum length of 60. Maximum length of 100. + +Pattern: `arn:aws[a-z-]*:identitystore:::(user|group|membership)/([0-9a-f]{10}-|)[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}` + +Required: Yes + @@ -22 +35 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 47. +Length Constraints: Minimum length of 1. Maximum length of 100. @@ -24 +37 @@ Length Constraints: Minimum length of 1. Maximum length of 47. -Pattern: `([0-9a-f]{10}-|)[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}` +Pattern: `(arn:aws[a-z-]*:identitystore:::(user|group|membership)/)?([0-9a-f]{10}-|)[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}` @@ -35 +48,14 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 36. +Length Constraints: Minimum length of 1. Maximum length of 93. + +Pattern: `(arn:aws[a-z-]*:identitystore::\d{12}:identitystore/)?(d-[0-9a-f]{10}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})` + +Required: Yes + +**Revision** + + +The current revision of the group in the identity store. This value changes each time the group is modified. You can provide it as the `Revision` parameter of an `UpdateGroup` or `DeleteGroup` request to make the operation conditional on the group not having changed. Treat this value as an opaque token: don't parse it or rely on its format or ordering. + +Type: String + +Length Constraints: Minimum length of 1. Maximum length of 64. @@ -37 +63 @@ Length Constraints: Minimum length of 1. Maximum length of 36. -Pattern: `d-[0-9a-f]{10}$|^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` +Pattern: `[0-9]+`