Compte et connexion¶
Se connecter¶
La page de connexion demande votre identifiant et votre mot de passe, puis, si votre compte a un TOTP (obligatoire
pour les administrateurs), le code de votre application d'authentification. Après plusieurs échecs, le compte est
verrouillé de plus en plus longtemps (réglage auth.max_failed_logins).
Votre adresse e-mail¶
À la première connexion, avant toute autre page, il vous est demandé d'enregistrer une adresse e-mail. C'est vrai
pour tous les comptes humains, y compris l'administrateur initial (admin).
- SMTP non configuré : l'adresse est simplement enregistrée.
- SMTP configuré (voir la page SMTP) : un code à 6 chiffres est envoyé à l'adresse. Saisissez-le sur la même page. Le code est valable 15 minutes, accepte 5 essais, et on ne peut en redemander un qu'une fois par minute.
- Changer d'adresse plus tard (page « Moi ») annule la vérification : le code est à nouveau demandé.
Cette étape ne concerne que les sessions web. Les jetons personnels, les comptes de service et la CLI locale
(harness-admin) ne sont jamais bloqués.
Un administrateur peut désactiver l'exigence avec le réglage auth.require_email (défaut : activé).
Mot de passe oublié¶
Si l'instance sait envoyer des e-mails (SMTP réglé et instance.public_url renseigné), la page de connexion
propose le lien Mot de passe oublié ?. Sinon, le lien est absent et les adresses /forgot et /reset/… répondent
« introuvable » : demandez alors à un administrateur de réinitialiser votre accès.
- Saisissez votre identifiant ou votre adresse e-mail. La réponse est toujours la même, que le compte existe ou non.
- Si le compte existe et que son adresse a été vérifiée, vous recevez un lien valable
auth.password_reset_minutesminutes (30 par défaut), utilisable une seule fois. Une nouvelle demande annule le lien précédent. - Ouvrez le lien, choisissez un nouveau mot de passe (12 caractères minimum).
- Toutes vos sessions web sont fermées ; vous recevez un e-mail d'avis. Si vous n'êtes pas à l'origine de la réinitialisation, prévenez un administrateur.
Le TOTP reste exigé à la connexion suivante : la réinitialisation ne change pas votre second facteur. Si vous avez aussi perdu votre application d'authentification, un administrateur doit vous aider.
Les demandes sont limitées (10 par adresse IP et 10 minutes, 3 e-mails par compte et par heure) : au-delà, la page répond comme d'habitude mais aucun e-mail n'est envoyé. Un lien de réinitialisation n'apparaît jamais dans les journaux.