Local User Account Management

Managing local user accounts

Add a local user account

Using the IAM API

Prerequisite:

To add a local user account using the DC/OS Identity and Access Management (IAM) API, replace <uid> and <password> with the corresponding values and execute the following command:

  1. curl -i -X PUT http://<host-ip>/acs/api/v1/users/<uid> -d '{"password": "<password>"}' -H 'Content-Type: application/json' -H "Authorization: token=$TOKEN"

NOTE: The password must be at least five characters long.

List local user accounts

Using the IAM API

Prerequisite:

To list all configured user accounts using the DC/OS Identity and Access Management (IAM) API, execute the following command:

  1. curl -i -X GET http://<host-ip>/acs/api/v1/users -H 'Content-Type: application/json' -H "Authorization: token=$TOKEN"

NOTE: This will include external user accounts. Local user accounts are listed as `provider_type: internal`.

Change a local user password

Using the IAM API

Prerequisite:

To change a local user account’s password using the DC/OS Identity and Access Management (IAM) API replace <uid> and <password> with the corresponding values and execute the following command:

  1. curl -i -X PATCH http://<host-ip>/acs/api/v1/users/<uid> -d '{"password": "<password>"}' -H 'Content-Type: application/json' -H "Authorization: token=$TOKEN"

NOTE: The password must be at least 5 characters long.

Remove a local user account

Using the IAM API

Prerequisite:

To delete a local user account using the DC/OS Identity and Access Management (IAM) API, replace <uid> with the corresponding value and execute the following command:

  1. curl -i -X DELETE http://<host-ip>/acs/api/v1/users/<uid> -H 'Content-Type: application/json' -H "Authorization: token=$TOKEN"

Using the UI

  1. Log in to the UI.
  2. From the Users screen, select the uid and click Delete.
  3. Click Delete to confirm the action.