File: mfa.md

package info (click to toggle)
golang-github-canonical-candid 1.12.3-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 3,016 kB
  • sloc: python: 1,903; sh: 235; makefile: 81
file content (26 lines) | stat: -rw-r--r-- 1,361 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# Multi-Factor Authentication

Candid supports WebAuthn multi-factor authentication that can be configured for the
static and LDAP identity providers.

## Supported browsers

WebAuthn is currently supported in Google Chrome, Mozilla Firefox, Microsoft Edge and Apple Safari (preview) web browsers, as well as Windows 10 and Android platforms.

For more info see [link](https://caniuse.com/?search=webauthn).

## Supported authenticators

Candid supports WebAuthn multi-factor authentications, which requires uses to register an external authenticator that supports [FIDO2](https://fidoalliance.org/fido2/fido2-web-authentication-webauthn/) such as Yubikey 5.

The first time a user logs in using an identity provider that is configured to require MFA, the user will be required to register an external authenticator. Following successful registration the user will be able to register multiple other authenticators.

On subsequent logins user will be required to present one of the registered authenticators before completing the login process.

### Lost authenticators

Should the user lose all registered authenticators, the Candid admin can user the **clear-mfa-credentials** command which will de-register all user's authenticators. Next time the user will be required to register a new authenticator.

Example:

> candid clear-mfa-credentials \<username\>