YubiKey Complete Setup Guide

  • Compatibility with various security protocols such as OTP, FIDO and biometrics depending on the key model.
  • Need to synchronize credentials in the Yubico cloud for certain services to function correctly.
  • Ability to extend security to the development environment through commit signing and SSH access.

YubiKey Configuration

If you've gotten your hands on a YubiKey, you're probably wondering how to get the most out of this little device. Don't worry, although at first it might seem overwhelming with so many protocols and options, the truth is that securing your accounts is simpler than it seems once you understand why two-step authentication is so important.

The idea is to move from relying on a simple password to having a physical barrier that only you possess. In this sense, correctly configuring your key isn't just a matter of pressing a button, but of adapting the tool to your needs, whether you're looking for something basic to access your email or an expert-level configuration for programming and managing servers.

Guide to securely setting up and using passkeys on Android
Related article:
Guide to securely setting up and using passkeys on Android

Step-by-step configuration for common services

For those using Android password managers like Bitwarden, the implementation is fairly straightforward but requires a few steps. First, you need to go to the website, navigate to the security section, and find the OTP security key option . This is where you insert your USB device (4, 5, or NEO series) and tap the physical button to pair it. It's crucial that, if you're using an NFC-enabled phone, you check the corresponding box so the key is recognized wirelessly.

For services like Infomaniak, the process is more technical since they rely on the Yubico OTP protocol . You'll need to install YubiKey Manager on your computer. From the applications tab, choose whether you want the code generated with a short or long tap, and, very importantly, check the box to upload the configuration to the Yubico servers. Skipping this step will likely cause authentication to fail when you try to log in.

Biometrics management and unlocking

YubiKey Configuration

How to use OnlyKey
Related article:
OnlyKey: Complete guide to using it on Android devices

Some advanced models include fingerprint readers. If you fail biometric authentication three times, the key will enter a preventative lock state, indicated by a slow flashing of the amber LED . To resolve this, there's no need to reset anything; simply enter your security PIN and touch the metal ring when the green LED indicates it's working.

Advanced use cases for technical profiles

If you're a developer or system administrator, you can go far beyond simply logging into websites. One of the most powerful implementations is storing SSH certificates and signing commits in Git, allowing your code changes to be backed by an unbreachable physical identity. While there are very complex guides on GitHub, it's best not to delete the pre-installed OTP unless you know exactly what you're doing, to avoid compatibility issues.

For those managing remote access, such as in Remote Desktop Manager, simply activate multi-factor authentication in the security settings and press and hold the gold key button to generate the necessary access code.

Authentication apps
Related article:
Best two-step authentication apps or TOTP generators

Troubleshooting NFC issues

YubiKey Configuration

If you notice that your YubiKey isn't responding when you bring it close to your phone, the first thing to check is that NFC is enabled in your Android device's settings. If everything seems correct but it's still not working, you can use YubiKey Manager to check the Interfaces tab and ensure all NFC boxes are checked. In more persistent cases, the customization tool allows you to program the desired configuration slot using NDEF to force proper operation.

Having a hardware-based security ecosystem means managing not only the physical key, but also the recovery codes the system provides when you activate 2FA. Storing these codes in a safe place is the only way to avoid being locked out of your account if you lose the physical device.

Mastering the use of these keys allows you to move from basic security based on USB touches to complex configurations of digital signatures and biometrics, ensuring that access to information depends on a real physical factor and not just data stored in the cloud.

Password managers for Android
Related article:
The most secure password managers you can use on Android

Add as preferred source in Google