3.3 KiB
| title | description | lead | date | draft | images | menu | weight | toc | aliases | |||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Security Key | Authelia utilizes WebAuthn security keys as one of it's second factor authentication methods. | Authelia utilizes WebAuthn security keys as one of it's second factor authentication methods. | 2022-03-20T12:52:27+11:00 | false |
|
240 | true |
|
Authelia supports hardware-based second factors leveraging FIDO2 WebAuthn compatible security keys like YubiKey's.
Security keys are among the most secure second factor. This method is already supported by many major applications and platforms like Google, Facebook, GitHub, some banks, and much more.
{{< figure src="yubikey.jpg" caption="A YubiKey Security Key" alt="A YubiKey Security Key" width=150 >}}
Normally, the protocol requires your security key to be enrolled on each site before being able to authenticate with it. Since Authelia provides Single Sign-On, your users will need to enroll their device only once to get access to all your applications.
{{< figure src="REGISTER-U2F.png" caption="The WebAuthn Registration View" alt="2FA WebAuthn Registration View" width=400 >}}
After having successfully passed the first factor, select Security Key method and click on Register device link. This will send you an email to verify your identity.
NOTE: This e-mail has likely been sent to the mailbox at https://mail.example.com:8080/ if you're testing Authelia.
Confirm your identity by clicking on Register and you'll be asked to touch the token of your security key to complete the enrollment.
Upon successful enrollment, you can authenticate using your security key by simply touching the token again when requested:
{{< figure src="2FA-U2F.png" caption="The WebAuthn Authentication View" alt="2FA WebAuthn Authentication View" width=400 >}}
Easy, right?!
FAQ
Can I register multiple FIDO2 WebAuthn devices?
At present this is not possible in the frontend. However the backend technically supports it. We plan to add this to the frontend in the near future. Subscribe to this issue for updates.
Can I perform a passwordless login?
Not at this time. We will tackle this at a later date.
Why don't I have access to the Security Key option?
The WebAuthn protocol is a new protocol that is only supported by modern browsers. Please ensure your browser is up to date, supports WebAuthn, and that the feature is not disabled if the option is not available to you in Authelia.
Can my FIDO U2F device operate with Authelia?
At the present time there is no plan to support FIDO U2F within Authelia. We do implement a backwards compatible appid extension within Authelia however this only works for devices registered before the upgrade to the FIDO2 WebAuthn protocol.
If there was sufficient interest in supporting registration of old U2F / FIDO devices in Authelia we would consider adding support for this after or at the same time of the multi-device enhancements.