Manage Users

Create and manage User resources

Overview

This topic explains how to create and manage User resources.

A User resource represents an NGINX Controller User account. Assign Roles to Users to define what actions Users can perform in NGINX Controller and what Environment(s) Users can access.

By default, all users have READ permissions for Analytics, Users, Roles, and Licenses. You can use the /platform/roles endpoint in the NGINX Controller REST API to extend or narrow this default set of permissions.

Create a User

Take the following steps to create a User:

  1. Open the NGINX Controller user interface and log in.
  2. Select the NGINX Controller menu icon, then select Platform.
  3. On the Platform menu, select Users.
  4. On the Users menu, select Create User.
  5. Add a first name.
  6. Add a last name.
  7. Add an email address.
  8. Add a password.
  9. (Optional) Add one or more tags.
  10. (Optional) Add one or more Roles. The Role specifies the user’s permission level.
Note:

User account passwords for NGINX Controller must meet the following requirements:

  • Must be between 8–64 characters. Special characters are allowed.
  • Must contain at least 1 letter.
  • Must contain at least 1 number.
  • New passwords must be different from the last password.

Dictionary words, mangled dictionary words like p4ssword, or systematic passwords like 1234567a are not allowed.

If your organization requires a different password policy, we recommend that you configure external authentication using Active Directory for all users except the primary NGINX Controller admin user.

Edit or Delete a User

Take the following steps to edit or delete a User:

  1. Open the NGINX Controller user interface and log in.
  2. Select the NGINX Controller menu icon, then select Platform.
  3. On the Platform menu, select Users.
  4. To edit a User, choose the User from the list, then select Edit (pencil icon).
  5. To delete a User, choose the User from the list, then select Delete (trash icon).

What’s Next

​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​ ​

This documentation applies to the following versions of NGINX Controller: 3.0, 3.1, 3.2, 3.3, 3.3, 3.4, 3.5, 3.6, 3.7, 3.8, 3.9, 3.10, 3.12, 3.13, 3.14, 3.15, 3.16.1, 3.17 and 3.18.