Skip to content

You are viewing documentation for Immuta version 2.8.

For the latest version, view our documentation for Immuta SaaS or the latest self-hosted version.

Immuta Identity Manager

Audience: User Admins

Content Summary: The Immuta IAM uses basic username and password authentication and is managed on the Admin page of the Immuta UI.

This page details how to manage users, permissions, groups, and attributes within Immuta. Additionally, instructions for downloading Immuta metrics are included.

Note: To perform the actions on this page, the USER_ADMIN permission is required. (See Permission and Attribute Overview for more information on user permissions.)

Managing Users

The following sections describe how to manage user accounts in Immuta.

Creating Users

  1. Click the Admin icon in the left sidebar and select the Users tab.
  2. Click the Add User button in the top right of the page.

    Add User Button

  3. Fill out the FULL NAME and EMAIL fields in the dialog. Note: The user's email address will be used as the username and must be unique.

  4. Click the Create button.

    Add User Dialog

Disabling Users

  1. Click the Admin icon in the left sidebar, and then select the Users tab.

  2. Select the user you would like to disable, and click the dropdown menu button in the upper right of the user details page.

  3. Select Disable.

    Delete User

  4. Click Disable in the confirmation dialog.

Managing User Permissions

The following sections describe how to manage permissions for a given user. For more information on user permissions, see the Permission and Attribute Overview.

Add Permission to User

  1. Click the Admin icon in the left sidebar, and select the user from the Users tab.

  2. Scroll to the Permissions section on the user details page, and click Add Permissions.

    Add Permission Link

  3. Click the Select Permission dropdown, and select the permission.

    Select Permission

  4. Click Close.

Remove Permission from User

  1. Click the Admin icon in the left sidebar, and select the user from the Users tab.

  2. Scroll to the Permissions section, and click the X on the permission pill you want to remove.

    Remove Permission

Managing Groups

The following sections describe how to manage groups for a given user. For more information on groups, see the Permission and Attribute Overview.

Create Group

  1. Click the Admin icon in the left sidebar, and then select the Groups tab.
  2. Click the Add Group button in the top right of the page.

    Add Group Button

  3. In the dialog, enter a unique group name. You can opt to enter a description of and email address for the new group.

  4. Click Save.

Add User to Group

  1. Select the group from the Groups panel.

  2. Scroll to the Members section, and click the Add Members button.

    Add Group Members Button

  3. Begin typing in the Search by Name or Email text box.

  4. Click on the name from the dropdown list to add this user to the group, and then click Close.

Alternatively,

  1. Click the Admin icon in the left sidebar, and select the user from the Users tab.

  2. Scroll to the Groups section, and click the Add User to Groups button.

    Assign User to Groups Button

  3. Begin typing in the Group Name text box, and select the group from the dropdown list that appears.

  4. Click Close.

    Assign User to Groups Link

    Note: If no groups match, the dropdown will be empty.

Remove User from Group

  1. Select the group from the Groups tab.

  2. In the Members section, click the delete button to the right of the member you want to remove.

    Remove Group Member

  3. Click Delete to confirm.

Alternatively,

  1. Click the Admin icon in the left sidebar, and select the user from the Users panel.

  2. Scroll to the Groups section, and click the delete button to the right of the group you want to remove.

    Assign User to Groups Link

  3. Click Delete in the confirmation window that appears.

Remove Group

  1. Select the group from the Groups panel.

  2. Click the dropdown menu in the top right of the group details, and select Delete.

    Remove Group

  3. Click Delete to confirm.

Managing Attributes

The following sections describe how to manage attributes for a given user or group. For more information on user attributes, see the Permission and Attribute Overview.

Add User or Group Attribute

  1. Click the Admin icon in the left sidebar, and click the Users or Groups tab at the top of the page.
  2. Select the user or group you would like to manage.

  3. Scroll to the Attributes section, and click Add Attributes.

    Add Attributes Button

  4. Begin typing in the Enter Attribute text box.

    • If the attribute already exists:

      • Select the attribute from the dropdown list.

        Add Existing Attribute

    • If the attribute does not exist:

      • Enter a name for the attribute, and then select this new attribute from the dropdown.

        Add Existing Attribute

  5. In the Attribute Value text box, enter the name of the value you want to add to the attribute.

    • If the value already exists:

      • Select the value from the dropdown list.
    • If the value does not exist:

      • Enter a value, and then select this new value from the dropdown.

        Add Existing Attribute Value

  6. Click Close.

Remove User or Group Attribute

  1. Click the Admin icon in the left sidebar, and select the Users or Groups tab.

  2. Select the user or group you would like to manage.

  3. Scroll to the Attributes section, and click the Delete icon to the right of the attribute you would like to remove. Note: This action will remove the attribute and all of its values.

    Remove Attribute

  4. Click Confirm.

Remove Attribute Value

  1. Click the Admin icon in the left sidebar, and select the Users or Groups tab.

  2. Select the user or group you would like to manage.

  3. Scroll to the Attributes section, and click the X on the attribute value pill you want to remove.

  4. Click Confirm.

Managing Licenses

Adding a License Key

  1. Navigate to the Licenses tab on the Admin page.
  2. Click Add License Key in the top right corner of the page, and then paste the license key provided to you by Immuta in the dialog that appears.

    Add License Key

  3. Click Save, and the system will generate a unique user id (UUID) for the license, which will appear at the bottom of the page.

    Licenses Tab

Deleting a License

  1. Click the delete icon in the Actions column of the license you would like to delete.
  2. Click Confirm in the dialog that appears.

    Delete License

Note: If you delete a license key, your compliance may be affected and you will need to contact your Immuta Support Professional to receive a new license key.

Downloading Metrics

  1. Click the Licenses tab on the Admin page.
  2. Click the dropdown menu in the top right corner of the page and select Download Metrics for Immuta.

    Immuta Metrics

  3. Complete the Number of Days field in the dialog that appears, and then click Download to download the JSON file.