Skip to content

Create and Edit Users

Jump to bottom
Florian Quirin edited this page Mar 30, 2022 · 8 revisions

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). The default username is uid1003 or [email protected] and the password has been set during setup. 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 http://raspberrypi.local:20721. When you are using the SEPIA Proxy with SSL it might also look like this: https://my.server.com/sepia/. Enter your admin user-name and password and press 'login'.

NOTE: In older versions (SEPIA HOME < v2.2.0) you will not see the login-box. Instead enter your server address into the 'Custom Server' field and use the button below to 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').

Clone this wiki locally