1. Yubico
  2. Individuals
  3. Individual Guides

Resetting the YubiHSM Auth Application on the YubiKey

Avatar
Andreas Blomberg
Created - Updated

This article covers the two options for resetting the YubiHSM Auth application on your YubiKey.
Note: The YubiHSM Auth application is only available in YubiKey firmware 5.4 or higher. Use YubiKey Manager to check your YubiKey's firmware version.


Warning: This will permanently delete any YubiHSM Auth credentials you have on the YubiKey.

 

Option 1 - Reset Using YubiKey Manager CLI

  1. Download and install YubiKey Manager.
  2. Insert the YubiKey into a USB port.
  3. Open Command Prompt (Windows) or Terminal (Mac / Linux).
  4. Type ykman hsmauth reset and press Enter.
  5. When prompted, press Y and then Enter to confirm the reset.

Note: If you receive an error about not being able to find the program ykman, you will need to use cd to navigate to the folder it is in before running the ykman command.

  • For Windows you would run cd "C:\Program Files\Yubico\YubiKey Manager"
  • For Mac you would run cd /Applications/YubiKey\ Manager.app/Contents/MacOS/

Option 2 - Reset Using the YubiHSM SDK

  1. Download and install YubiHSM SDK
  2. Insert the YubiKey into a USB port.
  3. Open Command Prompt (Windows) or Terminal (Mac / Linux).
  4. Type yubihsm-auth --action reset and press Enter.

Note: If you receive an error about not being able to find the program yubihsm-auth, you will need to use cd to navigate to the folder it is in before running the yubihsm-auth command.

  • For Windows you would run cd "C:\Program Files\Yubico\YubiHSM Shell\bin"
  • For Mac you would run cd /usr/local/bin