Manage site users

This topic describes how to manage site users.

Manage users at the site level

Site admins can delete, activate, and deactivate users from Settings > Site. They can also assign other users the site admin role.

To assign the site admin role to existing users:

  1. In Settings > SiteUsers grid view, select the user who should also be a site admin.

  2. Click to display the Roles column.

  3. Select Site Admin in the Roles column for that user.

Space and workspace admins can also activate and deactivate users. For details, see Activate or deactivate a user.

Back to top

Assign the site admin role to existing users

This section describes how to assign the site admin role to existing users.

Back to top

User management actions

On-premises admins can manage users by adding, editing, or deleting users. For details about managing users on workspace and space levels, see Users.

The following table provides an overview of user-related tasks and which of on-premises admins can perform them.

User management capability Site admin Space admin
Workspace admin
Import LDAP users to a space. For details, see Add LDAP users in ALM Octane .
Import IdP users for SSO authentication. For details, see Import IdP users.
Add existing users from the site into the space. For details, see Add a user.  
Set user passwords.
Assign the site admin role to other users. For details, see Assign the site admin role to existing users (on-premises).
Delete a user. For details, see Manage site users.

Add a user

To add new site users, use the REST API POST method. For details, see POST: Create a user.

Note: Site admins can not add users through the site settings.

Site admins can add existing site users to a space.

To add existing site users:

  1. In Settings> Spaces, select a space in the tree on the left.
  2. On the Users tab, click Include site users.
  3. Select the users to include.
  4. Click Add.

Note: You can disable adding site users to a space in the ENABLE_INCLUDE_SITE_USERS parameter. For details, see Configuration parameters.

Back to top

Change a user's password

Shared space admins, and admins for individual workspaces, can follow these instructions to change another user's password.

Note: As a space admin, you can change passwords for any user, but you cannot change your own password if that is your only assigned role.

To change another user's password:

  1. In Settings , click Spaces and select a space or workspace.

  2. In the Users tab, click a row to select a user.

  3. Click Change Password.

  4. Enter a new password and confirm it.

    Passwords must be at least 8 characters long, and contain at least one capital letter, one lower case letter, and one number or symbol.

  5. Click Change Password.

Back to top

Methods for adding users

This section describes the various methods for adding users.

Use one of the following methods:

Method Details
Native user management system

Add or remove users

Include existing users from the site to a space (on-premises only) Add a user
Include existing users from a space into a workspace Add a user
Import users from an LDAP server

Set up LDAP

Import SSO users from an Identity Provider (IdP)

Note: The users must exist in ALM Octane, but login authentication is done by the IdP.

Set up SSO authentication

Import IdP users

Use the REST API POST: Create a user

Note: Version 12.60 CP10 and later: The ALLOW_WORKSPACE_USERS_CREATION configuration parameter is deprecated. This parameter used to be available for enabling or preventing the admin from adding and including users at the workspace level. Use Settings > Permissions instead.

Back to top

Import IdP users

This section describes how to import Identity Provider (IdP) users for SSO authentication into a workspace (on-premises). You can import users that were already defined in an  IdP to a workspace, without having to reenter the user details.

Prerequisite: Your ALM Octane server is configured for SSO authentication. For details, see Set up SSO authentication.

To import IdP users for SSO authentication into a workspace:

  1. In Settings > Spaces, choose a space in the tree on the left.

  2. In the Users tab, click .

  3. If you have not yet created an import (.csv) file for defining the IdP users, click View Import File Example to download a template. The default name for the template file is import_users.csv.

  4. Modify the import (.csv) file that you created for defining IdP users as necessary.

  5. Navigate to the import file using the Browse button.

  6. Select the workspace to which you want to import the users.

  7. Select the role you want to assign to the users.

    Tip: We recommend that you initially select the Viewer role, and instruct the admin to update the roles at a later time.

  8. Click Import.

Post import steps

Perform these steps after a successful import:

  • If any users were not imported successfully, review the details, make corrections, and re-import.

    You can re-import the entire import file. Users that were already imported successfully are not duplicated. However if you re-import with a different role, these users retain their original role. You can update their roles later using bulk update.

  • You can edit only users' languages and roles.

  • Non-SSO users are still listed in the user list. However, they cannot log into ALM Octane because the login will fail SSO authentication.

  • User activation works as it does for any other type of user. If the user is not active, the user is listed but cannot log in. For details, see Activate or deactivate a user.

Back to top

Delete a user

The operation of deleting a user may take a few minutes.

Note: Before deleting in ALM Octane, SaaS operators should delete the user from the system before deleting the user in ALM Octane.

To delete a user:

  1. In Settings > SiteUsers grid view, select a user.

  2. In the toolbar, click and answer Yes to confirm.

  3. If your site is configured to erase all traces of the deleted user, the following appears.

    Click Delete.

    We strongly recommend that you manage an external file that maps deleted ALM Octane users to reference codes.

    Enter a reference code for the user from this external file.

    Internally, references to the user are replaced by this reference code in ALM Octane.

    If you do not enter a reference code, the user is not deleted.

    For details on how to configure the site to erase deleted users' details, see FORGET_USER_ON_DELETE under Configuration parameters.

    Setting the value for this parameter only affects how users are deleted from this point forward, not retroactively.

Tip: You can also delete multiple users using the REST API. For details, see DELETE: Delete users .

Back to top

See also: