.. Using_the_ykman_GUI.rst .. _gui-label: =================================================== Using the YubiKey Manager GUI =================================================== The YubiKey Manager's (ykman's) graphical user interface (GUI) is a quick, convenient way to find out what firmware your YubiKey has and/or to reset it - unless you prefer to use ykman's CLI. Note that the CLI has more options, so if you do not find what you want in the GUI, check to see if the CLI has it. Checking Firmware Version ========================= Launch the **YubiKey Manager App** and connect your YubiKey if it is not already connected. Note that the tool will only read a single YubiKey at a time, so if you have multiple keys connected, it might not be evident which one the tool is identifying. ykman opens the **Home** tab by default, displaying the following: * YubiKey series (e.g., YubiKey 5) * Firmware (e.g., 5.4.X) * Images of the various form factors within that series. .. image:: graphics/ykman-4.3.7.png :scale: 30 % :align: center *YubiKey Manager GUI, Home tab* .. include:: includes/managing-applications.rst Managing Interfaces =================== The **Interfaces** tab displays your key's form factor (e.g., USB), and the interfaces it has. Use the **Interfaces** tab to configure what is available on that key. For example, you can disable the interfaces by deselecting the respective checkboxes. Resetting FIDO2 Function ======================== Resetting the key is not the same as unblocking it. Because resetting the FIDO2 function returns the key to its beginning state when it has no PIN, you must set a new PIN and enroll the key again after resetting it. 1. Remove your YubiKey if it is still connected to your machine, then launch ykman and insert your key. .. image:: graphics/ykman-4.3.7.png :scale: 25 % :align: center 2. Click on the word **Applications** at the top of that tab. A list of menu options appears. The specific options depend on the key. .. image:: graphics/ykman-applications-options-list.png :scale: 25 % :align: center 3. Select **FIDO2**. The FIDO2 page appears. .. image:: graphics/ykman-FIDO2-page.png :scale: 25 % :align: center 4. Click the **Reset FIDO** button. The Reset FIDO confirmation popup appears. .. image:: graphics/ykman-reset-fido-confirmation.png :scale: 30 % :align: center 5. Click **Yes**. Everything on the key is removed: the PIN (if set) is deleted. The **Remove and re-insert your YubiKey!** prompt appears. .. image:: graphics/ykman-remove-and-reinsert-your-yubikey.png :scale: 30 % :align: center .. NOTE: The operation is not complete until you have completed step 8. 6. Remove and re-insert your YubiKey. The **Touch your YubiKey** prompt appears, and the green LED flashes. .. image:: graphics/ykman-touch-your-yubikey.png :scale: 30 % :align: center 7. Touch your YubiKey. The message "FIDO applications have been reset" appears at the bottom of the **Applications** page. 8. Remove the key in preparation for re-enrolling it. ---- Click for `Yubico Support `_.