TOTP-Code berechnen: So entsteht der 6-stellige Einmalcode

Inhalt
Die sechsstellige Zahl in Apps wie Google Authenticator oder Authy wird Ihnen nicht in Echtzeit von einem Server geschickt. Ihr Gerät berechnet sie selbst – allein aus einem geheimen Schlüssel und der aktuellen Uhrzeit. Deshalb erscheint der Code auch im Flugmodus, und deshalb stimmt er nicht mehr, wenn die Uhr des Geräts falsch geht.
Dieser Artikel zeigt anhand der Standards (RFC), in welcher Reihenfolge die sechs Ziffern entstehen und was ein QR-Code enthält. Er richtet sich an alle, die nicht über die Wahl eines Verfahrens entscheiden, sondern die Funktionsweise als überprüfbare Tatsache nachvollziehen möchten.
Zusammenfassung ① Der Base32-Schlüssel ist die einzige geheime Zutat für den Code. Aussteller und Konto sind nur Bezeichnungen in der App-Liste und fließen nicht in die Berechnung der sechs Ziffern ein. ② Die sechs Ziffern entstehen so: Aus dem geheimen Schlüssel (dem „Schlüssel“) und einem Zähler (der „Nachricht“), nämlich der aktuellen UTC-Zeit geteilt durch 30 Sekunden, wird per HMAC-SHA1 ein Wert berechnet. Dieser wird gekürzt und durch 1.000.000 geteilt; der Rest ist der Code. ③ Meist stimmt der Code nicht, weil die Gerätezeit abweicht oder weil der geheime Schlüssel Zeichen enthält, die es in Base32 nicht gibt (z. B. 0, 1, 8, 9).
Wenn unklar ist, warum der Code nicht stimmt
Stellen Sie sich vor, Sie wechseln auf ein neues Smartphone und ziehen Ihre Authenticator-App um. Der QR-Code lässt sich nicht erneut anzeigen, also öffnen Sie die Eingabe „Setup-Schlüssel manuell eingeben“. Die App fragt nach drei Angaben: geheimer Schlüssel, Aussteller und Kontoname.
Wer nicht weiß, was wohin gehört und welche der drei Angaben den Code tatsächlich beeinflusst, füllt die Felder nach Gefühl aus. Erscheint nach der Einrichtung die Meldung „Der Code ist ungültig“, lässt sich nicht unterscheiden, ob der Schlüssel falsch ist oder die Uhr abweicht.
Das Problem: Wie die sechs Ziffern entstehen, bleibt in der App verborgen. Wenn Sie das Prinzip einmal nachvollzogen haben, können Sie selbst erkennen, in welchem Schritt der Fehler liegt.
Der Standardablauf: die sechs Ziffern ohne Hilfsmittel berechnen
TOTP ist ein offener Standard. Die Regeln zur Code-Erzeugung stehen vollständig in den RFC-Dokumenten, sodass sich derselbe Wert bei Bedarf von Hand oder per Kommandozeile nachvollziehen lässt.
Was die drei Eingaben bedeuten
Zunächst sollten Sie die Rolle der drei Felder unterscheiden, nach denen die App fragt.
- Base32-Schlüssel (Secret): Das ist das Ausgangsmaterial, das sich Server und Ihr Gerät teilen. Es ist der einzige geheime Wert, der in die Berechnung eingeht.
- Aussteller (Issuer): Der Name des Dienstes, der in der App-Liste angezeigt wird, etwa „Google“ oder „GitHub“.
- Konto (Account): E-Mail-Adresse oder Benutzername, um mehrere Konten desselben Dienstes zu unterscheiden.
Entscheidend ist: Die beiden letztgenannten Werte spielen für die Berechnung überhaupt keine Rolle. Sie können die Bezeichnungen beliebig ändern – die sechs Ziffern bleiben gleich.
Die fünf Schritte bis zu den sechs Ziffern
Das ist der Ablauf nach RFC 4226 (HOTP) und RFC 6238 (TOTP).
- Base32-Dekodierung: Der geheime Schlüssel wird in Bytes zurückverwandelt. Base32 (RFC 4648) verwendet nur die 32 Zeichen A–Z und 2–7 und fasst die Daten in 5-Bit-Gruppen zusammen, die wieder in 8-Bit-Einheiten aufgelöst werden.
- Uhrzeit in einen Zähler umwandeln: Die seit dem 1. Januar 1970 (UTC) vergangenen Sekunden (Unixzeit) werden durch 30 geteilt; der ganzzahlige Quotient ist der Zähler. 30 Sekunden sind das Standardintervall in RFC 6238. Dieser Wert wird als 8 Bytes geschrieben.
- HMAC-SHA1: Mit dem geheimen Schlüssel als Schlüssel und dem 8-Byte-Zähler als Nachricht berechnen Sie HMAC-SHA1. Das Ergebnis ist ein Hash mit 20 Bytes.
- Dynamische Kürzung (Dynamic Truncation): Die unteren 4 Bits des letzten der 20 Bytes legen die Startposition (0–15) fest. Ab dort werden 4 Bytes entnommen; das höchstwertige Bit wird verworfen, sodass eine 31-Bit-Ganzzahl entsteht.
- Auf sechs Ziffern kürzen: Der Rest dieser Zahl bei Division durch 1.000.000 ergibt die sechs Ziffern. Fehlen vorne Stellen, wird mit Nullen aufgefüllt.
Bei gleichem geheimem Schlüssel und gleichem 30-Sekunden-Intervall ist das Ergebnis überall auf der Welt identisch. Deshalb stimmen der Code des Servers und der Code Ihrer App überein.
Was ein QR-Code enthält
Ein QR-Code ist kein Bild im eigentlichen Sinn, sondern enthält eine einzelne URI-Zeile. Das Format sieht so aus:
otpauth://totp/Aussteller:Konto?secret=Schlüssel&issuer=Aussteller
Den Code bestimmt hier allein secret. Aussteller:Konto am Anfang und issuer sind Beschriftungen, mit denen die App den Namen in der Liste anzeigt. Deshalb führt das Scannen des QR-Codes zum selben Ergebnis wie die manuelle Eingabe des geheimen Schlüssels.
Per Kommandozeile überprüfen
Zum Nachvollziehen genügt eine Zeile mit dem quelloffenen Kommandozeilenprogramm oathtool (oath-toolkit):
oathtool --totp -b JBSWY3DPEHPK3PXP
-b bedeutet, dass der geheime Schlüssel Base32-kodiert ist; die Ausgabe ist der sechsstellige Code für genau diesen Moment. Führen Sie den Befehl 30 Sekunden später erneut aus, ändert sich der Wert. Mit den Standardbibliotheken hmac und hashlib von Python lassen sich dieselben fünf Schritte ebenfalls in wenigen Zeilen umsetzen.
Probieren wir es mit unserem Tool aus.
Ohne Registrierung im Browser: Base32-Schlüssel und QR-Code erzeugen und den 6-stelligen Code im 30-Sekunden-Takt live berechnen lassen.

Häufige Missverständnisse
„Wenn ich Aussteller oder Konto ändere, ändert sich auch der Code.“ Nein. Wie oben gezeigt, werden die sechs Ziffern allein durch den geheimen Schlüssel und die Uhrzeit bestimmt. Die Rolle der drei Eingaben noch einmal im Überblick:
| Eingabe | Rolle | Einfluss auf die sechs Ziffern |
|---|---|---|
| Base32-Schlüssel | einzige geheime Zutat der Berechnung (Schlüssel) | Ja |
| Aussteller (Issuer) | Dienstname in der App-Liste | Nein |
| Konto (Account) | Bezeichnung zur Unterscheidung der Konten | Nein |
„Der Code stimmt ständig nicht.“ Die häufigste Ursache ist eine abweichende Uhrzeit. Der Zähler entsteht aus der UTC-Zeit des Geräts geteilt durch 30. Weicht die Uhr des Smartphones um mehr als einige Dutzend Sekunden vom Server ab, ergeben sich unterschiedliche Zähler und damit unterschiedliche Codes. Manche Prüfserver tolerieren zwar das Intervall davor oder danach, aber bei größeren Abweichungen passt es am Ende nicht mehr.
„Beim Eingeben des Schlüssels erscheint ein Fehler.“ Dann enthält er Zeichen, die es in Base32 nicht gibt. Base32 verwendet nur A–Z und 2–7; kommen 0, 1, 8, 9 oder Sonderzeichen vor, scheitert bereits die Dekodierung. Groß- und Kleinschreibung sowie Leerzeichen werden meist automatisch bereinigt, fehlende Zeichen lassen sich aber nicht wiederherstellen.
| Kategorie | Zeichen |
|---|---|
| In Base32 verwendete Zeichen | A–Z, 2–7 |
| Nicht verwendete Zeichen (führen zum Fehler) | 0, 1, 8, 9 und Sonderzeichen |
„Warum ändert sich der Code alle 30 Sekunden?“ Weil der Zähler der ganzzahlige Quotient aus „Zeit ÷ 30“ ist. Sobald ein 30-Sekunden-Intervall endet, erhöht sich der Quotient um 1. Mit dem neuen Zähler ändern sich das HMAC-Ergebnis und damit die sechs Ziffern vollständig. Der Fortschrittsbalken auf dem Bildschirm zeigt die Sekunden bis zum Ende des aktuellen Intervalls.
Zusammenfassung
- Die sechs Ziffern werden nicht vom Server gesendet, sondern berechnet. Es gibt nur zwei Zutaten: den geheimen Schlüssel und die aktuelle UTC-Zeit.
- Der Standardablauf hat fünf Schritte. Base32-Dekodierung → Uhrzeit als 30-Sekunden-Zähler → HMAC-SHA1 → dynamische Kürzung → Rest bei Division durch 1.000.000.
- Den Code verändern nur der geheime Schlüssel und die Uhrzeit. Aussteller und Konto sind Bezeichnungen und gehen nicht in die Berechnung ein.
- Ein QR-Code ist eine einzelne
otpauth://-URI, und der darin tatsächlich verwendete Wert istsecret. - Wenn der Code nicht passt, gibt es meist zwei Ursachen. Die Gerätezeit weicht ab, oder der Schlüssel enthält Zeichen, die es in Base32 nicht gibt.
Das folgende Tool führt diese fünf Schritte in Echtzeit im Browser aus und zeigt, sobald Sie einen geheimen Schlüssel eingeben, QR-Code, sechsstelligen Code und verbleibende Zeit zusammen an. Es ist unser kostenloser TOTP-Generator und 2FA-Tester.
Ohne Registrierung im Browser: Base32-Schlüssel und QR-Code erzeugen und den 6-stelligen Code im 30-Sekunden-Takt live berechnen lassen.
Häufig gestellte Fragen
Kann ich den sechsstelligen Code prüfen, ohne ihn in einer App einzurichten?
Ja. Mit einem gültigen Base32-Schlüssel führt der Browser die HMAC-SHA1-Berechnung direkt aus und zeigt Ihnen den sechsstelligen Code im 30-Sekunden-Takt an. Der Schlüssel wird nicht an einen Server gesendet; die Berechnung erfolgt auf dem Bildschirm.
Warum stimmen die Codes auf verschiedenen Geräten und auf dem Server überein?
Weil TOTP nur einen festen geheimen Schlüssel und die weltweit einheitliche koordinierte Weltzeit (UTC) verwendet. Bei gleichem Schlüssel und gleichem 30-Sekunden-Intervall ist das Ergebnis identisch. Deshalb stimmen die Codes nicht mehr überein, wenn die Uhren der Geräte voneinander abweichen.
Darf der geheime Schlüssel Kleinbuchstaben oder Leerzeichen enthalten?
In der Regel ja. Bei der Standardverarbeitung werden Kleinbuchstaben in Großbuchstaben umgewandelt und Leerzeichen entfernt, bevor dekodiert wird. Enthält der Schlüssel aber Zeichen, die es in Base32 gar nicht gibt, etwa 0, 1, 8 oder 9, tritt in diesem Schritt ein Fehler auf.
Kann ich einen Code eingeben, der kurz vor Ablauf der 30 Sekunden angezeigt wurde?
Wechselt das Intervall, ändert sich der Zähler und damit auch der Code. Viele Prüfserver sind jedoch so ausgelegt, dass sie den Code des unmittelbar vorherigen Intervalls noch kurz akzeptieren; dann klappt es auch, wenn das Intervall während der Eingabe wechselt. Wie großzügig das gehandhabt wird, unterscheidet sich von Server zu Server.
Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen