Create and Edit Users - SEPIA-Framework/sepia-docs GitHub Wiki

Control-HUB (Admin-Tools)

The SEPIA Control-HUB (aka admin web-tools) can be used to manage your users. In SEPIA-Home they are already included and hosted via the SEPIA-Assist server. You should be able to open them via a link like this:
http://[my-sepia-assist-ip]:20721/tools/index.html

There is also a public version at https://sepia-framework.github.io/tools/index.html but please note that you need to set up your SEPIA server with an SSL certificate (HTTPS access) to be able to use it (cross-origin security).

Login to the tools

To edit a user you first need to log-in as admin to the SEPIA-Assist server (your authentication server). When you open the tools you'll see a login-box. Extend the box (the little arrow at the bottom of the box) and check the server address, it should look like this http://[my-sepia-assist-ip]:20721/ or this http://[hostname].local:20721. When you are using the proxy with SSL it might also look like this https://my.server.com/sepia/ or for self-signed SSL https://[hostname].local:20726/sepia/. Enter your admin username (default is uid1003 or [email protected]) and password (set during setup) and press 'login'.

Create new user

If you switch to the 'User Management' page you can now create new users or edit user roles. Depending on how your SEPIA-Assist server is set up you have to white-list users first (default setting) before you can create them.
To create a new user enter an email address (can be fake but a real one might be handy in the future for user self-service) then press 'put on whitelist' and you should see a success message. After that add the password for the user and press 'create'.

Edit user roles

So features of SEPIA are restricted and require certain user-roles to work like smart home access for example. To modify user roles enter the 'UserID' of the user you want to edit and press 'get roles'. You should see the user's existing roles in the input field now. Add the role 'smarthomeguest' to the field like this user, smarthomeguest (keeping the existing entries) and press 'set roles'. Done :-)
Please note: You CANNOT modify the roles of the two core accounts ('superuser' and 'assistant').