Manage Single Sign-On Users¶
This guide manages the users who log in through single sign-on. Configure single sign-on first.
Give a user access¶
Create a user so that they can log in through the identity provider.
- In the UI, go to Users and click Create. Set:
- Email: the user's email address at the identity provider
- Password: off
- Role: the user's role
- Click Create.
Map groups to roles¶
Map groups at the identity provider to roles so that their members get a role, and a user, when they log in.
1. Send groups to Ella Core¶
- Go to Clients, open the
ella-coreclient, and open the Client scopes tab. - Click
ella-core-dedicated, then Configure a new mapper, or Add mapper > By configuration, then Group Membership. - Set Name and Token Claim Name to
groups. Turn off Full group path. Keep Add to ID token on. - Click Save.
Configure the provider to send the user's groups in a claim, such as groups, as a list of group names or IDs.
2. Map the groups in Ella Core¶
- Go to Single Sign-On and, in Roles from groups, click Edit.
- Set Groups claim to
groups. - Click Add group for each group, and set the group and its role.
- Click Update.
Link a user who has a password¶
Link a user who has a password to their account at the identity provider.
- Log in to Ella Core with the password.
- Go to Profile and click Link display name account.
- Log in at the identity provider.
Unlink a user¶
Unlink a user from their account at the identity provider.
- Go to Users and open the user.
- In Account, click Unlink, then Unlink.
Offboard a user¶
Offboard a user to end their access to Ella Core.
- Remove or disable the user at the identity provider.
- In Ella Core, go to Users, open the user, and click Delete.
To keep the user instead, open the user and:
- In Account, click Unlink, then Unlink.
- Click Remove Password, then Remove, if they have one.
- In API Tokens, delete each token.