Skip to main content

Managing local users

Contributors netapp-lhalbert

You can create local users and assign them to local groups to determine which features these users can access. The Tenant Manager includes one predefined local user, named “root.” Although you can add and remove local users, you cannot remove the root user.

What you'll need
  • You must be signed in to the Tenant Manager using a supported browser.

  • You must belong to a read-write user group that has the Root Access permission.

Note If single sign-on (SSO) is enabled for your StorageGRID system, local users will not be able to sign in to the Tenant Manager or the Tenant Management API, although they can use S3 or Swift client applications to access the tenant's resources, based on group permissions.

Accessing the Users page

Select ACCESS MANAGEMENT > Users.

Tenant users list

Creating local users

You can create local users and assign them to one or more local groups to control their access permissions.

S3 users who do not belong to any groups do not have management permissions or S3 group policies applied to them. These users might have S3 bucket access granted through a bucket policy.

Swift users who do not belong to any groups do not have management permissions or Swift container access.

Steps
  1. Select Create user.

  2. Complete the following fields.

    • Full name: The full name for this user, for example, the first name and last name of a person or the name of an application.

    • Username: The name this user will use to sign in. Usernames must be unique and cannot be changed.

    • Password: A password, which is used when the user signs in.

    • Confirm password: Type the same password you typed in the Password field.

    • Deny access: If you select Yes, this user cannot sign in to the tenant account, even though the user might still belong to one or more groups.

      As an example, you can use this feature to temporarily suspend a user's ability to sign in.

  3. Select Continue.

  4. Assign the user to one or more local groups.

    Users who do not belong to any groups will have no management permissions. Permissions are cumulative. Users will have all permissions for all groups they belong to.

  5. Select Create user.

    Changes might take up to 15 minutes to take effect because of caching.

Editing user details

When you edit the details for a user, you can change the user's full name and password, add the user to different groups, and prevent the user from accessing the tenant.

Steps
  1. In the Users list, select the name of the user whose details you want to view or edit.

    Alternatively, you can select the check box for the user, and then select Actions > View user details.

  2. Make changes to the user settings as needed.

    1. Change the user's full name as needed by selecting the full name or the edit icon Edit icon in the Overview section.

      You cannot change the username.

    2. On the Password tab, change the user's password as needed.

    3. On the Access tab, allow the user to sign in (select No), or prevent the user from signing in (select Yes) as needed.

    4. On the Groups tab, add the user to groups or remove the user from groups as needed.

    5. As necessary for each section, select Save changes.

      Changes might take up to 15 minutes to take effect because of caching.

Duplicating local users

You can duplicate a local user to create a new user more quickly.

Steps
  1. In the Users list, select the user you want to duplicate.

  2. Select Duplicate user.

  3. Modify the following fields for the new user.

    • Full name: The full name for this user, for example, the first name and last name of a person or the name of an application.

    • Username: The name this user will use to sign in. Usernames must be unique and cannot be changed.

    • Password: A password, which is used when the user signs in.

    • Confirm password: Type the same password you typed in the Password field.

    • Deny access: If you select Yes, this user cannot sign in to the tenant account, even though the user might still belong to one or more groups.

      As an example, you can use this feature to temporarily suspend a user's ability to sign in.

  4. Select Continue.

  5. Select one or more local groups.

    Users who do not belong to any groups will have no management permissions. Permissions are cumulative. Users will have all permissions for all groups they belong to.

  6. Select Create user.

    Changes might take up to 15 minutes to take effect because of caching.

Deleting local users

You can permanently delete local users who no longer need to access the StorageGRID tenant account.

Using the Tenant Manager, you can delete local users, but not federated users. You must use the federated identity source to delete federated users.

Steps
  1. In the Users list, select the check box for the local user you want to delete.

  2. Select Actions > Delete user.

  3. In the confirmation dialog box, select Delete user to confirm you want to delete the user from the system.

    Changes might take up to 15 minutes to take effect because of caching.

Related information

Tenant management permissions