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.

bulb-light-icon.svg Tip: The YubiHSM Auth application is only available in YubiKey firmware 5.4 or higher. Use Yubico Authenticator to check your YubiKey firmware version.
exclamation-triangle-line-icon.svg 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 the latest YubiKey Manager CLI
  2. Insert the YubiKey into a USB port
  3. Open Command Prompt (Windows) or Terminal (macOS / Linux)
  4. Type ykman hsmauth reset and press Enter
  5. When prompted, press Y and then Enter to confirm the reset
manual-icon.svg 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, run cd "C:\Program Files\Yubico\YubiKey Manager CLI"
  • For macOS, run cd /Applications/YubiKey\ Manager\ CLI.app/Contents/MacOS/

Option 2 - Reset using the YubiHSM SDK

  1. Download and install the YubiHSM SDK
  2. Insert the YubiKey into a USB port
  3. Open Command Prompt (Windows) or Terminal (macOS / Linux)
  4. Type yubihsm-auth --action reset and press Enter
manual-icon.svg 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, run cd "C:\Program Files\Yubico\YubiHSM Shell\bin"
  • For macOS, run cd /usr/local/bin