Adding departments and users

Departments and users determine the assignment of packages as well as run-time configurations. Deployed packages are assigned to specific departments. Users belong to a specific department that determines the assigned packages. Departments are configured within a three- (or higher) level hierarchy structure that allows for package assignment inheritance. It is a best practice to configure your department hierarchy to match your organizational hierarchy.

Pega Robot Manager™ allows you to create and manage both departments and users as well as associate users to departments.

Use the following steps to add a department from the Actions menu. 

1. In the Robot Manager portal dashboard, click Users to display Users landing page.
   
2. In the Departments tab, click Actions > Add department to open the Add Department dialog box
3. From the Parent department drop-down, select the parent department.
   
   Note: When adding a sub-department, you can select any hierarchy level as the new department parent and enter the department name.
4. In the Name field, enter the name of the department.
5. In the Description field, enter the description of the department. 
6. Click Submit to save the configuration.

Adding sub-departments

You can also add a sub-department from the Departments list.

Use the following steps to add a sub-department.

1. In the Robot Manager portal dashboard, click Users to display the Users landing page.
2. In the Departments tab, select the parent department.
3. To the right of the parent department, click the More icon to view the options list.
4. From the list, click Add sub-department to open the Add new department dialog box.
   
5. In the Name field, enter the name of the department.
6. In the Description field, enter the description of the department. The description field is optional but helps differentiate between departments.
7. Click Submit to save the configuration.

Each role in Pega Robot Manager is associated with an access group that determines the functionality and access. For more information, see the Pega Community article Configuring Pega Robot Manager 8.3.1. 

Before you create users in Pega Robot Manager, you must configure authentication requirements for user roles.

Pega Robot Manager has four predefined user roles:

Pega Robot Manager supports basic authentication and single sign-on (SSO) by using either OAuth 2.0 with SAML bearer assertion or Kerberos. Pega Robot Runtime users authenticate with Pega Robot Manager by using single sign-on authentication while users of other roles authenticate by using basic authentication.

When you create user accounts in Pega Robot Manager, the authentication method assigned to each user is determined by the role specified and the dynamic system setting associated with the role.

For more information about authentication mechanisms, see the Pega Community articles Pega Robot Manager authentication mechanisms and Configuring authentication for Pega Robot Manager 8.3.1.

For users who log in to Pega Robot Manager with basic authentication, the system generates a default password pega. Users must change their passwords by clicking the Forgot password? link on the Pega Robot Manager login page. An extensible activity pyGetGeneratedPassword is also available to set the password per organization security policies.

Follow these steps to add users from the Actions menu: 

1. In the Pega Robot Manager portal dashboard, click Users to display the Users landing page.
2. In the People tab, click Actions > Add user to open the New user dialog box.
3. In the First Name field, enter the user first name of the user.
4. In the Last Name field, enter the user last name of the user.
5. In the Email address field, enter the user email address.
6. From the Department drop-down, select the department.
7. From the Role drop-down, select the user role.
8. From the Status drop-down, select the user status.
9. Required for single sign-on roles: in the UPN field, enter the single sign on user name.
10. Click Submit to save the configuration.
    

You can also add users from the Department details window. Use the following steps to add a user from the Department details window.

1. In the Pega Robot Manager portal, click Users to display the Users landing page.
2. In the Departments tab, click the department to open the department details window.
3. In the Users pane, click Add new to add a new user.
4. Enter the details and click Submit to save the configuration.