Configurer une application d'authentification
- Ouvrez le menu de votre avatar et sélectionnez Edit profile (Modifier le profil).
- Choisissez Access → Password and authentication (Accès → Mot de passe et authentification).
- Sous One-time password authenticator (Application d'authentification à mot de passe à usage unique), choisissez Register authenticator (Configurer l'application d'authentification).
Ajouter GitLab à Sign In
Utilisez Sign In, notre application d’authentification, pour générer vos codes de vérification directement sur votre iPhone.
- Avec le code QR de configuration sur un autre écran, ouvrez Sign In et touchez Add (Ajouter) → Scan QR Code (Scanner le code QR).
- Scannez le code, vérifiez les informations du compte, puis touchez Add Account (Ajouter le compte).
- Saisissez votre mot de passe actuel et le code à six chiffres dans GitLab, puis choisissez Register with two-factor app (Enregistrer une application d’authentification à deux facteurs). Téléchargez vos codes de récupération.
GitLab fournit les détails de configuration pour une saisie manuelle ainsi qu'un code QR. Dans Sign In, choisissez Add (Ajouter) → Enter Setup Key (Saisir la clé de configuration), indiquez GitLab dans Service (Service) et le nom de votre compte dans Account (Compte), collez la clé de configuration dans Key (Clé), puis touchez Add Account (Ajouter le compte). Gardez cette clé de configuration confidentielle.
Enregistrer les codes de récupération
Conservez le fichier gitlab-recovery-codes.txt en lieu sûr, en dehors de votre téléphone. Chaque code fonctionne une seule fois. Lors de la demande d'authentification, choisissez Recover your account (Récupérer votre compte) pour en utiliser un.
Si ceux-ci ne sont pas disponibles, consultez les instructions de récupération de GitLab pour votre instance. Préparez la récupération avant de remplacer votre téléphone.
Exigences relatives à Git et à l'organisation
Après avoir activé l'authentification à deux facteurs, utilisez un jeton d'accès personnel pour Git via HTTPS ou l'accès à l'API au lieu de votre mot de passe. La politique du groupe ou de l'instance peut exiger l'authentification à deux facteurs. Les appareils WebAuthn compatibles offrent une autre option de vérification.
Si un code ne fonctionne pas
Vérifiez que l’entrée GitLab dans Sign In correspond au compte auquel vous souhaitez vous connecter. Attendez un nouveau code et saisissez-le avant qu’il n’expire. Si les nouveaux codes sont toujours refusés, vérifiez que la date et l’heure de votre iPhone sont réglées automatiquement.
Restez connecté sur les appareils où vous l’êtes déjà et gardez vos informations de récupération à portée de main pendant que vous résolvez le problème. Ajouter une entrée dans Sign In ne suffit pas à terminer la configuration : GitLab doit accepter un code et confirmer l’activation.