Adding or modifying a new INTER-IoT user

(Getting Ready) Scenario description

This recipe describes how a developer or an integrator can create a new user with the interface of the INTER-FW. An INTER-IoT user is capable to use all the APIs of INTER-IoT, has its own set of permission and also has single sign-on (SSO) to all web interfaces of INTER-IoT, including back-office interfaces such as the Identity Manager or the API Publisher. As in all recipes related to the INTER-FW usage, the deployment has very simple requirements: a computer connected to the Internet and access to the Identity Server.

Recipe ingredients

Hardware: One computer, Internet access infrastructure

Software: An operative system. In the example we will use Ubuntu 18.04. INTER-FW deployed locally or in a remote server. Identity server deployed in reachable servers.

(How to Do it) Accessing the user management tab

Step 0. Login with an Administrator user.

Step 1. Click tab 'Users management' of the INTER-FW left menu bar.

Step 2. Press 'Add' button

Step 3. A form appears asking for different details of the user:

• Id (autogenerated): unique identifier of the user. Can't be modified.
• Data registration: current timestamp. Can't be modified.
• Username: domain and user name to be stored in the Identintity Server.
• Password: the code to access INTER-IoT protected features.
• First name, Last name, Address, Phone: personal data of the user (optional)
• Email address: primary contact to the user (used to receive alerts).

(How it Works) Running and collecting results

Once a user is created, it can log in INTER-FW or in the API Manager and the session will be preserved across the different web interfaces.

(More…) How to deploy in a remote server

Alternatively, for large amounts of information in large-scale deployments, the users can be introduced directly to database by creating a SQL script.