2020-02-29 00:43:59 +00:00
|
|
|
---
|
|
|
|
layout: default
|
|
|
|
title: Security Keys
|
|
|
|
nav_order: 2
|
|
|
|
parent: Second Factor
|
|
|
|
grand_parent: Features
|
|
|
|
---
|
|
|
|
|
|
|
|
# Security Keys
|
|
|
|
|
2022-03-03 11:20:43 +00:00
|
|
|
**Authelia** supports hardware-based second factors leveraging [FIDO2] [Webauthn] compatible security keys like
|
2021-07-15 03:21:47 +00:00
|
|
|
[YubiKey]'s.
|
2020-02-29 00:43:59 +00:00
|
|
|
|
2022-03-03 11:20:43 +00:00
|
|
|
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.
|
2020-02-29 00:43:59 +00:00
|
|
|
|
|
|
|
<p align="center">
|
|
|
|
<img src="../../images/yubikey.jpg" width="150">
|
|
|
|
</p>
|
|
|
|
|
2022-03-03 11:20:43 +00:00
|
|
|
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.
|
2020-02-29 00:43:59 +00:00
|
|
|
|
|
|
|
<p align="center">
|
|
|
|
<img src="../../images/REGISTER-U2F.png" width="400">
|
|
|
|
</p>
|
|
|
|
|
2022-03-03 11:20:43 +00:00
|
|
|
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.
|
2020-02-29 00:43:59 +00:00
|
|
|
|
|
|
|
*NOTE: This e-mail has likely been sent to the mailbox at https://mail.example.com:8080/ if you're testing Authelia.*
|
|
|
|
|
2022-03-03 11:20:43 +00:00
|
|
|
Confirm your identity by clicking on **Register** and you'll be asked to touch the token of your security key to
|
|
|
|
complete the enrollment.
|
2020-02-29 00:43:59 +00:00
|
|
|
|
2022-03-03 11:20:43 +00:00
|
|
|
Upon successful enrollment, you can authenticate using your security key by simply touching the token again when
|
|
|
|
requested:
|
2020-02-29 00:43:59 +00:00
|
|
|
|
|
|
|
<p align="center">
|
|
|
|
<img src="../../images/2FA-U2F.png" width="400">
|
|
|
|
</p>
|
|
|
|
|
|
|
|
Easy, right?!
|
|
|
|
|
2022-03-03 11:20:43 +00:00
|
|
|
## FAQ
|
2021-02-12 05:59:42 +00:00
|
|
|
|
2022-03-03 11:20:43 +00:00
|
|
|
### Can I register multiple FIDO2 Webauthn devices?
|
2021-02-12 05:59:42 +00:00
|
|
|
|
2022-03-03 11:20:43 +00:00
|
|
|
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](https://github.com/authelia/authelia/issues/275) for updates.
|
2021-02-12 05:59:42 +00:00
|
|
|
|
2022-03-03 11:20:43 +00:00
|
|
|
### Can I perform a passwordless login?
|
2021-02-12 05:59:42 +00:00
|
|
|
|
2022-03-03 11:20:43 +00:00
|
|
|
Not at this time. We will tackle this at a later date.
|
2020-02-29 00:43:59 +00:00
|
|
|
|
|
|
|
### Why don't I have access to the *Security Key* option?
|
|
|
|
|
2022-03-03 11:20:43 +00:00
|
|
|
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.
|
2020-02-29 00:43:59 +00:00
|
|
|
|
2022-03-03 11:20:43 +00:00
|
|
|
[FIDO U2F]: https://www.yubico.com/authentication-standards/fido-u2f/
|
|
|
|
[FIDO2]: https://www.yubico.com/authentication-standards/fido2/
|
|
|
|
[Webauthn]: https://www.yubico.com/authentication-standards/webauthn/
|
2021-07-15 03:21:47 +00:00
|
|
|
[YubiKey]: https://www.yubico.com/products/yubikey-5-overview/
|