Setup Keycloak for VRS
Follow the below steps 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
![](../../__attachments/79069187/Screenshot%202024-01-23%20at%205.20.22%E2%80%AFPM.png?inst-v=5fefeec5-d207-400b-a1e4-253c22c7d019)
Enter Realm name and click on the Create button
![](../../__attachments/79069187/Screenshot%202024-01-23%20at%205.20.33%E2%80%AFPM.png?inst-v=5fefeec5-d207-400b-a1e4-253c22c7d019)
Once Realm is created, click on clients under the created realm and then click create client button
![](../../__attachments/79069187/Screenshot%202024-01-23%20at%205.20.45%E2%80%AFPM.png?inst-v=5fefeec5-d207-400b-a1e4-253c22c7d019)
Enter Client ID vrs and click on Next.
![](../../__attachments/79069187/Screenshot%202024-01-23%20at%205.20.59%E2%80%AFPM.png?inst-v=5fefeec5-d207-400b-a1e4-253c22c7d019)
Toggle the Client authentication and Authorization to ON, click Next, and Click Save
![](../../__attachments/79069187/Screenshot%202024-01-23%20at%205.23.55%E2%80%AFPM.png?inst-v=5fefeec5-d207-400b-a1e4-253c22c7d019)
Once the client is saved, go to 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)
![](../../__attachments/79069187/Screenshot%202024-01-23%20at%205.24.28%E2%80%AFPM.png?inst-v=5fefeec5-d207-400b-a1e4-253c22c7d019)
Click on Realm Roles in left panel and create a role with name admin
![](../../__attachments/79069187/Screenshot%202024-01-23%20at%205.24.39%E2%80%AFPM.png?inst-v=5fefeec5-d207-400b-a1e4-253c22c7d019)
Go to Users and create user by entering Username and click Create.
![](../../__attachments/79069187/Screenshot%202024-01-23%20at%205.25.03%E2%80%AFPM.png?inst-v=5fefeec5-d207-400b-a1e4-253c22c7d019)
Go to the Credentials tab of the created user and set a password, toggle the Temporary button to OFF, and click Save.
![](../../__attachments/79069187/Screenshot%202024-01-23%20at%205.25.13%E2%80%AFPM.png?inst-v=5fefeec5-d207-400b-a1e4-253c22c7d019)
Go to the Roles Mappings tab on created user details, click on Assign Role, select the admin role and click on Assign
![](../../__attachments/79069187/Screenshot%202024-01-23%20at%205.25.34%E2%80%AFPM.png?inst-v=5fefeec5-d207-400b-a1e4-253c22c7d019)
This created user should be able to login to VRS once Keycloak env variables are updated in config.env and ./install.sh executed.