AWS singlesignon: DescribeGroupMembership: add ARN identifiers and MembershipArn field
Summary
Documents that IdentityStoreId and MembershipId can be specified by ID or ARN, widens length constraints (47->100, 36->93) and updates patterns to accept ARN forms, adds a new MembershipArn response field, extends the ResourceType enum with GROUP_MEMBERSHIP and RESOURCE_POLICY, and updates the example response and related-links list.
Security assessment
This is API reference documentation for the DescribeGroupMembership request/response: it adds ARN-based addressing of identity store memberships and a MembershipArn output field, plus new ResourceType enum values. ARNs matter for IAM resource scoping, but the diff fixes no vulnerability and gives no hardening or security guidance, so severity is low.
Evidence
+ "MembershipArn": "arn:aws:identitystore:::membership/a1b2c3d4-5678-90ab-cdef-EXAMPLE33333",
Diff
diff --git a/singlesignon/latest/IdentityStoreAPIReference/API_DescribeGroupMembership.md b/singlesignon/latest/IdentityStoreAPIReference/API_DescribeGroupMembership.md index f1c7c0d..2edb614 100644 --- a//singlesignon/latest/IdentityStoreAPIReference/API_DescribeGroupMembership.md +++ b//singlesignon/latest/IdentityStoreAPIReference/API_DescribeGroupMembership.md @@ -35,0 +36,2 @@ The globally unique identifier for the identity store. +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`. + @@ -38 +40 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 36. +Length Constraints: Minimum length of 1. Maximum length of 93. @@ -40 +42 @@ 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})` @@ -48,0 +51,2 @@ The identifier for a `GroupMembership` in an identity store. +You can specify the group membership by ID or by Amazon Resource Name (ARN). For example, membership ID `a1b2c3d4-5678-90ab-cdef-EXAMPLE33333` or membership ARN `arn:aws:identitystore:::membership/a1b2c3d4-5678-90ab-cdef-EXAMPLE33333`. + @@ -51 +55 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 47. +Length Constraints: Minimum length of 1. Maximum length of 100. @@ -53 +57 @@ 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}` @@ -65,0 +70 @@ Required: Yes + "MembershipArn": "**_string_** ", @@ -98 +103 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 47. +Length Constraints: Minimum length of 1. Maximum length of 100. @@ -100 +105 @@ 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}` @@ -109 +114 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 36. +Length Constraints: Minimum length of 1. Maximum length of 93. @@ -111 +116 @@ 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})` @@ -121,0 +127,11 @@ Type: [MemberId](./API_MemberId.html) object +**MembershipArn ** + + +The Amazon Resource Name (ARN) of the group membership in the identity store. For example, `arn:aws:identitystore:::membership/a1b2c3d4-5678-90ab-cdef-EXAMPLE33333`. + +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}` + @@ -129 +145 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 47. +Length Constraints: Minimum length of 1. Maximum length of 100. @@ -131 +147 @@ 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}` @@ -208 +224 @@ 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. @@ -262 +278 @@ This example retrieves the member ID for the user and group ID for the group for - "MembershipId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" + "MembershipId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333" @@ -271,0 +288 @@ This example retrieves the member ID for the user and group ID for the group for + "MembershipArn": "arn:aws:identitystore:::membership/a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", @@ -313 +330 @@ DescribeGroup -DescribeUser +DescribeIdentityStore