Register a user

User authentication is one of the main prerequisites in order to use our demo applications.
The demo application uses Basic Authentication. This type of authentication is provided for example by Bosch IoT Permissions, another service of the Bosch IoT Suite family.
Since you might have gone already through the Things service booking dialog, the procedure to book an instance of Bosch IoT Permissions service is quite similar.

Book the service

Use the Bosch IoT Suite portal as an entry point.
https://developer.bosch-iot-suite.com/

  1. Click my account icon My Account (My Bosch ID) and Sign in with your Bosch ID
    • In case you do not have an account yet, register a new one (Sign up for an account).
    • After logging in you will be re-directed to the Suite.
  2. Click my subscription list iconMy Subscriptions
    • Click New Subscription
    • Select Bosch IoT Permissions
    • Set your Instance Name (this must be unique)
    • Click Subscribe and confirm on the cost summary page by clicking Subscribe again.
    • The Status will be Provisioning while the service subscription is being created.
    • In case the Status is still not Active after some seconds, click the Refresh button.
  3. Click Show Credentials to see your access credentials.\ The example shows the structure of the credentials

    {
    "imAdminUiUrl" : "https://permissions.s-apps.de1.bosch-iot-cloud.com/service-ui?user-tenant=imTenantName",
    "imClientSecret" : "xxx",
    "imApiKeyId" : "xxx",
    "imTenantId" : "xxx",
    "apiUrl" : "https://permissions-api.s-apps.de1.bosch-iot-cloud.com",
    "imServerUrl" : "https://permissions-api.s-apps.de1.bosch-iot-cloud.com/",
    "imLoginUrl" : "https://permissions.s-apps.de1.bosch-iot-cloud.com/service-ui/login?user-tenant=imTenantName",
    "imClientId" : "xxx",
    "imTenantName" : "xxx"
    } 

Congratulations, you have created an own Bosch IoT Permissions service instance, with an own tenant.
The user with the Bosch ID used for this subscription, is automatically the administrator of your Permissions instance.

Create a user

To create a user within your own tenant, go to the Permissions service Dashboard and use the User Management view.
tip If you navigate from https://accounts.bosch-iot-suite.com/subscriptions to the Bosch IoT Permissions service dashboard, your authentication with the Bosch ID is still valid, thus the dashboard will show that you are already logged in.
The Bosch ID is automatically derived into a user with administrative privileges.

  • Click the “add user” icon add-user-icon.
  • The Users column will display a form for completing all the information required to create a user.
  • You must complete at least all required fields in the dialog box (marked !)
    Add user
    • Username: The Username must consist of alphabetic and numeric characters. Blanks are allowed, but not as the first or last character.
    • Password: A password.
    • Password (Verification): Repeat the password.
  • Confirm by clicking Save & Close at the bottom of the dialog box.

The new user is now available and will be displayed in alphabetical order in the Users column.

tip Bosch IoT Permissions’ password rules are configured to require each user (created by an administrative user) to change his password.
Find the details of how your own tenant is configured at “Edit password rules”. These settings will apply for all users you create in the context of this tenant.
password rules

tip The tenant name is displayed right above the toolbar.
Copy the tenant name to your clipboard, as you will need it, when authenticating at the Things demo application.
tenant name

Logout as the a administrative user

The “Sing out from Permissions” button can be found at the context menu.

At the top right click your user to see it.

Login as the a new user

Open a new browser tab https://permissions.s-apps.de1.bosch-iot-cloud.com/service-ui/login

  • Use the provided dialog to sign in with your new user.
    log in new user
  • Upon successful login you will be asked to change your password.
  • Log out using the “Sign out from Permissions” button.

Congratulations,
you have now a user who can perform the Things demo scenario.

note The Inventory Browser application provides only two fields for authentication.
There you will need to set the tenant name in the same field as the username separated by a backslash:
E.g. *YourTenantName*\eval-user-01

tip For your real use cases which imply application roles and permission management please contact the Bosch IoT Permissions service.

Imprint Legal info Privacy statement