Users and Groups

Create groups and assign user accounts to the groups to group related users. Users can belong to one or more groups. Use groups to more efficiently manage user accounts.

For example, let's say that you have multiple data engineers who perform the same tasks. You create a Data Engineer group and assign all data engineers to that group. Then you assign roles to the Data Engineer group, so that each user within that group has the same roles. If you need to change the roles, you can change the role assignment once on the group, rather than changing the roles for multiple times, once for each user account.

Control Hub provides a default all@<organization ID> group that includes every user in the organization.

You can assign roles to both users and groups. If you assign roles to a user and also assign roles to a group that the user belongs to, the user has the union of all roles.

Changes to existing groups and user accounts take effect the next time the user logs in.

Creating User Accounts

Create a user account to allow a user to perform tasks in Control Hub and registered Data Collectors. When you create a user, Control Hub sends an email to the associated email account with a temporary password.

  1. In the Navigation panel, click Administration > Users.
  2. Click the Add New User icon: .
  3. On the Add User window, configure the following properties:
    User Account Property Description
    User ID User ID for the account. Use the following naming convention:
    <ID>@<organization ID>
    Display Name Display name.
    Email Address Email address for the account.
    SAML User Name SAML identity provider user account to map to this Control Hub user account.

    Configure when SAML authentication is enabled for the organization. If not using SAML authentication, you can leave the default value which is the same as the email address for the account.

  4. Optionally, assign the roles that you want the user to have.

    To encourage development and testing, each new user and new group can perform most tasks in Control Hub and all registered Data Collectors. Change those role assignments as needed to secure the integrity of your organization and data.

    For a description of each role, see Role Descriptions.

  5. Optionally, add the user to groups.
    Tip: To more efficiently manage user accounts, assign one of the Organization roles to the user, and then clear all other roles. Then add the user to a group that has the appropriate roles. You can add the user to groups while you create the user account or after you create the user account.
  6. To enable access to Control Hub, make sure the Active property is selected.
    You can use this option to disable access to Control Hub and registered Data Collectors without deleting the user account.
  7. Click Save.

Creating Groups

Create groups to group related users so that you can more efficiently manage user accounts.

  1. In the Navigation panel, click Administration > Groups.
  2. Click the Add New Group icon: .
  3. On the Add Group window, configure the following properties:
    Group Property Description
    Group ID Group ID for the group. Use the following naming convention:
    <ID>@<organization ID>
    Display Name Display name.
  4. Assign the roles that you want the group to have. Each user account added to the group is assigned the same roles.
    To encourage development and testing, each new user and new group can perform most tasks in Control Hub and all registered Data Collectors. Change those role assignments as needed to secure the integrity of your organization and data.

    For a description of each role, see Role Descriptions.

  5. Click Save.
    After creating the group, you can add users to the group.

Adding Users to Groups

Create groups and add user accounts to groups to more efficiently manage user accounts.

To add a user to a group, you can modify the user account or the group.

  1. In the Navigation panel, click Administration > Users, or click Administration > Groups.
  2. Click the row listing the user or group to display its details.
  3. In the bottom left corner of the details, click in the area under User Groups or Group Users, then select the group to add to the user or the user to add to the group.
  4. Click Save.

Activating or Deactivating User Accounts

User accounts must be active to log in to Control Hub and registered Data Collectors.

Before you can delete a user account, you must deactivate the account. Or if needed, you can temporarily deactivate a user account to disable access to Control Hub and registered Data Collectors without deleting the user account.

  1. In the Navigation panel, click Administration > Users.
  2. Click the row listing the user to display its details.
  3. Under the User Roles, select the Active property to activate the user. Clear the Active property to deactivate the user.
  4. Click Save.

Resetting a Password

When needed, you can reset a password for a user account.

  1. In the Navigation panel, click Administration > Users.
  2. Click the row listing the user to display its details.
  3. In the bottom right corner of the details, click Reset Password.
    The user receives an email with a temporary password.