AWS Security ChangesHomeSearch

AWS singlesignon: UpdateUser: add Revision optimistic locking and ARN support

Service: singlesignon · 2026-10-01 · Documentation medium

File: singlesignon/latest/IdentityStoreAPIReference/API_UpdateUser.md

Summary

Documents a new optional Revision parameter for optimistic concurrency control on UpdateUser, adds ARN-based identifiers for IdentityStoreId/UserId, adds a Response Syntax block returning IdentityStoreId/Revision/UserArn/UserId, expands ConflictException reasons (UNIQUENESS_CONSTRAINT_VIOLATION, CONCURRENT_MODIFICATION), and adds GROUP_MEMBERSHIP/RESOURCE_POLICY resource types.

Security assessment

The added Revision parameter implements optimistic locking, preventing lost-update/race-condition overwrites of user attributes (a TOCTOU-style integrity concern) and the ConflictException now distinguishes CONCURRENT_MODIFICATION. This is security-adjacent hardening guidance rather than a fix for a specific disclosed vulnerability, so it is documented as security best practice at medium severity.

Evidence

The expected current revision of the user. When you provide this value, the update is applied only if it matches the current revision of the user in the identity store, which prevents you from overwriting concurrent changes.

Diff

diff --git a/singlesignon/latest/IdentityStoreAPIReference/API_UpdateUser.md b/singlesignon/latest/IdentityStoreAPIReference/API_UpdateUser.md
index e0264e9..5854690 100644
--- a//singlesignon/latest/IdentityStoreAPIReference/API_UpdateUser.md
+++ b//singlesignon/latest/IdentityStoreAPIReference/API_UpdateUser.md
@@ -7 +7 @@
-Request SyntaxRequest ParametersResponse ElementsErrorsExamplesSee Also
+Request SyntaxRequest ParametersResponse SyntaxResponse ElementsErrorsExamplesSee Also
@@ -23,0 +24 @@ Updates the specified user metadata and attributes in the specified identity sto
+       "Revision": "string",
@@ -37,0 +39,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`.
+
@@ -40 +43 @@ Type: String
-Length Constraints: Minimum length of 1. Maximum length of 36.
+Length Constraints: Minimum length of 1. Maximum length of 93.
@@ -42 +45 @@ 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})`
@@ -56,0 +60,13 @@ Required: Yes
+**Revision **
+    
+
+The expected current revision of the user. When you provide this value, the update is applied only if it matches the current revision of the user in the identity store, which prevents you from overwriting concurrent changes. If the value doesn't match, the operation fails with a `ConflictException`. If you don't provide this value, the update is applied unconditionally.
+
+Type: String
+
+Length Constraints: Minimum length of 1. Maximum length of 64.
+
+Pattern: `[0-9]+`
+
+Required: No
+
@@ -61,0 +78,2 @@ The identifier for a user in the identity store.
+You can specify the user by ID or by Amazon Resource Name (ARN). For example, user ID `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111` or user ARN `arn:aws:identitystore:::user/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`.
+
@@ -64 +82 @@ Type: String
-Length Constraints: Minimum length of 1. Maximum length of 47.
+Length Constraints: Minimum length of 1. Maximum length of 100.
@@ -66 +84 @@ 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}`
@@ -69,0 +88,10 @@ Required: Yes
+## Response Syntax
+    
+    
+    {
+       "IdentityStoreId": "**_string_** ",
+       "Revision": "**_string_** ",
+       "UserArn": "**_string_** ",
+       "UserId": "**_string_** "
+    }
+
@@ -72 +100,47 @@ Required: Yes
-If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.
+If the action is successful, the service sends back an HTTP 200 response.
+
+The following data is returned in JSON format by the service.
+
+**IdentityStoreId **
+    
+
+The globally unique identifier for the identity store.
+
+Type: String
+
+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})`
+
+**Revision **
+    
+
+The revision of the user after the requested update is applied.
+
+Type: String
+
+Length Constraints: Minimum length of 1. Maximum length of 64.
+
+Pattern: `[0-9]+`
+
+**UserArn **
+    
+
+The Amazon Resource Name (ARN) of the user in the identity store. For example, `arn:aws:identitystore:::user/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`.
+
+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}`
+
+**UserId **
+    
+
+The identifier for a user in the identity store.
+
+Type: String
+
+Length Constraints: Minimum length of 1. 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}`
@@ -110 +184 @@ This request cannot be completed for one of the following reasons:
-Indicates the reason for a conflict error when the service is unable to access a Customer Managed KMS key. For non-KMS permission errors, this field is not included.
+Indicates the reason for the conflict error. `UNIQUENESS_CONSTRAINT_VIOLATION` indicates that the request would violate an existing uniqueness constraint, such as a user name or other unique attribute that is already in use. `CONCURRENT_MODIFICATION` indicates that the resource was modified by another request during this operation.
@@ -159 +233 @@ 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.
@@ -218 +292 @@ HTTP Status Code: 400
-This example updates the specified user's nickname to Johnny and the user name to John Doe.
+This example updates the specified user's nickname to Johnny and the user name to John Doe. It passes the current `Revision` so that your update is applied only if the user hasn't changed since you last read it (optimistic locking); the response returns the new `Revision`.
@@ -225,0 +300 @@ This example updates the specified user's nickname to Johnny and the user name t
+        "Revision": "1699564800000",
@@ -242 +317,6 @@ This example updates the specified user's nickname to Johnny and the user name t
-    No response
+    {
+        "IdentityStoreId": "d-1234567890",
+        "UserId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
+        "UserArn": "arn:aws:identitystore:::user/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
+        "Revision": "1699651200000"
+    }
@@ -247 +327 @@ This example updates the specified user's nickname to Johnny and the user name t
-This example updates the family name of the specified user to Smith. 
+This example updates the family name of the specified user to Smith. If you omit `Revision`, your update is applied unconditionally.
@@ -267 +347,6 @@ This example updates the family name of the specified user to Smith.
-    No response
+    {
+        "IdentityStoreId": "d-1234567890",
+        "UserId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
+        "UserArn": "arn:aws:identitystore:::user/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
+        "Revision": "1699651200000"
+    }
@@ -298 +383,6 @@ This example updates the phone number for the specified user.
-    No response
+    {
+        "IdentityStoreId": "d-1234567890",
+        "UserId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
+        "UserArn": "arn:aws:identitystore:::user/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
+        "Revision": "1699651200000"
+    }
@@ -326 +416,6 @@ This example replaces all attributes in `aws:identitystore:enterprise` extension
-    No response
+    {
+        "IdentityStoreId": "d-1234567890",
+        "UserId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
+        "UserArn": "arn:aws:identitystore:::user/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
+        "Revision": "1699651200000"
+    }
@@ -351 +446,6 @@ This example replaces only `department` in `aws:identitystore:enterprise` extens
-    No response
+    {
+        "IdentityStoreId": "d-1234567890",
+        "UserId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
+        "UserArn": "arn:aws:identitystore:::user/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
+        "Revision": "1699651200000"
+    }
@@ -387 +487 @@ To use the Amazon Web Services Documentation, Javascript must be enabled. Please
-UpdateGroup
+UpdateIdentityStore