Authentication

Listing Users

The command below lists all users in Lens AppIQ. Administrators may also filter users by user email or role name with context value.

lapps user list [--user/-u useremail] [--role/-r role [-c/--context-value value]]

Available flags:

FlagDescription
-r, --role(= "") Filter user by role
-u, --user(= "") Filter user by user email

Creating Users

The command below creates a user within Lens AppIQ remote server. It will prompt for the password before it issues the request:

lapps user create <email>

Adding Members to Teams

To add members to teams created, users will need to leverage the _role assign _command, as follows:

lapps role assign <role> <[email protected]> <team>

Removing Users

The command below removes users from a remote Lens AppIQ server.

Since orphan teams cannot exist, Lens AppIQ may refuse to remove a user that is the last member of a team. If this is the case, make sure the team is removed by using the command team remove before removing the user:

lapps user remove [email]

User Information

When needed, the command below displays information about a specific current user:

lapps user info

Login

Login initiates a new session for a user. If using Lens AppIQ' native authentication scheme, the CLI will ask for the email and the password.

Once completed, the token generated by the server will be stored in ${HOME}/.lapps/token.

All Lens AppIQ actions require the user to be authenticated (except lapps login and lapps version).

lapps login [email]

Logout

The logout command terminates the session with the Lens AppIQ server.

lapps logout

Changing Passwords

The command below changes the password of the logged-in user. The CLI will ask for the current password, the new and confirmation:

lapps change password

Resetting Password

lapps reset password <email> [--token|-t <token>]

Resets the user password.

This process executes two steps:

  • Generate a new token
  • Reset the password using the token

To generate the token, users should run this command without the --token flag. The token will be mailed to the user.

With the token in hand, the user can finally reset the password using the --token flag. The new password will also be mailed to the user.