# Manage Users

## Overview

A user was initially specified and created during the deployment process. As with any new user, you were required to change your password as you signed in for the first time. The `Manage Users` section of the console is to extend the management of user(s) beyond that initial setup. From the Manage Users page you can create additional users (assuming your user is an `Admin`), delete users and modify users in the form of assigning them to groups and changing their roles.

## Manage Users

Managing users involves creating, modifying, deleting or activating/deactivating their accounts. At the time of creation you will also assign them one or multiple [groups](https://help.cloudstoragesec.com/console-overview/access-management/group-mgmt) to belong to. You can change the group assignment later as well.

{% hint style="info" %}
You may not be using Groups to organize your accounts. There is always one group created by default, the Primary group. In this situation you would specify Primary as the group value.
{% endhint %}

As seen below you are presented a simple page with the list of existing users. Directly after install you will only have one user in the list that was created during deployment. You can add more users as desired from this page and they will be reflected here as well.

![User List](https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2FwdGaPD0TCvHxXmPSLGuT%2Fuser-list.png?alt=media)

### Create User

Creating a new account is a simple process. Click the `Create User` button.

![Create User Menu](https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2FgCjC4nsKOAPxWfXBAXdm%2Fcreate-user-menu.png?alt=media)

Provide a `User Name`, a valid `Email Address`, the `User Access Level` and a `Group` to belong to. An email will be sent to the specified email address with a login URL and `Temporary Password`. There are four`User Access Levels`: `Admin`, `User`, `Read Only`, and `API`. The difference being `Admin` has access to all screens and configuration capabilities, while the `User` will not be able to create additional users or modify any of the configuration. `Read Only` users cannot perform actions. They can view pages, metrics, etc. but they cannot protect buckets, make changes, etc. `API` access level allows a user to execute API calls, but not login to the console at all.

{% hint style="info" %}
`User` account types can see all dashboards and buckets and can enable / disable buckets.
{% endhint %}

![Create Account](https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2FnpFUGArk57ynYjM3pwra%2Fcreate-user.png?alt=media)

After creating the new user, they will be in a `pending` state until they have logged in and reset their password. They have 7 days to complete this with the password that was sent to them. After that time period, you will have to delete and recreate the user.

![Create Account Pending](https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2FvgICDWT2tZjjcRWIrGdq%2Fcreate-user-pending.png?alt=media)

### Modify User

To modify an existing user, select the action menu (![user menu](https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2FBF3Bmp54vik9pPUTCszs%2Fuser-menu.png?alt=media)) on the particular user's row. Now select the appropriate action you'd like to take: Change Groups, Change Role, Disable User or Enable API Access. If the user has already been disabled you will be given an option to delete the user.

![Modify User](https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2FupoleSGuu8szZNp8WzPr%2Fmodify-user.png?alt=media)

#### **Change Groups**

Selecting `Change Groups` pops open the following:<br>

<figure><img src="https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2FP7fVzspmdItLG5zadEcB%2Fuser-change-groups.png?alt=media" alt=""><figcaption></figcaption></figure>

#### **Change Role**

Selecting `Change Role` pops open the following:<br>

<figure><img src="https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2F51Yt85PTOlHyyP8UkqwE%2Fuser-change-role.png?alt=media" alt=""><figcaption></figcaption></figure>

#### **Disable and Delete User**

In order to delete a user, you must disable the user first.

<br>

<figure><img src="https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2FqfVbKpzyqSjU8TfBHL05%2Fuser-disable.png?alt=media" alt=""><figcaption></figcaption></figure>

<br>

<figure><img src="https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2Fdhu5ynRly3GZcMzgjWyq%2Fuser-delete.png?alt=media" alt=""><figcaption></figcaption></figure>

<br>

<figure><img src="https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2FLinwlhjL0vyusJHsbhFt%2Fuser-delete-confirm.png?alt=media" alt=""><figcaption></figcaption></figure>

#### **Setup for API Scanning Access**

Setting up API Access for a user enables their username and password to be used to send file scan requests against the configured API Agents. You must associate a user to an Account Number track usage. Because API scanning can operate outside the bounds of Amazon S3, we have to fabricate a usage tracking mechanism. So any API file scanning this user does will be tied to the Account Number associated.

To enable a user for API access you select the Actions menu for the user and select `Enable API Access`<br>

<figure><img src="https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2FRzG02kgTD4RppJto179w%2Fuser-enable-api.png?alt=media" alt=""><figcaption></figcaption></figure>

You'll be prompted to pick an account to associate to the user and then click the `Enable Access` button<br>

<figure><img src="https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2F9G4Nw99fgVsWUrsnuQtD%2Fuser-enable-api-account.png?alt=media" alt=""><figcaption></figcaption></figure>

Afterwards you will notice they have an Account Number showing under the API Account column<br>

<figure><img src="https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2FmDRAkXvzej2rPted5yJk%2Fuser-enable-api-post.png?alt=media" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If you want to create an api-only user without console access, make sure to set the role to `API`
{% endhint %}

For more information on API based file scanning and what APIs are available, check out the [API Scanning Overview](https://help.cloudstoragesec.com/how-it-works/object-scanning#api-driven-scanning) page.

## Change Password

To change your own password, you will select the user icon ![User icon](https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2F137qjkzflIRDuHB0Vn1U%2Fuser-icon.png?alt=media) in the upper right corner of the console and select `Change Password` from the menu.

<br>

<figure><img src="https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2FJKOzXFQc6ov03E2nuOWU%2Fself-change-password.png?alt=media" alt=""><figcaption></figcaption></figure>

\
Just as you did when you first logged into the console, you need to provide your current password and then what you'd like for your new password. Be sure to follow the rules as described at the bottom of the page.

![Password Reset](https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2F1WTbJe55cdDwWI1b1l6i%2Fpassword-reset.png?alt=media)

{% hint style="info" %}
You cannot reset another user's password from the console. Have the user leverage the `Forgot Password` link at the login screen.
{% endhint %}

## Setup MFA

To turn MFA on, you will select the user icon ![User icon](https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2F137qjkzflIRDuHB0Vn1U%2Fuser-icon.png?alt=media) in the upper right corner of the console and select `Settings` from the menu.

<br>

<figure><img src="https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2Fp53SXGRwnNdLvHYXelLi%2Fself-mfa-setup.png?alt=media" alt=""><figcaption></figcaption></figure>

\
You'll be presented your user information overview and the option to enable MFA. Clicking the `Enable...` link will start the process to setup MFA. You can also identify if you have saved the device you are currently accessing from as "remembered" so you do not have to use MFA each time.

<br>

<figure><img src="https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2FEdICWNNKQdQAeZg4sDsx%2Fmfa-user-settings.png?alt=media" alt=""><figcaption></figcaption></figure>

Enable MFA Settings:

1. Click `Enable...`
2. Enter your existing password and click `Generate Setup Key`<br>

   <figure><img src="https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2F8uxy459ELSv519KcRwdA%2Fmfa-setup-enter-pw.png?alt=media" alt=""><figcaption></figcaption></figure>
3. Use your one time password application of choice to scan the QR code and enter the first one time code and click the `Verify` button<br>

   <figure><img src="https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2FhPPB6fBQBNL9tQmmVaKS%2Fmfa-setup-otp.png?alt=media" alt=""><figcaption></figcaption></figure>
4. On the final screen, click the `Enable MFA` button<br>

   <figure><img src="https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2F2xVmfAmv4Lj1EbyEfPOR%2Fmfa-setup-final-enable.png?alt=media" alt=""><figcaption></figcaption></figure>

You will now be presented with your user settings showing MFA is enabled.<br>

<figure><img src="https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2FVDGmtTkhLGRxM0QMGmal%2Fmfa-user-settings-enabled.png?alt=media" alt=""><figcaption></figcaption></figure>

The next time you login you will be prompted to enter the OTP after the standard username / password login screen. You can choose to save this computer off or not so you have to enter MFA each time you login.<br>

<figure><img src="https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2FY1RAtoYPi4w9KoHIffkQ%2Fmfa-login.png?alt=media" alt=""><figcaption></figcaption></figure>

## Sign out

To sign out of the console, you will select the user icon ![User icon](https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2F137qjkzflIRDuHB0Vn1U%2Fuser-icon.png?alt=media) in the upper right corner of the console and select `Sign Out` from the menu.

![Signout](https://905555942-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlGcQw8I2CHyi1loKBlfi%2Fuploads%2FXreHb1PFraZYjF8WGduO%2Fconsole-signout.png?alt=media)

## Single Sign-On (SSO)

You can find more information on implementing Single Sign-On (SSO) for your deployment by going to [this FAQ answer](https://help.cloudstoragesec.com/faq/architecture-related#can-i-leverage-single-sign-on-sso-with-your-product).
