This manual is only valid for Micro X rootadministrators.

NOTE: The following description refers to Keycloak v. 23. A similar procedure is also valid for earlier versions with slight differences.

1. Go to hostname_of_snap4_distribution/auth/;
   

   

2. You will see a login page, for which you will need the credentials for the keycloak administrator (by default the username is admin, the password is found in the generated files of the distribution);
   
3. In the main menu on the left, select Clients;
   
4. Create a client;
   
5. Fill the form with your data, then create the client_id;
   
6. The client is now operative, but not fully integrated with the snap4tech configuration yet;
   
7. Go to Client scopes and select “ClientID_name”-dedicated (in the image it’s “test-dedicated”);
   
   
8. Add the “username” predefined mapper;
   
   
9. Add a new mapper by configuration, selecting “User Realm Role”;
   
10. In the newly opened view, put “role” in the name and “roles” in the Token Claim Name, then save.