AWS Security ChangesHomeSearch

AWS cli medium security documentation change

Service: cli · 2025-11-07 · Security-related medium

File: cli/latest/reference/identitystore/list-users.md

Summary

Updated CLI version reference, enhanced access control documentation for member accounts, modified identity store ID/user name patterns, added new user attributes (photos, website, birthdate), and improved input validation constraints

Security assessment

The change adds explicit guidance about limiting access from member accounts with a security-focused documentation link. Modifies IdentityStoreId pattern to enforce UUID/directory ID format (prevents invalid ID acceptance) and restructures permissions documentation to clarify least-privilege access. These changes address potential authorization weaknesses and input validation risks.

Diff

diff --git a/cli/latest/reference/identitystore/list-users.md b/cli/latest/reference/identitystore/list-users.md
index f61105c73..05e628ecc 100644
--- a//cli/latest/reference/identitystore/list-users.md
+++ b//cli/latest/reference/identitystore/list-users.md
@@ -15 +15 @@
-  * [AWS CLI 2.31.28 Command Reference](../../index.html) »
+  * [AWS CLI 2.31.31 Command Reference](../../index.html) »
@@ -63 +63 @@ Lists all users in the identity store. Returns a paginated list of complete `Use
-If you have administrator access to a member account, you can use this API from the member account. Read about [member accounts](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_accounts_access.html) in the _Organizations User Guide_ .
+If you have access to a member account, you can use this API operation from the member account. For more information, see [Limiting access to the identity store from member accounts](https://docs.aws.amazon.com/singlesignon/latest/userguide/manage-your-accounts.html#limiting-access-from-member-accounts) in the _IAM Identity Center User Guide_ .
@@ -137 +137 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/identi
->>>   * pattern: `\p{L}+(?:\.\p{L}+){0,2}`
+>>>   * pattern: `(?:\p{L}+:\p{L}+:\p{L}+(?:\.\p{L}+){0,3}|\p{L}+(?:\.\p{L}+){0,2})`
@@ -296 +296 @@ Users -> (list)
->> UserName -> (string)
+>> IdentityStoreId -> (string) [required]
@@ -298 +298 @@ Users -> (list)
->>> A unique string used to identify the user. The length limit is 128 characters. This value can consist of letters, accented characters, symbols, numbers, and punctuation. This value is specified at the time the user is created and stored as an attribute of the user object in the identity store.
+>>> The globally unique identifier for the identity store.
@@ -303,2 +303,2 @@ Users -> (list)
->>>   * max: `128`
->>>   * pattern: `[\p{L}\p{M}\p{S}\p{N}\p{P}]+`
+>>>   * max: `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}`
@@ -318,0 +319,12 @@ Users -> (list)
+>> 
+>> UserName -> (string)
+>>
+>>> A unique string used to identify the user. The length limit is 128 characters. This value can consist of letters, accented characters, symbols, numbers, and punctuation. This value is specified at the time the user is created and stored as an attribute of the user object in the identity store.
+>>> 
+>>> Constraints:
+>>> 
+>>>   * min: `1`
+>>>   * max: `128`
+>>>   * pattern: `[\p{L}\p{M}\p{S}\p{N}\p{P}]+`
+>>> 
+
@@ -342,2 +354,2 @@ Users -> (list)
->>>>>   * max: `100`
->>>>>   * pattern: `(?!(?i)(arn|aws):)[\p{L}\p{M}\p{S}\p{N}\p{P}]+`
+>>>>>   * max: `256`
+>>>>>   * pattern: `[\p{L}\p{M}\p{S}\p{N}\p{P}]+`
@@ -438,0 +451,2 @@ Users -> (list)
+>>> Prefix search supports a maximum of 1,000 characters for the string.
+>>> 
@@ -720 +734 @@ Users -> (list)
->> IdentityStoreId -> (string) [required]
+>> UserStatus -> (string)
@@ -722 +736,12 @@ Users -> (list)
->>> The globally unique identifier for the identity store.
+>>> The current status of the user account.
+>>> 
+>>> Possible values:
+>>> 
+>>>   * `ENABLED`
+>>>   * `DISABLED`
+>>> 
+
+>> 
+>> Photos -> (list)
+>>
+>>> A list of photos associated with the user. Users can have up to 3 photos with metadata including type, display name, and primary designation.
@@ -727,2 +752,69 @@ Users -> (list)
->>>   * max: `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}`
+>>>   * max: `3`
+>>> 
+
+>>> 
+>>> (structure)
+>>>
+>>>> Contains information about a user’s photo. Users can have up to 3 photos, with one designated as primary. Supports common image formats, including jpg, jpeg, png, and gif.
+>>>> 
+>>>> Value -> (string) [required]
+>>>>
+>>>>> The photo data or URL. Supported formats include jpg, jpeg, png, and gif. This field is required for all photo entries.
+>>>>> 
+>>>>> Constraints:
+>>>>> 
+>>>>>   * min: `1`
+>>>>>   * max: `1024`
+>>>>>   * pattern: `[\p{L}\p{M}\p{S}\p{N}\p{P}\t\n\r ]+`
+>>>>> 
+
+>>>> 
+>>>> Type -> (string)
+>>>>
+>>>>> The type of photo. This field is optional and can be used to categorize different types of photos.
+>>>>> 
+>>>>> Constraints:
+>>>>> 
+>>>>>   * min: `1`
+>>>>>   * max: `1024`
+>>>>>   * pattern: `[\p{L}\p{M}\p{S}\p{N}\p{P}\t\n\r ]+`
+>>>>> 
+
+>>>> 
+>>>> Display -> (string)
+>>>>
+>>>>> A human-readable description of the photo for display purposes. This optional field provides context about the photo.
+>>>>> 
+>>>>> Constraints:
+>>>>> 
+>>>>>   * min: `1`
+>>>>>   * max: `1024`
+>>>>>   * pattern: `[\p{L}\p{M}\p{S}\p{N}\p{P}\t\n\r ]+`
+>>>>> 
+
+>>>> 
+>>>> Primary -> (boolean)
+>>>>
+>>>>> Specifies whether this is the user’s primary photo. Default value is `false` . Only one photo can be designated as primary per user.
+>> 
+>> Website -> (string)
+>>
+>>> The user’s personal website or blog URL. This field stores website information for personal or professional use.
+>>> 
+>>> Constraints:
+>>> 
+>>>   * min: `1`
+>>>   * max: `1024`
+>>>   * pattern: `[\p{L}\p{M}\p{S}\p{N}\p{P}\t\n\r ]+`
+>>> 
+
+>> 
+>> Birthdate -> (string)
+>>
+>>> The user’s birthdate in YYYY-MM-DD format. This field stores personal birthdate information for the user.
+>>> 
+>>> Constraints:
+>>> 
+>>>   * min: `1`
+>>>   * max: `1024`
+>>>   * pattern: `[\p{L}\p{M}\p{S}\p{N}\p{P}\t\n\r ]+`
@@ -730,0 +823,16 @@ Users -> (list)
+>> 
+>> CreatedAt -> (timestamp)
+>>
+>>> The date and time the user was created.
+>> 
+>> CreatedBy -> (string)
+>>
+>>> The identifier of the user or system that created the user.
+>> 
+>> UpdatedAt -> (timestamp)
+>>
+>>> The date and time the user was last updated.
+>> 
+>> UpdatedBy -> (string)
+>>
+>>> The identifier of the user or system that last updated the user.
@@ -754 +862 @@ NextToken -> (string)
-  * [AWS CLI 2.31.28 Command Reference](../../index.html) »
+  * [AWS CLI 2.31.31 Command Reference](../../index.html) »