2FA bei Assembla: So richtest du eine Authenticator-App ein

Assembla hostet Perforce-, Subversion- und Git-Repositorys zusammen mit Projektmanagement-Werkzeugen (Assembla), deine Anmeldung bei Assembla schützt also oft Quellcode. Assembla unterstützt Zwei-Faktor-Authentifizierung (2FA) mit einer Authenticator-App, und ein Portfolio-Owner kann sie für alle im Portfolio verpflichtend machen. Zwei Dinge sind anders als üblich. Der Einrichtungsbildschirm zeigt dir einen QR-Code und sonst nichts, keinen Schlüssel zum Eintippen. Und sobald 2FA aktiv ist, funktioniert dein Passwort in Repository-Clients nicht mehr (Assembla).

Diese Anleitung verwendet Authenticator App - Novaz auf dem iPhone. Jede Authenticator-App, die zeitbasierte Codes erzeugt, funktioniert genauso.

Wie wir diese Anleitung geprüft haben: Die Schritte für Assembla stammen aus dem Hilfecenter von Assembla, einschließlich des Bildschirmfotos im 2FA-Artikel (unten verlinkt), das wir am 21. Oktober 2026 gelesen haben. Wir haben sie nicht mit einem Assembla-Konto getestet, daher kann ein Label leicht abweichen. Die Schritte für Novaz sind mit der App in Version 1.0.5 geprüft.

Bevor du anfängst

• Anmeldung per SSO? Laut Assembla hat ein Konto mit Single Sign-on kein Passwort, und ohne Passwort kannst du die eigene 2FA von Assembla nicht einschalten (Assembla).
• Google-2FA in deinem Portfolio: Derselbe Artikel weist darauf hin, dass diese Methode Vorrang hat, wenn ein Portfolio Google-2FA verlangt. Mehr erklärt er dazu nicht.
• Die App-Liste ist alt. Die Liste von Assembla enthält noch Windows Phone, aber die Codes sind normale zeitbasierte Codes, Novaz kann also denselben QR-Code scannen.

2FA mit einer Authenticator-App einschalten

Die Hilfe von Assembla beschreibt diese Schritte (Assembla):

1. Klicke oben auf der Seite auf deinen Avatar.
2. Wähle My Profile › Two-factor authentication (Mein Profil › Zwei-Faktor-Authentifizierung). Die Seite meldet, dass die Zwei-Faktor-Authentifizierung derzeit deaktiviert ist, und zeigt einen QR-Code.
3. Tippe in Novaz auf + und dann auf QR-Code scannen und richte die Kamera auf den Code auf deinem Computerbildschirm. Wenn Assembla auf demselben iPhone geöffnet ist, mach ein Bildschirmfoto, tippe auf + und dann auf Foto auswählen. Siehe QR-Code auf demselben iPhone scannen.
4. Gib unter Confirm current password (Aktuelles Passwort bestätigen) dein Assembla-Passwort ein.
5. Gib unter Enter the six-digit code from the application (Sechsstelligen Code aus der App eingeben) den aktuellen Code aus Novaz ein.
6. Klicke auf Enable (Aktivieren).
7. Sichere die Datei mit dem Wiederherstellungscode, die Assembla dir gibt. Sie ist dein Weg zurück, wenn das Handy verloren geht.

Kein Einrichtungsschlüssel auf der Seite

Der Bildschirm von Assembla zeigt keinen Textschlüssel. Die Hilfe schlägt einen Umweg vor, falls dein Handy nicht scannen kann: Entschlüssle den QR-Code mit einer separaten Lese-App, etwa einem QR-Reader für den Desktop, um einen otpauth://-Link zu erhalten. Der Teil secret= dieses Links ist der Schlüssel. In Novaz würdest du ihn über + › Schlüssel manuell eingeben als Einrichtungsschlüssel eintippen. Siehe Was ist ein 2FA-Einrichtungsschlüssel?

Mit Novaz ist Scannen einfacher. Ein eingetippter Schlüssel braucht mindestens 16 Zeichen, und Assembla sagt nicht, wie lang sein Schlüssel ist.

Deine Datei mit Wiederherstellungscodes

Assembla gibt dir beim Einschalten der 2FA eine Datei mit Wiederherstellungscodes. Wenn das Handy verschwindet und du kein Backup von Novaz hast oder Assembla nach deiner letzten Backup-Datei hinzugefügt hast, kommst du mit dieser Datei wieder hinein. Bewahre sie an einem Ort auf, an den du ohne dieses Handy kommst. Die Hilfe von Assembla sagt nicht, wie viele Codes die Datei enthält oder wie du einen neuen Satz bekommst. Mehr dazu unter 2FA-Backup-Codes.

Clients für Git, SVN und Perforce

Mit 2FA können externe Clients mit deinem Benutzernamen und Passwort weder Code auschecken noch committen. Erstelle stattdessen einen API-Schlüssel (Assembla, Assembla):

1. Klicke auf deinen Avatar und dann auf My Profile › API Applications & Sessions (API-Anwendungen & Sitzungen).
2. Setze das Häkchen bei Repository access (Repository-Zugriff) und klicke auf Create (Erstellen).
3. Melde dich in deinem Client mit deinem Assembla-Benutzernamen an und verwende das API-Secret anstelle des Passworts.

Wenn sie Pflicht ist

Wenn ein Portfolio-Admin die Pflicht einschaltet (More › Portfolio Admin, dann Enabled im Bereich Two-factor Authentication und Update 2FA Settings), müssen Mitglieder ohne 2FA sie bei ihrer nächsten Anmeldung einrichten. Bis dahin kommen sie überhaupt nicht in Assembla hinein (Assembla).

Wenn Assembla deinen Code ablehnt

Die Hilfe von Assembla gibt keine Hinweise zu abgelehnten Codes. Die häufigste Ursache ist eine abweichende Uhr des Handys. Öffne auf dem iPhone Einstellungen › Allgemein › Datum & Uhrzeit und schalte Automatisch einstellen ein. Novaz zeigt eine Warnung, wenn die Uhr um 15 Sekunden oder mehr abweicht. Weitere Ursachen findest du unter Authenticator-Code funktioniert nicht?

Neues Handy, Handy verloren oder 2FA ausschalten

Assembla behandelt alle drei Fälle gleich: 2FA ausschalten und dann mit dem neuen Gerät wieder einschalten (Assembla).

1. Klicke auf deinen Avatar und dann auf My Profile › Two-factor Authentication.
2. Gib dein Passwort in Confirm current password ein.
3. Gib in Enter the six-digit code from the application einen Code ein. Wenn du das Handy verloren hast, kommt laut Assembla ein unbenutzter Wiederherstellungscode in dieses Feld.
4. Klicke auf Disable (Deaktivieren). Danach kannst du 2FA neu einrichten.

Wenn du ohne Backup von Novaz das Handy wechselst, erledige das, solange das alte iPhone noch funktioniert. Mit einem iCloud-Backup oder einer Backup-Datei kannst du deine Konten stattdessen auf dem neuen iPhone wiederherstellen. Siehe So überträgst du deine Authenticator-App auf ein neues iPhone.

Wenn du sowohl das Handy als auch die Wiederherstellungsdatei verloren hast, bittet Assembla dich, eine E-Mail an support@assembla.com zu schreiben, damit dein Konto zurückgesetzt wird. Die Hilfe sagt nicht, welche Nachweise der Support verlangt oder wie lange es dauert. Siehe auch Handy mit der Authenticator-App verloren?

Offizielle Hilfe von Assembla

• Using Two-Factor Authentication with your Assembla Account
• Working on my Repos with Third Party Authentication
• Assembla: Managed Cloud Hosting For Perforce, SVN & Git