Manage remote user stores in Asgardeo

# Manage remote user stores in Asgardeo

This guide walks you through the process of managing your remote user stores via the Asgardeo Console.

# Update attribute mappings

To update attribute mappings via the Asgardeo Console:

On the Asgardeo Console, go to User Attributes & Stores > User Stores
Select your user store from the User stores list.
Go to the Attribute Mappings tab and update the required information.
- Update Custom Attributes and Local Attributes mapped to your user store.
- Map Asgardeo attributes with the corresponding on-premise user store attributes.
Click Update to save the configurations.

# Disconnect a user store agent

To disconnect a user store agent:

On the Asgardeo Console, go to User Attributes & Stores > User Store
Select your user store from the User stores list.
In the User Store Agent Connection(s) section, click Disconnect on the user store agent that you wish to disconnect.
Select the checkbox to confirm your action and click Confirm.

# Regenerate an installation token

An installation token is used to run a user store agent. Once generated, an installation token is displayed only once.

In case you forget or lose this installation token, you can regenerate it.

If you regenerate a token without disconnecting the user store agent, the agent will be disconnected forcefully. You will need to re-run the user store agent with the new installation token.
If the token is compromised, it is essential to regenerate an installation token.

To regenerate an installation token:

On the Asgardeo Console, go to User Attributes & Stores > User Store
Select your user store from the User Stores list and go to the General tab.
In the User Store Agent Connection(s) section, click Regenerate Token on the user store agent that you wish to regenerate the token for.

# Disable a user store

If you disable a user store, its users will lose access to Asgardeo applications and administrators can no longer view users or groups of that user store in the Asgardeo Console.

To disable a user store:

On the Asgardeo Console, go to User Attributes & Stores > User Stores and select your user store.
Turn on the Disable User Store toggle at the bottom of the page to disable the user store.
You can re-enable a disabled user store by switching off the toggle.

# Delete a remote user store

A user store can be deleted by an administrator. Once a user store is deleted, the action is irreversible.

Once you delete the remote user store the user store agents associated with this user store will be forcefully disconnected.

To delete a user store:

On the Asgardeo Console, go to User Attributes & Stores > User Store and select your user store.
Click Delete User Store at the bottom of the page.
On the pop-up window, type the user store name and click Confirm to delete the user store.