Imposer le MFA
Facet prend en charge les mots de passe à usage unique basés sur le temps (TOTP) comme facteur de son authentification multifacteur (MFA). Vous décidez si les comptes sont invités à s’enrôler, ou doivent s’enrôler. Cette page couvre les deux niveaux d’application, les deux étages de configuration, l’enrôlement, et les chemins de récupération.
Quand l’utiliser
Section intitulée « Quand l’utiliser »- Vous devez exiger un second facteur à la connexion pour chaque compte.
- Vous devez libérer un compte qui a perdu son authentificateur.
- Vous devez expliquer pourquoi une connexion s’arrête sur un écran d’enrôlement.
Avant de commencer
Section intitulée « Avant de commencer »- La bonne page. Les réglages d’exécution vivent sur Configurer →
Plateforme → Paramètres, dans le chapitre Sécurité. Il vous faut le droit
updatesurcore.SystemSettings. Les rôleseditoretviewercréés par l’initialisation ont le chemin retranché de leurs attributions, si bien que la posture par défaut est réservée aux administrateurs. - Le côté du membre. Lisez Se connecter, MFA, réinitialiser votre mot de passe pour le côté titulaire du compte.
Explication
Section intitulée « Explication »Le facteur
Section intitulée « Le facteur »Le facteur est TOTP tel que spécifié par la RFC 6238 : un code à 6 chiffres qui change toutes les 30 secondes. Le compte garde le secret partagé dans une application d’authentification. Chaque compte porte aussi des codes de secours à usage unique comme chemin d’auto-récupération.
Les deux niveaux d’application
Section intitulée « Les deux niveaux d’application »| Niveau | Comportement |
|---|---|
preferred |
Facet demande à chaque compte non enrôlé de configurer le MFA après la connexion. Le compte peut décliner. Facet redemande à la prochaine connexion. |
always |
Facet retient chaque connexion non enrôlée à l’étape d’enrôlement. Aucune session n’existe tant que le compte n’a pas vérifié un premier code. |
Sous always, la retenue n’a ni retour ni annulation. L’étape d’enrôlement
n’offre aucune sortie, et le refresh du token demande une session qui
n’existe pas encore. Une organisation qui veut une sortie utilise
preferred.
Les deux étages de configuration
Section intitulée « Les deux étages de configuration »| Étage | Où | Clés |
|---|---|---|
| Exécution | core.SystemSettings |
iam.mfa.type (none ou totp), iam.mfa.enforcement (preferred ou always) |
| Fichier | config.{env}.yml |
iam.mfa.totp.enabled (un booléenà ; true se traduit en type totp, false en none), iam.mfa.enforcement |
La valeur d’exécution gagne quand elle est positionnée. Un champ d’exécution null signifie « suivre le fichier ». Chaque décision d’authentification lit directement la ligne du document d’exécution, jamais un cacheà ; un enregistrement s’applique donc aussitôt.
1. Positionner la politique d’exécution
Section intitulée « 1. Positionner la politique d’exécution »Ouvrez Configurer → Plateforme → Paramètres et allez au chapitre
Sécurité. Mettez Type de facteur MFA à totp, puis réglez
Application du MFA. Le sélecteur d’application ne s’affiche que tant que
le type de facteur est totp. Sélectionnez Enregistrer.
La page envoie une mise à jour partielle par la route de document standardà :
curl -k -X PATCH -H "Authorization: Bearer $FACET_API_KEY" \ -H "Content-Type: application/json" \ -d '{"iam": {"mfa": {"type": "totp", "enforcement": "always"}}}' \ "https://facet.localhost:3443/Api/core/SystemSettings/settings"La barrière d’écriture n’accepte que none ou totp pour le type, et
seulement preferred ou always pour l’application. Une valeur fausse
répond 422. Le hook de cycle de vie Lua refuse tout create et tout delete
du document des réglagesà ; seule la ligne settings créée par
l’initialisation existe.
2. Lire les valeurs effectives
Section intitulée « 2. Lire les valeurs effectives »curl -k -H "Authorization: Bearer $FACET_API_KEY" \ "https://facet.localhost:3443/Api/SystemSettings"La carte values porte les valeurs effectives, non secrètes, indexées par
chemin, par exemple "iam.mfa.enforcement": "always". La liste pinned
nomme les chemins que le document épingle actuellementà ; un chemin absent
suit le fichier.
3. Enrôler les comptes
Section intitulée « 3. Enrôler les comptes »Chaque compte s’enrôle à la connexion :
-
Le compte se connecte avec courriel et mot de passe.
-
Sous
always, la connexion s’arrête à « Configurer l’authentification àdeux facteurs ». Sous
preferred, Facet montre la même configuration comme une invite refermable après la connexion. -
Le compte scanne le code QR, ou colle la clé manuelle, dans une application d’authentification. La page de configuration affiche un URI
otpauth://. -
Le compte tape le code à 6 chiffres et confirme.
-
Facet bascule
mfa_enabledsur le compte et affiche 10 codes de secours.
L’appel de vérification renvoie les codes de secours une seule foisà :
curl -k -X POST -H "Authorization: Bearer $FACET_API_KEY" \ -H "Content-Type: application/json" \ -d '{"code": "123456"}' \ "https://facet.localhost:3443/Api/iam/mfa/totp/verify"La réponse porte "backup_codes": [...] et "mfa_enabled": true.
4. Informer les comptes des codes de secours
Section intitulée « 4. Informer les comptes des codes de secours »Une série contient 10 codes de 8 caractères hexadécimaux, présentés en
xxxx-xxxx. Facet les affiche une fois et ne stocke que leurs hachages
SHA-256. Chaque code marche exactement une fois. Le défi MFA accepte un code
avec method: "backup_code", si bien qu’un authentificateur perdu est un
chemin d’auto-récupération. Un réenrôlement fabrique une série neuve.
5. Récupérer un compte
Section intitulée « 5. Récupérer un compte »Quand un compte perd son authentificateur et ses codes de secours, un administrateur efface son MFAà:
curl -k -X POST -H "Authorization: Bearer $FACET_API_KEY" \ -H "Content-Type: application/json" \ -d '{"account_id": "01J8Z0A7G3Q5M2X9K4T6VBNR8D"}' \ "https://facet.localhost:3443/Api/iam/mfa/disable"La route exige la permission mfa_disable sur iam.Account. Le rôle
iam.Roles.admin créé par l’initialisation la détient par * sur *.*.
N’accordez pas mfa_disable à un rôle qu’une application externe peut
élireà ; voir
Rôles et lignes de permission. L’appel
efface le secret stocké, le compteur de rejeu, et les codes de secours, et
met mfa_enabled à false. Le compte se connecte et s’enrôle de nouveau.
La page du compte montre Réinitialiser le MFA pour cette récupérationà ; elle confirme avant l’appel et se cache pour un compte purement fédéré.
Limites de débit
Section intitulée « Limites de débit »| Surface | Limite | Effet |
|---|---|---|
| Vérification MFA à l’enrôlement | 5 codes faux par 5 minutes | Le point d’entrée répond 429 jusqu’à ce que la fenêtre expire. |
| Défi MFA à la connexion | 5 réponses fausses | Le défi est supprimé et le compte se verrouille pendant 5 minutes. |
| Enrôlement à la connexion | 5 codes faux sur le token | Le token meurt et le compte se verrouille. |
Un succès remet le compteur à zéro. Voir Sessions, tokens et verrouillages pour la gestion du verrouillage.
Dépannage
Section intitulée « Dépannage »La connexion s’arrête à l’écran d’enrôlement sans retour possible
Section intitulée « La connexion s’arrête à l’écran d’enrôlement sans retour possible »L’application est always et le compte n’est pas enrôlé. Terminez la
configuration, ou un administrateur repasse l’application à preferred.
La vérification répond 429
Section intitulée « La vérification répond 429 »Cinq codes faux ont été essayés en moins de 5 minutes. Attendez la fin de la fenêtre, puis réessayez avec un code frais.
L’écriture des réglages répond 403
Section intitulée « L’écriture des réglages répond 403 »Votre rôle ne peut ni lire ni mettre à jour core.SystemSettings. Les rôles
editor et viewer créés par l’initialisation ont le chemin retranchéà ;
utilisez un rôle d’administrateur, ou accordez le chemin explicitement.
Le sélecteur d’application a disparu
Section intitulée « Le sélecteur d’application a disparu »Le type de facteur en cours est none. Mettez d’abord le type à totp ; le
sélecteur apparaît pour l’enregistrement.
Un code ne marche pas
Section intitulée « Un code ne marche pas »Les codes changent toutes les 30 secondes. Attendez un code frais et saisissez-le aussitôt. Vérifiez que l’horloge du serveur est justeà ; TOTP en dépend.
Voir aussi
Section intitulée « Voir aussi »- Se connecter, MFA, réinitialiser votre mot de passe — les étapes d’enrôlement et de connexion du titulaire du compte.
- Gérer les comptes — le champ
mfa_enabledet l’action de réinitialisation. - Sessions, tokens et verrouillages — le verrouillage que posent les limites de débit.
- La rétention — la durée de vie des défis MFA.
- Internes sur GitHubà : iam.md, system-settings.md.