Einen Authenticator registrieren
- Öffne dein Avatar-Menü und wähle Edit profile (Profil bearbeiten).
- Wähle Access → Password and authentication (Zugriff → Passwort und Authentifizierung).
- Wähle unter One-time password authenticator (Einmalpasswort-Authenticator) die Option Register authenticator (Authenticator registrieren).
GitLab zu Sign In hinzufügen
Mit Sign In, unserer Authenticator-App, erzeugst du Bestätigungscodes direkt auf deinem iPhone.
- Während der Einrichtungs-QR-Code auf einem anderen Bildschirm angezeigt wird, öffne Sign In und tippe auf Add → Scan QR Code (Hinzufügen → QR-Code scannen).
- Scanne den Code, überprüfe die Kontodetails und tippe auf Add Account (Konto hinzufügen).
- Gib dein aktuelles Passwort und den sechsstelligen Code bei GitLab ein und wähle dann Register with two-factor app (Mit Zwei-Faktor-App registrieren). Lade deine Wiederherstellungscodes herunter.
GitLab bietet Einrichtungsdetails für die manuelle Eingabe sowie einen QR-Code an. Wähle in Sign In Add → Enter Setup Key (Hinzufügen → Einrichtungsschlüssel eingeben), setze Service (Dienst) auf GitLab und Account (Konto) auf deinen Kontonamen, füge den Einrichtungsschlüssel in Key (Schlüssel) ein und tippe dann auf Add Account (Konto hinzufügen). Halte diesen Einrichtungsschlüssel geheim.
Wiederherstellungscodes speichern
Speichere gitlab-recovery-codes.txt sicher außerhalb deines Telefons. Jeder Code funktioniert einmal. Wähle bei der Abfrage des Authenticator-Codes Recover your account (Konto wiederherstellen), um einen zu verwenden.
Wenn dir diese Codes nicht zur Verfügung stehen, lies die Wiederherstellungsanweisungen von GitLab für deine Instanz. Bereite die Wiederherstellung vor, bevor du dein Telefon ersetzt.
Git- und Organisationsanforderungen
Verwende nach der Aktivierung von 2FA ein persönliches Zugriffstoken (Personal Access Token) anstelle deines Passworts für Git über HTTPS oder den API-Zugriff. Gruppen- oder Instanzrichtlinien können 2FA erfordern. Kompatible WebAuthn-Geräte bieten eine weitere Bestätigungsoption.
Wenn ein Code nicht funktioniert
Prüfe, ob der Eintrag für GitLab in Sign In zu dem Konto gehört, bei dem du dich anmelden möchtest. Warte auf einen neuen Code und gib ihn ein, bevor er abläuft. Werden auch neue Codes abgelehnt, prüfe, ob Datum und Uhrzeit auf deinem iPhone automatisch eingestellt werden.
Bleibe während der Fehlersuche auf bereits angemeldeten Geräten angemeldet und halte deine Wiederherstellungsinformationen bereit. Ein Eintrag in Sign In allein reicht nicht aus: GitLab muss den Code akzeptieren und die Aktivierung bestätigen.