Code Docs

ARBITRE Docs

In Arbitre, users are created and managed using Keycloak.

Creating an user account

Create a user account in Keycloak and provide the user a temporary password. See Keycloak documentation

<aside> ⚠️ Make sure to include an email address in the Keycloak user account. Otherwise, the user won’t be able to connect to Arbitre.

</aside>

Upon logging in, the user will be prompted to chose a new password.

Then, a Django user will be automatically created, with the same username and email.

The user only exists in Django after the first Keycloak log-in.

Keycloak and Django users are linked through email address. Do not change the email address on either sides.

<aside> ⚠️ Althought the Django administration lets you create users directly, always create users in Keycloak.

</aside>

Creating a teacher account

1. Create a regular user account following Creating an user account
2. Go to “Role Mapping” tab

1. Make sure to filter by Realm roles
2. Click “Assign Role”
3. Select “teacher” and confirm

<aside> ⚠️ The “teacher” role should always exist. Arbitre will create it if it is missing on startup.

</aside>