Protéger la connexion par un code à usage unique
XOA-HL peut demander, après le mot de passe, un code à usage unique de 6 chiffres produit par une application d’authentification. Le code change avec le temps (TOTP). Chaque compte qui se connecte avec un mot de passe local l’active pour lui-même. Essayez-le d’abord sur un compte non administrateur créé pour ce test.
xoa-image-20261022-a280852, paquet v5.113.2_e281c536-ce40 (Xen Orchestra 5.113.2). Rédigé d’après le code publié ; pas encore testé en laboratoire. Les versions ultérieures peuvent différer.Avant de commencer
| Il vous faut | Pourquoi |
|---|---|
| Une application d’authentification TOTP sur un appareil que vous maîtrisez | Elle génère les codes à partir d’un secret partagé |
| L’heure exacte sur l’appliance et sur cet appareil | XO accepte le code courant et ceux des pas de 30 secondes juste avant et juste après |
| Un second administrateur, ou un plan de récupération distinct | Sans cela, la perte de l’appareil peut bloquer l’unique administrateur |
| Une session de navigateur que vous gardez ouverte pendant le test | Elle permet de retirer le code à usage unique si la vérification échoue |
Pendant l’activation, c’est votre navigateur qui vérifie le code saisi, avec sa propre horloge. À la connexion, c’est l’appliance qui vérifie le code, avec la sienne. Un code accepté à l’activation ne prouve donc pas que l’heure de l’appliance est correcte.
Activer un code à usage unique pour votre compte
- Connectez-vous avec le compte à protéger. Ouvrez votre page utilisateur avec l’icône utilisateur du menu (
/#/user). - Repérez l’interrupteur OTP authentication et activez-le. La boîte de dialogue Add OTP authentication affiche un QR code et le secret en texte.
- Scannez le QR code, ou saisissez le secret, dans votre application d’authentification. La nouvelle entrée est émise par
Xen Orchestraet porte l’adresse e-mail ou l’identifiant du compte. - Saisissez le code courant dans OTP code et confirmez. Si le code est faux, la boîte de dialogue se rouvre : saisissez le code que l’application affiche à ce moment. Annuler laisse le code à usage unique désactivé.
Si l’interrupteur est absent, arrêtez-vous et notez la version installée. Ce build utilise le plan open source par défaut de XO, qui affiche l’interrupteur : l’absence d’abonnement n’en est donc pas la cause. Signalez la différence.
Vérification : l’interrupteur est activé, et votre page utilisateur affiche le secret et son QR code à côté. Toute personne qui les voit peut générer des codes valides : ne partagez pas cette page et n’en faites pas de capture d’écran. Ce QR code indique l’émetteur XenOrchestra (sans espace) pour le même secret. Gardez l’entrée déjà présente dans votre application ; ne le scannez pas de nouveau.
Vérifier la connexion dans une nouvelle session
- Gardez votre session actuelle ouverte. Ouvrez une fenêtre de navigation privée et connectez-vous avec votre nom d’utilisateur et votre mot de passe.
- Une deuxième page demande un Code. Saisissez le code courant de l’application et sélectionnez Sign in.
- Un code faux ou expiré affiche
Invalid code. Attendez le code suivant et réessayez. - Vérifiez que vous êtes connecté au bon compte, puis fermez la fenêtre privée.
Vérification : la connexion a demandé un code et a accepté le bon. Si elle échoue à chaque fois, utilisez la session ouverte pour retirer le code à usage unique, vérifiez les deux horloges, puis réactivez-le.
Ce que le code à usage unique ne protège pas
- L’activer ne ferme pas les sessions existantes et ne révoque pas les jetons. Tout jeton d’authentification valide évite la vérification du code, y compris les jetons créés plus tard : les jetons sont des identifiants distincts. Après l’activation, ouvrez Authentication tokens sur votre page utilisateur et supprimez les jetons que vous ne reconnaissez pas ou dont vous n’avez plus besoin. Un script qui utilise un jeton supprimé cesse de fonctionner.
- Il protège uniquement la connexion web à XO pour ce compte. Il ne protège ni l’accès SSH ou console à l’appliance, ni XO Lite ou le compte root de l’hôte, ni les autres comptes XO.
- Les fournisseurs de connexion externes et leur propre authentification à plusieurs facteurs ne sont pas traités ici.
Retirer un code à usage unique
- Votre propre compte : sur votre page utilisateur, désactivez OTP authentication et confirmez Remove OTP authentication.
- Un autre compte, en tant qu’administrateur : ouvrez Paramètres → Utilisateurs. Dans la colonne OTP, sélectionnez Supprimer pour ce compte et confirmez. Vérifiez d’abord qui fait la demande, par exemple par un autre canal. L’utilisateur peut ensuite configurer un nouvel appareil.
Les comptes sans code à usage unique affichent Non configuré dans cette colonne. Si l’unique administrateur perd son appareil, l’interface ne propose aucun moyen de récupérer l’accès. Depuis la console de l’appliance, vous pouvez encore récupérer l’accès administrateur. Un second administrateur reste plus simple : gardez-en un.
Vérification : l’interrupteur est désactivé et la colonne OTP du compte affiche Non configuré. Dans une nouvelle fenêtre privée, le compte se connecte avec son nom d’utilisateur et son mot de passe locaux, sans code. Gardez l’administrateur de secours connecté jusqu’à cette confirmation.
Sources
- Page utilisateur et activation : section OTP de la page utilisateur, page utilisateur et jetons, boîte de dialogue d’activation, actions d’activation et de retrait, colonne OTP des paramètres Utilisateurs.
- Connexion et jetons : pages de connexion, formulaire de connexion, authentification et contournement par jeton, fenêtre de temps TOTP, commande de récupération, libellés de l’interface.
- Build et activation dans le navigateur : plan XO par défaut, authentificateur du navigateur, API des préférences utilisateur, build HomeLab.