Creating and modifying Sedona users and roles

A prerequisite is the station has a SedonaUserManager (SedonaUserManagementService) in its Services container. If not present, open the sedonanet palette and drag the SedonaUserManager into the station’s Services container.

Creating new Sedona users

  1. Expand the station’s Services container to reveal the SedonaUserManager > User Service.



  2. Double-click the User Service for the Sedona User Manager view.

  3. In the Sedona User Manager, click New. A popup New dialog appears.



  4. In the New dialog, either accept 1 as the number to add, or type in another number to add multiple users. Click OK. A second New dialog appears.



  5. For each user (two shown above), change the default (and invalid) “SedonaUser” to a valid name for the resulting User component(s) to be created later in Sedona apps, and also enter a password.

    NoteName must be from 1 to 7 alphanumeric characters, is case-sensitive, and must begin with a letter and have no spaces or punctuation, apart from underscore (_). These naming restrictions reflect Sedona component naming guidelines. If you try entering names that fall outside these guidelines, an error results, and the users are not added.

    If creating multiple users in this dialog, click to select (highlight) each user to edit Name and Password.



  6. After naming the user(s) and assigning passwords, click OK in the New dialog.

    The user or users are added, as shown below.



  7. If needed, add additional new users by clicking New in the Sedona User Manager (Step 3).

You can also edit (modify) Sedona users by double-clicking them in the Sedona User Manager, which produces an Edit popup dialog, identical to the second New popup dialog. In the Edit popup dialog, you can modify both name and password for any user.

You can also delete Sedona users, via the right-click shortcut menu on any selected user.

NoteIf modifying or deleting a user that has been mapped to one or more networked Sedona devices, this results in a synchronization task to make corresponding changes in those device’s Sedona app. For related details, see User Synchronization.

Creating new Sedona roles

  1. Expand the station’s Services container to reveal the SedonaUserManager > Role Service.



  2. Double-click the Role Service for the Sedona Role Manager view.

  3. In the Sedona Role Manager, click New. A popup New dialog appears.



  4. In the New dialog, either accept 1 as the number to add, or type in another number to add multiple roles. Click OK. A second New dialog appears.



  5. For each role (three shown above), optionally change the default name “SedonaRolen” to a another more descriptive and unique name.

    NoteSedona name restrictions do not apply to user roles, as roles do not have direct component representation in a Sedona app. Therefore, Niagara component names over 7 characters are allowed.

    Wait until after the next two steps before clicking OK.

  6. For each role, click the Permissions control for a separate Permissions popup dialog, and click in cells to toggle (set or clear) permissions in the four Sedona component groups.



    Initially (if a new role), all component group permissions are cleared. As needed, click on the “Clear All” or “Set All” text to clear or set all permissions. Then continue to click in individual cells to toggle.

    Click OK to set the role’s component permissions and return to the previous New dialog (and to the next step, to set provisioning permissions).

  7. For each role, click the Provisioning control for a separate Provisioning popup dialog, and click in check boxes to toggle (set or clear) permissions for the three provisioning types.



    Initially (for any new role), all provisioning permissions are cleared. The example role above is being configured to all app provisioning (Get and Put via the Application) and kits provisioning (via Kits Manager), but not provisioning changes to the Sedona virtual machine (SVM).

    Click OK to set the role’s provisioning permissions and return to the previous New dialog.



  8. After reviewing names for the role(s) and assigning each role component Permissions and Provisioning permissions (see example shown above), click OK in the New dialog.

    The role or roles are added, as shown below.



  9. If needed, add additional new roles by clicking New in the Sedona Role Manager (Step 3).

You can also edit (modify) Sedona roles by double-clicking them in the Sedona Role Manager, which produces an Edit popup dialog, identical to the second New popup dialog. In the Edit popup dialog, you can set or clear permissions on any of the three provisioning types.

You can also delete Sedona roles, via the right-click shortcut menu on any selected role.

NoteIf modifying or deleting a role that has been mapped to one or more networked Sedona devices, this results in a synchronization task to make corresponding changes in those device’s Sedona app. For more details, see User Synchronization.