Managing User Accounts

Inviting, deactivating and deleting user accounts.

Inviting a New User

From the account page, click the "Invite" button, and select the option "User Account".

Enter their name, email (this cannot be changed), and select a role (which can be modified by an Optable DCN admin, or users assigned to a role with the accounts.edit permission). All fields are mandatory. Users can change their name from their accounts page.

Account types

User account form

From the CLI, use the command optable-cli account create <username> <email> <role>. You will receive a confirmation message similar to this one.

{
  "id":  123456,
  "kind":  "ACCOUNT_KIND_USER",
  "name":  "Jim Doe",
  "email":  "[e-mail]",
  "status":  "ACCOUNT_STATUS_ACTIVE",
  "access_scopes":  [
    "run:task"
  ],
  "created_at":  "2022-08-30T16:20:12.250991657Z",
  "updated_at":  "2022-08-30T16:20:12.250991657Z",
  "role_name":  "roles/guest"
}

<role> can be roles/admin, roles/guest or a user-created role of which you must enter the full name of, you can obtain a list of available roles by using the command optable-cli role list.

Resending an Invitation

Invited users will receive an email with instructions to join the Optable DCN they were invited to. Users are marked as pending until they log in for the first time. You can resend an invitation to that user from the Accounts page, by clicking the button next to their invitation in the users list.

From the CLI, use the command optable-cli account resend-invitation <ID>. You can get the ID by using optable-cli account list.

Creating a Service Account

From the account page, click the "Invite" button, and select the option "Service Account".

Service accounts must have a name, which can be changed later on, and a role (which can be modified by an Optable DCN admin, or users assigned to a role with the accounts.edit permission). Both fields are mandatory.

User account types

Service account form

From the CLI, use the command optable-cli account create --service <username> <email> <role>. You will receive a confirmation message similar to this one.

{
  "id":  456789,
  "kind":  "ACCOUNT_KIND_SERVICE",
  "name":  "serviceaccount",
  "email":  "[e-mail]",
  "status":  "ACCOUNT_STATUS_ACTIVE",
  "access_scopes":  [
    "run:task"
  ],
  "created_at":  "2022-08-30T16:37:48.140412674Z",
  "updated_at":  "2022-08-30T16:37:48.140412674Z",
  "role_name":  "roles/admin"
}

<role> can be roles/admin, roles/guest or a user-created role of which you must enter the full name of, you can obtain a list of available roles by using the command optable-cli role list.

A service account's <email> is generated by Optable at creation time. Therefore, use double quotes "" for this field.

Updating an Account

From the Accounts page, click the button next to the user you want to update, and click edit.

From there, you can rename the account, and change its assigned role.

Service Account form

From the CLI, use the command optable-cli account update <account id> --name="<new name>" --role-name="<new role>". You can update one or multiple fields at a time.

Deactivating an Account

From the Accounts page, click the button next to the user you want to update, and click deactivate. Accounts will still exist, along with its history, but they will not be able to access the platform any longer.

You can look for deactivated accounts in the UI to reactivate them.

Deactivating accounts

Filtering between active and inactive accounts

From the CLI, use the command optable-cli account deactivate <id>.

Deleting an Account

From the Accounts page, click the next to the user you want to update, and click delete. Accounts deleted cannot be retrieved, though they can be re-invited.

From the CLI, use the command optable-cli account delete <account id>.