Configuration de l’authentification à deux facteurs
O3 prend en charge l’authentification à deux facteurs avec des mots de passe à usage unique basés sur le temps (TOTP). Les utilisateurs qui s’inscrivent scannent un code QR avec une application d’authentification, comme Google Authenticator, Microsoft Authenticator ou Authy. Ensuite, à chaque connexion, ils saisissent après leur mot de passe le code à 6 chiffres affiché par l’application. Les utilisateurs qui ne se sont pas inscrits continuent de se connecter avec leur seul mot de passe.
L’authentification à deux facteurs est désactivée par défaut. Pour l’activer, il faut configurer le backend et le frontend.
Prérequis
- Le module backend authentication , version 2.4.0 ou ultérieure. Les versions antérieures n’ont pas les points de terminaison d’inscription qu’utilise l’application de connexion O3.
@openmrs/esm-login-app11.0.0 ou ultérieur, de Core v11.
La Reference Application inclut les deux à partir de la version 3.8.0, mais ne configure pas l’authentification à deux facteurs.
Configurer le backend
Le module authentication lit ses paramètres dans le fichier des propriétés d’exécution (runtime properties) d’OpenMRS, et non dans les propriétés globales. Ajoutez-y ces lignes :
authentication.scheme=2fa
authentication.scheme.2fa.type=org.openmrs.module.authentication.web.TwoFactorAuthenticationScheme
authentication.scheme.2fa.config.primaryOptions=basic
authentication.scheme.2fa.config.secondaryOptions=totp
authentication.scheme.basic.type=org.openmrs.module.authentication.web.BasicWebAuthenticationScheme
authentication.scheme.basic.config.loginPage=/spa/login
authentication.scheme.totp.type=org.openmrs.module.authentication.web.TotpAuthenticationScheme
authentication.scheme.totp.config.loginPage=/spa/login/totp-challenge2faetbasicsont des identifiants de schéma que vous pouvez renommer, à condition de renommer chaque ligne qui les utilise. Le schéma TOTP doit garder l’identifianttotp, car l’application de connexion O3 l’utilise.- Les deux paramètres
loginPagedirigent les utilisateurs vers les pages de connexion O3. Sans eux, le module utilise ses valeurs par défaut, qui pointent vers des pages de l’ancienne interface.
Redémarrez OpenMRS après avoir modifié ces paramètres.
Dans l’image Docker de la Reference Application, le fichier des propriétés d’exécution est
/openmrs/data/openmrs-runtime.properties, sur le volume de données du backend, et il est conservé entre les
redémarrages. Modifiez ce fichier. N’utilisez pas les variables d’environnement OMRS_EXTRA_* pour ces paramètres :
l’image de la Reference Application 3.8.0 met leurs noms en minuscules, alors que le module cherche des clés en
casse mixte comme primaryOptions et loginPage.
Configurer le frontend
Activez la page d’inscription dans votre configuration frontend :
{
"@openmrs/esm-login-app": {
"twoFactorAuth": {
"enabled": true
}
}
}Cela ajoute au menu utilisateur un lien Two-Factor Authentication, qui ouvre la page d’inscription. Vous pouvez changer le titre de la page avec twoFactorAuth.dashboardTitle. La page où les utilisateurs saisissent leur code à la connexion ne dépend pas de ce paramètre.
S’inscrire
Ouvrir la page d’inscription
Dans le menu utilisateur (My Account), choisissez Two-Factor Authentication.
Configurer l’application d’authentification
Sous Authenticator App, cliquez sur Set up. Scannez le code QR avec une application d’authentification, ou saisissez la clé de configuration affichée en dessous.
Confirmer
Saisissez le code à 6 chiffres de l’application et cliquez sur Confirm and enable authenticator app. La page indique alors l’application d’authentification comme Enabled.
Se connecter
Lorsqu’un utilisateur inscrit a saisi son mot de passe, O3 affiche la page Two-Factor Verification. Il saisit le code à 6 chiffres actuel de son application et clique sur Verify, puis choisit un lieu comme d’habitude. Si le code est erroné, il reste sur la page et peut réessayer.
Se souvenir de cet appareil
La page de vérification comporte une case Remember this device, cochée par défaut. Elle n’a d’effet que si vous l’activez dans le backend :
authentication.scheme.2fa.config.rememberMeEnabled=trueAvec ce paramètre, un utilisateur qui coche la case reçoit un cookie qui lui évite l’étape du code sur ce navigateur pendant 30 jours. Par défaut, le cookie est marqué Secure : il n’est donc envoyé qu’en HTTPS. Le README du module authentication liste les autres paramètres de cette fonction, comme sa durée.
Réinitialiser l’inscription d’un utilisateur
Les utilisateurs ne peuvent pas encore supprimer leur propre inscription : le bouton Remove de la page d’inscription est désactivé. Si un utilisateur perd l’accès à son application d’authentification, un administrateur peut vider deux propriétés utilisateur, authentication.secondaryType et authentication.totp.secret. L’utilisateur peut alors se connecter avec son seul mot de passe et s’inscrire à nouveau.
Pour le faire via l’API REST, lisez les propriétés actuelles de l’utilisateur, videz ces deux propriétés et renvoyez l’ensemble complet. La mise à jour de userProperties remplace toutes les propriétés de l’utilisateur : n’envoyer que les deux clés supprimerait donc les autres, comme defaultLocale.
# Lire les propriétés de l'utilisateur
curl -u admin:password "https://your-server/openmrs/ws/rest/v1/user/<user-uuid>?v=custom:(userProperties)"
# Les renvoyer avec les deux propriétés TOTP vidées
curl -u admin:password -H "Content-Type: application/json" \
-d '{"userProperties": {"defaultLocale": "en", "authentication.secondaryType": "", "authentication.totp.secret": ""}}' \
"https://your-server/openmrs/ws/rest/v1/user/<user-uuid>"Incluez toutes les propriétés renvoyées par la première requête, pas seulement defaultLocale, sauf celles nommées authentication.2fa.rememberMe.<id> (avec l’identifiant de votre schéma à deux facteurs à la place de 2fa). Chacune correspond à un navigateur sur lequel l’utilisateur a coché Remember this device. Laissez-les de côté pour que ces navigateurs doivent de nouveau saisir un code une fois que l’utilisateur se sera réinscrit.