Setup Keycloak for VRS

Follow the steps below for setting up Keycloak for VRS

Go to FQDN:8088/auth and click on the Administration console
Log in to the administration console using the password set in environment variables (KEYCLOAK_USER and KEYCLOAK_PASSWORD). The default username is admin, and the password is admin
Bring the cursor to the Master (below the Keycloak logo) and click on the Create realm button

Screenshot 2024-01-23 at 5.20.22 PM.png

Enter the Realm name and click on the Create button

Screenshot 2024-01-23 at 5.20.33 PM.png

Once the Realm is created, click on clients under the created realm, and then click the create client button

Screenshot 2024-01-23 at 5.20.45 PM.png

Enter Client ID vrs and click on Next.

Screenshot 2024-01-23 at 5.20.59 PM.png

Toggle the Client authentication and Authorization to ON, click Next, and click Save

Screenshot 2024-01-23 at 5.23.55 PM.png

Once the client is saved, go to the Credentials tab and copy the client secret. The Client ID (vrs) and Secret will be used in environment variables (KEYCLOAK_CLIENT_ID and KEYCLOAK_CLIENT_SECRET)

Screenshot 2024-01-23 at 5.24.28 PM.png

Click on Realm Roles in the left panel and create the desired roles, i.e., admin and agent.

Screenshot 2024-01-23 at 5.24.39 PM.png

Go to Users and create user by entering Username and click Create.

Screenshot 2024-01-23 at 5.25.03 PM.png

Go to the Credentials tab of the created user and set a password, toggle the Temporary button to OFF, and click Save.

Screenshot 2024-01-23 at 5.25.13 PM.png

Go to the Roles Mappings tab on the created user details, click on Assign Role, select the desired role, and click on Assign.

While role mapping, the default roles should be kept assigned to the user for the purpose of authentication and authorization.

This created user should be able to log in to VRS once the Keycloak env variables are updated in config.env and ./install.sh executed.