Accounts

The PureLife Cloud has two different kinds of accounts:

  1. User. This is a real person with contact information who can receive messages by our cloud.
  2. Bots. This is another server or application and used for machine-to-machine (M2M) communication.

User

To manage users you need to have the permission Manage users.

Add user

1. Open the user overview in the navigation tab.

2. Click on the icon at the right side to open the user menu.

3. Click on Create user.

4. Fill out the form with the information and click Add.

Login expiration date

In some cases it is necessary that a user is only able to log in for a certain time to have access to the dashboard. It is possible to configure an expiration date until the log in is possible.

1. Open the user overview in the navigation tab.

2. Click on the icon at the right side behind a user to open the user properties.

3. Enable the option Can login to allow the log in

4. With a click on the three dots Set login expiration date you can configure the expiration date

5. Choose a date in the future until the login should be possiblem and click on Set. The expiration date become effective at 00:01 am.

Add avatar

After you add a user you can upload an avatar to his/her profile to identify the person by a small picture.

1. Open the user overview in the navigation tab

2. Click on the icon at the right side behind a user to open the user properties

3. Select a avatur and choose a proper picture. Valid size of the picture is: 6048 x 4032 pixel (24 mega pixel) with maximum 36 mega byte.

4. The avatar is active direct after upload.

Change permissions

Permissions can only be managed with the access right Manage users.

In an environment with several users and different tasks it could be necessary to grant some permissions to some users to fullfil their tasks.

1. Open the user overview in the navigation tab.

2. Click on the icon at the right side behind a user to open the user properties.

3. Select the tab Permissions to see the permissions.

4. Change and edit the permissions respective your needs and the users tasks and responsibility.

5. Click on Save so save the changes.

Bots

To manage bots you need to have the permissions Manage bots.

Add bots

  1. Open the user overview in the navigation tab.

2. Click on the icon at the right side to open the user menu.

3. Click on Create bot.

4. Fill out the form with the information and click Hinzufügen.

Add webhooks

This section describes how to add a webhook to the cloud. If you are a developer and want to receive information by a webhook you should take a look to our Integration document.

The PureLife Cloud supports webhooks for an easy and fast integration of external applications. You can use webhooks for bots or for complete customers. A webhook for bots is used within the rules to receive events and notifications by the webhook. This is our recommendation if a pre-filtering and analyze of the events should take place by our cloud.

1. Open the user overview in the navigation tab.

2. Select the bot you want to add a webhook to.

3. Change to the tab Webhooks.

4. Click on Add webhook to add a webhook.

5. Fill out the form.

  • In the field Payload-URL enter the url to which the http request should be send to.
  • Choose one of the Content-Typ, to define the format of the request body of the event. Available are:
    • application/json
    • application/xml
    • application/x-yaml
    • application/toml
    • application/x-www-form-urlencoded
  • Select the authentication in the field Authentisierung. Available are:
    • Bearer-Authentisierung
    • X-Api-Key (IETF RFC)
    • X-API-KEY (Case Sensitive)
    • HTTP/Basic
  • Choose one of the Format to define the layout the events are send. Available are:
    • PureSec
    • Custom 1
    • Sensor raw data
  • Enter a Secret to prove the authenticity of this webhook.

6. Click on Save to save the settings.

After that the bot can be used within the rules to send events to your webhook integration.

Add ESPA

This section describes how to configure the ESPA settings to the cloud. The server-side connection to a ESPA system has to be configured on system level. Please get in touch with PureSec to talk about the details.

The PureLife Cloud supports ESPA IP for external alerting to a ESPA System. THe ESPA settings can only by configured once per bot. Bots with ESPA settings can be used within the rules to get informed about them over the ESPA interface.

1. Open the user overview in the navigation tab.

2. Select the bot you want to add the ESPA settings to.

3. Change to the tab ESPA.

4. Fill out the form with the corresponding settings to your ESPA system.

  • Enter the identifier of the content of the message in the field Header. Availble are:
    • Call to pager
    • Status information
    • Status Request
    • Call to subscriber line
    • Sonstige Informationen
  • Enter the address Adresse of the pager-(group-)address of phone number, max. 16 characters.
  • Select the ringtone Klingelton. Available values are:
    • keiner
    • 0 - reserviert
    • 1 bis 9 - systemabhängig
  • Select the priority Priorität the events are send. Available are:
    • keine
    • Reserviert
    • Alarm (Notfall)
    • Hoch
    • Normal

5. Click on Speichern to save the settings.

After that the bot can be used within the rules to send events to your ESPA system.