tw_upduser
The tw_upduser utility enables you to update properties of a specific user, such as the current state, permissions, and passwords. To use the utility, type the following command at the $TIDEWAY/bin/ directory:
where:
- username is the name of the user to update
- options are any of the options described in the following table and the common command line options described in Using-command-line-utilities.
Command Line Option | Description |
|---|---|
--active | Sets the user to an ACTIVE state |
--blocked | Sets the user to a BLOCKED state |
--disabled | Sets the user to a DISABLED state |
-f, --fullname=ARG | Sets a full name of the user |
-G, --groups=GROUP ,... | Sets the user's group membership |
--locked | Sets the user to a LOCKED state |
--passwd-must-change | Specifies that the password must be changed |
--passwd-ok | Specifies that the password is okay as currently stated |
--passwd-should-change | Specifies that the password should be changed |
--token | Print an API token to stdout that you use in the client you want to access the API. For API users (api-access group) the token does not expire. For normal users (with a password) the token is valid for 3600 seconds. |
User example
In the following example, the tw_upduser utility sets the user Joe to a locked state to protect from unauthorized changes to that account.
Locking a user for security purposes
To lock a user, type the following command:
The following confirmation is displayed:
To unlock the user, run the utility again with the --active option.