2019-03-24 17:45:32 +00:00
|
|
|
# Security Keys (U2F)
|
|
|
|
|
2019-12-05 20:52:04 +00:00
|
|
|
**Authelia** offers authentication using Security Keys like [Yubikey](Yubikey)
|
|
|
|
which are one of the most secure way to authenticate and get authorized.
|
|
|
|
It is already available for Google, Facebook, Github accounts and more.
|
2019-03-24 17:45:32 +00:00
|
|
|
|
2019-12-05 20:52:04 +00:00
|
|
|
The protocol requires your security key to enrolled before authenticating.
|
2019-03-24 17:45:32 +00:00
|
|
|
|
2019-12-05 20:52:04 +00:00
|
|
|
To do so, select the *Security Key* method at the second factor stage and
|
|
|
|
click on the link *Not registered yet?*. This will send a link to your
|
|
|
|
user email address. This e-mail will likely be sent to
|
|
|
|
https://mail.example.com:8080/ if you're testing Authelia and you've not
|
|
|
|
configured anything.
|
2019-03-24 17:45:32 +00:00
|
|
|
|
2019-12-05 20:52:04 +00:00
|
|
|
Confirm your identity by clicking on **Register** and you'll be asked to
|
2019-03-24 17:45:32 +00:00
|
|
|
touch the token of your security key to enroll.
|
|
|
|
|
|
|
|
<p align="center">
|
2019-12-05 20:52:04 +00:00
|
|
|
<img src="../../docs/images/REGISTER-U2F.png" width="400">
|
2019-03-24 17:45:32 +00:00
|
|
|
</p>
|
|
|
|
|
2019-12-05 20:52:04 +00:00
|
|
|
Upon successful registration, you can authenticate using your security key
|
|
|
|
by simply touching the token again when required:
|
|
|
|
|
|
|
|
<p align="center">
|
|
|
|
<img src="../../docs/images/2FA-U2F.png" width="400">
|
|
|
|
</p>
|
2019-03-24 17:45:32 +00:00
|
|
|
|
|
|
|
Easy, right?!
|
|
|
|
|
|
|
|
## FAQ
|
|
|
|
|
|
|
|
### Why don't I have access to the *Security Key* option?
|
|
|
|
|
2019-12-05 20:52:04 +00:00
|
|
|
U2F protocol is a new protocol that is only supported by recent browsers
|
|
|
|
and might even be enabled on some of them. Please be sure your browser
|
|
|
|
supports U2F and that the feature is enabled to make the option
|
|
|
|
available in **Authelia**.
|
2019-03-24 17:45:32 +00:00
|
|
|
|
|
|
|
[Yubikey]: https://www.yubico.com/products/yubikey-hardware/yubikey4/
|