Aller au contenu

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.

  • 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.
  • 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 update sur core.SystemSettings. Les rôles editor et viewer créé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.

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.

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.

É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.

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à :

Fenêtre de terminal
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.

Fenêtre de terminal
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.

Chaque compte s’enrôle à la connexion :

  1. Le compte se connecte avec courriel et mot de passe.

  2. 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.

  3. Le compte scanne le code QR, ou colle la clé manuelle, dans une application d’authentification. La page de configuration affiche un URI otpauth://.

  4. Le compte tape le code à 6 chiffres et confirme.

  5. Facet bascule mfa_enabled sur le compte et affiche 10 codes de secours.

L’appel de vérification renvoie les codes de secours une seule foisà :

Fenêtre de terminal
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.

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.

Quand un compte perd son authentificateur et ses codes de secours, un administrateur efface son MFAà:

Fenêtre de terminal
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é.

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.

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.

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.

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 type de facteur en cours est none. Mettez d’abord le type à totp ; le sélecteur apparaît pour l’enregistrement.

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.