Username & Password Recovery

When a user has forgotten their username or password there are both user and administrative tools to recover or reset this information.

_images/nim_login.png
  • If the SMTP Outgoing Mail Server is configured and working properly, users can recover their username or reset their password directly from the login page.

  • Alternatively the nim-recovery-tool is available from the NIM VM command line.

Username Recovery

Usernames can be recovered by clicking the FORGOT LOGIN link at the login screen and entering the associated email address for the user. If a matching user account is found and the SMTP Outgoing Mail Server has been configured an email will be sent to the address with the username.

  • In the event that there is no available SMTP Outgoing Mail Server, the nim-recovery-tool can be used from the NIM VM console.

Password Reset

Passwords can be reset by clicking the FORGOT PASSWORD link at the login screen and entering the username of the password to reset. If a matching account is found and and the SMTP Outgoing Mail Server has been configured an email will be sent with a new password for the user account. It is recommened to update this temporary password upon login.

  • In the event that there is no available SMTP Outgoing Mail Server, the nim-recovery-tool can be used from the NIM VM console.

NIM Recovery Tool

To recover a username using the nim-recovery-tool, login to the NIM VM console.

The nim-recovery-tool script can assist an admin with gaining access to NIM.

The script can:

  • Reset any NIM user’s password to “password”

  • List all root users

  • Find a username associated with a specific email address

  • List all users

  • List all enabled users

  • Enable a user

  • Disable a user

To see instructions for using the script, enter:

sudo ./nim-recovery-tool

To find a username associated with a known email address:

sudo ./nim-recovery-tool -e "email@addr.ess"

To reset a user’s password:

sudo ./nim-recovery-tool -u username

To list all root users:

sudo ./nim-recovery-tool -r

To list all users:

sudo ./nim-recovery-tool -la

To list enabled users:

sudo ./nim-recovery-tool -le

To enable a user:

sudo ./nim-recovery-tool -eu username

To disable a user:

sudo ./nim-recovery-tool -du username

Note

If the total number of enabled users exceeds the license limit, the most recently enabled users will be disabled automatically.