General information

A limited number of users can have special role on the platform : platform administrators

Those users have specific access and can troubleshoot issues, create workgroups, assign and modify workgroup quotas, ....

Platform administrators are also allowed to promote other users as platform administrators ( see 'update a user')

In any case, to be able to connect to the mining application, those users must be part of a keycloak group allowed to access the mining application.

Bootstraping the application

At the time of this writing, defining the first platform administrator is not managed via user interface (this is subject of a future evolution), but must be changed in the database.

It needs a first connection from the corresponding user, which will create an entry in the "USERS" table. This user, at first connection, is not assigned any workgroup and has not platform administrator role.

To promote this user as platform administrator, update his entry in database, with the following postgresql command (only possible by an authorized account to the database) :

UPDATE "USERS" SET "IS_ADMIN" = 'True' where "EMAIL" = '<user_email_to_promote@yourdomain.tld>';

This is the recommended option, which allows you to verify that the user is in a correctly configured keycloak group, and that the mining platform is properly configured to access keycloak.

If you do not want to connect the user first, you can directly insert a user in the table (please update the elements between <>, and update the dates and uuid if needed):

INSERT INTO public."USERS" ("ID","FIRSTNAME","LASTNAME","EMAIL","LANGUAGE","LOGO","IS_ADMIN","CREATIONDATE","LAST_SYNCHRONIZATION") VALUES ('1bb8cb62-1e7e-440f-a25c-3f3898687815'::uuid,'<First Name>','<Last Name>','<user_email_to_promote@yourdomain.tld>','EN',NULL,true,'2023-10-31 17:33:20.952+01','2024-10-22 09:27:57.951+02');

Once this modification made, the corresponding user can logout/re-login and access the administration pages for users, workgroups and profiles.

Additional platform administrators can then be promoted by platform administrators in the user interface, by updating a user account

The next important step to initialize your platform will be to Create a workgroup.