How To: Revoke a User's Tokens Across All Devices After a Password Change

Version Affected: SecureAuth CIAM

 

Overview

This article explains how to revoke a user's access tokens, refresh tokens, and single sign-on (SSO) sessions across all of their devices in SecureAuth CIAM — for example, after the user changes their password. The default token endpoint only revokes the session tied to the current token, so a user's other device sessions stay valid unless they are revoked separately.

Revoke Tokens Across All Devices

Send a DELETE request to the /tokens endpoint:

DELETE https://<tenant_domain>/default/tokens?deleteCurrentToken=true

• Without the deleteCurrentToken query parameter, this revokes all of the user's tokens and sessions except the one tied to the access token used to call this endpoint.
• With deleteCurrentToken=true, this also revokes that current session's token.

For example, if a user is logged in on devices A, B, and C and changes their password on device A, call this endpoint (without deleteCurrentToken) using device A's token to revoke the sessions on devices B and C. Those devices' tokens are invalidated immediately, and the user must sign in again on them with the new password.


 

SecureAuth Knowledge Base Articles provide information based on specific use cases and may not apply to all appliances or configurations. Be advised that these instructions could cause harm to the environment if not followed correctly or if they do not apply to the current use case.

Customers are responsible for their own due diligence prior to utilizing this information and agree that SecureAuth is not liable for any issues caused by misconfiguration directly or indirectly related to SecureAuth products.