Skip to content

Device Password

Your device password is your password on lab nodes. It is the password of your login on every node Sherpa provisions for you, and of the fixed vendor accounts some devices have, such as admin. Aruba AOS-CX is the one exception: you log in there by key only (see Your Login on Nodes). It is yours alone: it is not your Sherpa login password, and nobody else, administrators included, can set, read or clear it.

Set it before your first lab

sherpa up and node redeploys need a device password. Every user sets one before their first lab.

Set It

You need your Sherpa login password to set it. The device password must differ from your login password.

sherpa server user device-password

The command asks for your Sherpa login password, then the new device password twice. It takes no arguments or flags: passwords are always typed at the prompt, as for sherpa server user passwd, and SHERPA_USER_PASSWORD is not used.

Open the Profile page. Under Device Password, enter your Sherpa login password and the new device password twice, then select Set Device Password.

Setting it again replaces it. A new device password applies to nodes you create or redeploy afterwards; running nodes keep the one they started with. Sherpa never shows the device password again, so a forgotten one is replaced, not recovered.

The built-in admin account cannot start labs, so it has no device password.

Check It

sherpa server user info shows Device password: set or not set, and so does the Profile page. Administrators see each user's state in sherpa server user list. The API returns only device_password_set, never the password.

Rules

One rule applies to every node model, so a device password that is accepted works on whatever you start next:

  • 12 to 20 characters.
  • Letters, digits and ! @ _ - + . only, starting with a letter or a digit. No spaces, quotes, backslashes or other symbols.
  • At least one lowercase letter, one uppercase letter, one digit and one of ! @ _ - + ..
  • It does not contain your username or cisco, in any case.
  • No character three times in a row.

A password that breaks a rule is refused with a message naming the rule. The rule is what the strictest devices accept: Windows takes at most 20 characters; Cisco Firepower Threat Defense, PAN-OS, ISE, Windows and NX-OS check its strength; Firepower Threat Defense refuses a character three times in a row, and Cisco devices refuse cisco.

Storage

The server stores the device password encrypted with the database key, bound to your user record, so a database backup holds only ciphertext. See Database.