6.2. Building the site structure

Originally, a new site is blank. When a device connects to the blank site for the first time, Softnet builds the structure of the site in accordance with the Site Structure data provided by the device. To connect you device to the site, you need the account data of the service entity. Clicking the “account” button displays the service URI and a button to generate a password:

Clicking the “generate password” button creates a password:

For this example, we have the following service URI and password:

    softnet-srv://5287a067-7111-44b6-b20b-76e40caddcc9@ts.softnet-iot.org
    password: W4eUsAisEkvv

Of course, the service account parameters will be different in your case. Enter them into your device and connect it to the blank site. After building the site structure, your device will be represented on the site as a service. Depending on whether your device employs Role-Based Access Control or Plain Access Cotrol, the site obtains an appropriate set of parameters, which we’ll consider next. For more information on using access control, see the chapter “Users & access rights”.

Site with Role-Based Access Control

If your device employs RBAC, the site will be constructed accordingly. As an example, let’s take a Baby Monitor device, which uses two roles Administrator and User to implement different levels of access to the device. The site constructed for our example has the following view:

The site, after building the structure, obtaines a set of additional parameters, which are circled in the following image and described below:

In the descriptions below, a service application is software hosted or embedded in a device that implements an interface for interacting with clients over IP networks. The interface is denoted by the names of service type and contract author, represented in Softnet MS as <Service Type> (<Contract Author>).

  1. Here are placed the names of <Service Type> (<Contract Author>) provided by your device to the site. They indicate the device’s functionality. In case of our example, these names are Baby Monitor (Softnet Free). Of course, the names in your case will be different from our example. Clients you are going to set up on the site must be designed to interact with the given type of device, i.e., the type denoted by the same <Service Type> (<Contract Author>). In case of our example: Baby Monitor (Softnet Free);
  2. If your service application employs versioning, the service version will appear in this place;
  3. Ping period is a sensitive parameter for a device with high mobility that may change its IP address frequently. This topic is discussed in the “Device management” section;
  4. Each service application provides the site with the Site Structure data that can be used to build or rebuild the structure of the site. This topic is discussed in the “Device management” section;
  5. If your service application employs Role-Based Access Control (RBAC), the list of roles will appear in this place. You can assign these roles to domain users;
  6. Here you can select one of the roles listed above as the default role for every domain user. This is useful if you have many users and want to assign to all of them (except dedicated users) one specific role by default rather than explicitly assigning that role to each user;
  7. Some service applications may specify a role that will be assigned to Owner when the site structure is built. In our example, the Baby Monitor has specified the Administrator role to assign to Owner;
  8. Users that do not have any access rights to the service are listed in the DENIED USERS section.

For a detailed description of items 5 to 8 circled in the image above, see the “Users & access rights” chapter.

Site with Plain Access Control

If your device employs Plain Access Control, the domain users will have a full access to the device by the fact of being added to the site. The site constructed for such a device does not have parameters 5, 6 and 7 of an RBAC-based site. Instead of them, it obtains one parameter called “Implicit users” that allows or denies the domain users that are not explicitly added to the site. See the “Users & access rights” chapter for details.

The following image shows the site constructed for our Baby Monitor that uses Plain Access Control:

  • The first four parameters 1,2,3 and 4 are exactly the same as those discussed in the previous section for an RBAC-based site;
  • Parameter 5: “Implicit users” with possible values allowed / denied. This parameter is useful if you have many domain users and want to add all of them (except dedicated users) to the site rather than explicitly adding each user to the site;
  • Parameter 6: users that do not have access rights to the service are listed in the DENIED USERS section.

TABLE OF CONTENTS