AWS singlesignon: DescribeGroup: add ARN identifiers, GroupArn and Revision fields
Summary
Documents that GroupId and IdentityStoreId can now be supplied as either IDs or ARNs, widens the length constraints (47->100, 36->93) and updates the validation patterns to accept ARN forms, adds a new GroupArn response field and a Revision field, and extends the ResourceType enum with GROUP_MEMBERSHIP and RESOURCE_POLICY. Example responses updated accordingly.
Security assessment
The change is API reference documentation for identifier formats: it allows identity store groups to be addressed by ARN and adds a GroupArn output plus a Revision value. ARN-based resource identifiers are relevant to how IAM policies scope access to identity store resources, but the diff documents no vulnerability, no permission boundary, and no security guidance, so it is a low-severity, security-tangential API surface change.
Evidence
+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}`
Diff
diff --git a/singlesignon/latest/IdentityStoreAPIReference/API_DescribeGroup.md b/singlesignon/latest/IdentityStoreAPIReference/API_DescribeGroup.md index 18a2d2b..04d1c6c 100644 --- a//singlesignon/latest/IdentityStoreAPIReference/API_DescribeGroup.md +++ b//singlesignon/latest/IdentityStoreAPIReference/API_DescribeGroup.md @@ -35,0 +36,2 @@ The identifier for a group in the identity store. +You can specify the group by ID or by Amazon Resource Name (ARN). For example, group ID `a1b2c3d4-5678-90ab-cdef-EXAMPLE22222` or group ARN `arn:aws:identitystore:::group/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222`. + @@ -38 +40 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 47. +Length Constraints: Minimum length of 1. Maximum length of 100. @@ -40 +42 @@ 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}` @@ -48,0 +51,2 @@ The globally unique identifier for the identity store, such as `d-1234567890`. I +You can specify the identity store by ID or by Amazon Resource Name (ARN). For example, identity store ID `d-1234567890` or identity store ARN `arn:aws:identitystore::111122223333:identitystore/d-1234567890`. + @@ -51 +55 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 36. +Length Constraints: Minimum length of 1. Maximum length of 93. @@ -53 +57 @@ 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: `(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})` @@ -70,0 +75 @@ Required: Yes + "GroupArn": "**_string_** ", @@ -72,0 +78 @@ Required: Yes + "Revision": "**_string_** ", @@ -127,0 +134,11 @@ Array Members: Minimum number of 1 item. Maximum number of 10 items. +**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}` + @@ -135 +152 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 47. +Length Constraints: Minimum length of 1. Maximum length of 100. @@ -137 +154 @@ 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}` @@ -146 +163 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 36. +Length Constraints: Minimum length of 1. Maximum length of 93. @@ -148 +165,12 @@ 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: `(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})` + +**Revision ** + + +The current revision of the group in the identity store. This value changes each time the group is modified. + +Type: String + +Length Constraints: Minimum length of 1. Maximum length of 64. + +Pattern: `[0-9]+` @@ -225 +253 @@ The identifier for a resource in the identity store that can be used as `UserId` -An enum object indicating the type of resource in the identity store service. Valid values include USER, GROUP, and IDENTITY_STORE. +An enum object indicating the type of resource in the identity store service. Valid values include USER, GROUP, GROUP_MEMBERSHIP, RESOURCE_POLICY, and IDENTITY_STORE. @@ -286,0 +315 @@ This example retrieves the group name and description for a group called Develop + "IdentityStoreId": "d-1234567890", @@ -287,0 +317 @@ This example retrieves the group name and description for a group called Develop + "GroupArn": "arn:aws:identitystore:::group/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", @@ -290 +320 @@ This example retrieves the group name and description for a group called Develop - "IdentityStoreId": "d-1234567890" + "Revision": "1699564800000"