

Amazon Monitron is no longer open to new customers. Existing customers can continue to use the service as normal. For capabilities similar to Amazon Monitron, see our [blog post](https://aws.amazon.com/blogs/machine-learning/maintain-access-and-consider-alternatives-for-amazon-monitron).

# Managing non-admin users
<a name="non-admin-user-management-chapter"></a>

After creating a project or site, you need to add users to them. As an admin user, you can add users to three different roles: `Admin`, `Technician`, or `Viewer`.

A user's role determines what they can do with Amazon Monitron. The extent of their role permissions is determined by whether they are added at the project level or at the site level. Setting a user's role set at the project level gives the user permissions across all sites in that project. Setting a user's role at the site level gives the use permissions only to that site.

**Topics**
+ [Displaying a list of users](display-user-list.md)
+ [Adding a user](adding-user.md)
+ [Changing a user role](editing-user-role.md)
+ [Removing a user](deleting-user.md)

# Displaying a list of users
<a name="display-user-list"></a>

As an admin, you can use the list of users to manage users in the Amazon Monitron app. There are three levels you can choose from (depending on your admin role) to view a list of users:
+ As project level admin, you can view all users at the project level.
+ As project level admin, you can view all users at a particular site level.
+ As site level admin, you can view all users at a particular site level.

**Topics**
+ [To display the list of users in the mobile app](#w2aac28c19c11b9)
+ [To display the list of users in the web app](#w2aac28c19c11c11)

## To display the list of users in the mobile app
<a name="w2aac28c19c11b9"></a>

1. Log into the Amazon Monitron mobile app on your smartphone. 

1. Choose the project or site whose users you want to view.  
![\[Dropdown menu showing Project name 1 with three site options, one highlighted in orange.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/site-to-project.png)

1. Choose the menu icon (☰).   
![\[Menu icon represented by three horizontal lines (hamburger menu).\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/navigation.png)

1. Choose **Users**. 

   A list of all users associated with the project or site is displayed. 

## To display the list of users in the web app
<a name="w2aac28c19c11c11"></a>

The **Users & Permissions** page displays the following information to make user management easier:
+ **Name** – The name of the user. 
+ **Role** – The role assigned to the user, whether Admin, Technician, Viewer, or any combination of these. 
+ **Assigned locations** – The number of locations the user is assigned to.
+ **Project level access** – Whether the user has project level access or only specific site level access.

1. Log into the Amazon Monitron web app. 

1. Select **Users** from the left nav. The list of users will appear.  
![\[Users & Permissions interface showing a list of 8 users with roles, assigned locations, and access levels.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/user-10.png)

1. Choose the project or site whose users you want to view. 

   A list of all users associated with the project or site is displayed.  
![\[Dropdown menu showing Project name 1 with three site options, one highlighted in orange.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/site-to-project.png)

# Adding a user
<a name="adding-user"></a>

When you add a new user, the role you choose determines the permissions that user has. 

Users can have the following roles:
+ **Admin**. An admin user has full access to all resources within the project or site to which they've been added. They can add other users, create assets, pair sensors to assets, and so on. They can also monitor assets and acknowledge and resolve abnormalities. If they are added at the project level, these permissions extend through the entire project. If they are added at the site level, these permissions are limited to only that site.
+ **Technician**. A technician user has read-only permissions to the project or site to which they've been added and permissions for monitoring assets and acknowledging and resolving abnormalities. If they are added at the project level, these permissions extend through the entire project. If they are added at the site level, these permissions are for only that site.
+ **Read only**. A user with read-only permissions has permission to read (but not add, change, or delete) details of all resources within the project or site to which they've been added.

You use the same procedure to add a new user to a project or to a site.

**Topics**
+ [To add a user using the mobile app](#w2aac28c19c15c13)
+ [To add a user using the web app](#w2aac28c19c15c15)

## To add a user using the mobile app
<a name="w2aac28c19c15c13"></a>

1. Log into the Amazon Monitron mobile app on your smartphone. 

1. Navigate to the project or site that you want to add a user to, and then to the **Users** list. 

1. Choose **Add user**.   
![\[User interface showing a list of users and an "Add user" button in the top right corner.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/user-list-add.png)

1. Enter a user name. 

   Amazon Monitron searches the user directory for the user. 

1. Choose the user from the list. 

1. Choose the role that you want to assign the user: **Admin**, **Technician**, or **Viewer**.

1. Choose **Add**. 

   The new user appears on the **Users** list.

1. Send the new user an email invitation with a link for accessing the project and downloading the Amazon Monitron mobile app. For more information, see [Sending an email invitation](resending-email.md).

## To add a user using the web app
<a name="w2aac28c19c15c15"></a>

1. Navigate to the project or site that you want to add a user to, and then to the **Users** list.   
![\[Users & Permissions interface showing a list of users and an "Add user" dialog box.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/user-1.png)

1. Enter a user name. Amazon Monitron searches the user directory for the user.

   Choose the user from the list and the role you want to assign to the user: **Admin**, **Technician**, or **Viewer**.

   Then, choose **Add user**.   
![\[Add user dialog box with fields for username and role selection.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/user-2.png)

1. The new user appears on the **Users** list.  
![\[Users & Permissions interface showing a list of users with roles and inherited status.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/user-3.png)

   Send the new user an email invitation with a link for accessing the project and downloading the Amazon Monitron mobile app. For more information, see [Sending an email invitation](resending-email.md).

# Changing a user role
<a name="editing-user-role"></a>

You can change a user's role, but not a user's name. That's because the name is linked to the user directory that is linked to by Amazon Monitron.

To change a project or site's users, you must remove the previous users and add the new ones. For information on removing users from a project or site, see [To remove a user using the mobile app](deleting-user.md). For information on adding new users, see [Adding a user](adding-user.md).

**Topics**
+ [To change a user role using the mobile app](#w2aac28c19c19b9)
+ [To change a user role using the web app](#w2aac28c19c19c11)

## To change a user role using the mobile app
<a name="w2aac28c19c19b9"></a>

1. Log into the Amazon Monitron mobile app on your smartphone. 

1. Navigate to the project or site for the user whose role you want to change, and then to the **Users** list. 

1. Choose the vertical ellipsis ( ![\[Three vertical dots representing a menu or more options in a user interface.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/details.png)) next to the name of the user whose role you want to change. 

1. Choose **Edit user**. 

1. Choose a new role for the user: **Admin**, **Technician**, or **Read only**. 

1. Choose **Save**. 

## To change a user role using the web app
<a name="w2aac28c19c19c11"></a>

1. Choose **Users** from the navigation pane.  
![\[Users & Permissions interface showing a list of users with roles and edit options.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/user-4.png)

1. Choose **Edit user role**.

1. Choose a new role for the user: **Admin**, **Technician**, or **Viewer**.   
![\[User role editing interface showing options to change a user's role to Technician.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/user-5.png)

1. Choose **Save**. 

# Removing a user
<a name="deleting-user"></a>

Removing a user removes their permissions to access the site or project. It doesn't affect the user directory. Additionally, if the user has permissions to other sites or projects, this won't remove those permissions.

**Topics**
+ [To remove a user using the mobile app](#w2aac28c19c23b7)
+ [To remove a user using the web app](#w2aac28c19c23b9)

## To remove a user using the mobile app
<a name="w2aac28c19c23b7"></a>

1. Log into the Amazon Monitron mobile app on your smartphone. 

1. Navigate to the project or site, and then to the **Users** list page. 

1. Choose the vertical ellipses ( ![\[Three vertical dots representing a menu or more options in a user interface.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/details.png)) next to the user name. 

1. Choose **Remove user**. 

1. On the **Confirmation** page, choose **Remove**. 

## To remove a user using the web app
<a name="w2aac28c19c23b9"></a>

1. Select **Users** from the nav pane.  
![\[Users & Permissions interface showing a list of users with roles and inherited status.\]](http://docs.aws.amazon.com/Monitron/latest/user-guide/images/user-3.png)

1. Select the user that you want to remove.

1. Choose **Remove**.