TOTP-Codes aus einem Geheimnis erzeugen, ohne dass es den Browser verlässt

Ein zeitbasiertes Einmalpasswort nach RFC 6238 ist ein HMAC über einen Zähler, und der Zähler ist die aktuelle Unix-Zeit geteilt durch die Periode, meist 30 Sekunden. Schlüssel des HMAC ist das gemeinsame Geheimnis, die Base32-Zeichenkette, die eine Authenticator-App beim Scannen des QR-Codes speichert. Das HMAC-Ergebnis wird nach dem Verfahren aus RFC 4226 auf sechs oder acht Ziffern gekürzt. Das ist der ganze Algorithmus, und jeder Teil davon steht im Browser zur Verfügung: SubtleCrypto signiert den HMAC, die Uhr der Seite liefert den Zähler, der Rest ist Rechnen.

Was das Tool zeigt

Den aktuellen Code, den nächsten und einen Countdown bis zum Periodenwechsel. Die Parameter werden aus der otpauth-URL gelesen, wenn du eine einfügst, und lassen sich sonst von Hand setzen: Algorithmus (SHA-1 als Standard; SHA-256 und SHA-512 bei manchen Anbietern), Stellen (sechs oder acht) und Periode. Label und Issuer aus der URL werden angezeigt, damit du siehst, zu welchem Konto das Geheimnis gehört.

Die Zeitabweichung ist das Einzige, was eine Seite nicht allein berechnen kann. Das Tool schickt eine einzige Anfrage an diese Website, die weder Geheimnis noch Code enthält, liest die Serverzeit aus der Antwort und zeigt die Differenz zu deiner Geräteuhr. Eine Abweichung von mehr als ein paar Sekunden erklärt die meisten Fälle, in denen ein richtiger Code abgelehnt wird: Server akzeptieren üblicherweise einen Zeitschritt nach vorn und hinten, und eine Uhr, die eine Minute falsch geht, erzeugt Codes, die immer für das falsche Fenster gelten.

Was die Seite nie verlässt

Geheimnis, otpauth-URL und die erzeugten Codes bleiben im Browser-Tab. Keine Anfrage transportiert sie, es gibt keine Erzeugung auf dem Server, und mit dem Schließen des Tabs sind sie weg. Das lässt sich im Netzwerk-Panel der Entwicklerwerkzeuge nachprüfen, und so sollte man eine solche Behauptung auch prüfen, statt sie zu glauben.

Gedacht ist das Tool zum Testen: für Entwickler, die gerade TOTP in einen Login eingebaut haben und sehen wollen, ob der Server Codes annimmt; für alle, die einen automatisierten Login einrichten und vorher bestätigen wollen, dass das Geheimnis im Tresor das richtige ist. Nicht gedacht ist es als Ersatz für die Authenticator-App. Ein Browser-Tab hat kein Backup, keine Gerätebindung und keine Sperre.

Wie der Tresor ein TOTP-Geheimnis benutzt

Zugangsdaten bei Browserberg können neben dem Passwort ein TOTP-Geheimnis tragen. Beim Login berechnet der Tresor den aktuellen Code und tippt ihn über einen Platzhalter ins Feld, genauso wie das Passwort. Der Agent, der den Login steuert, fordert den Code per Platzhalter an und sieht weder Geheimnis noch Code; im Kontext des Modells taucht beides nie auf. Die Freigabe ist an die Website gebunden, ein für ein Portal gespeichertes Geheimnis wird also nie auf einem anderen getippt, und ein in einem Lauf verbrauchter Code wird im nächsten nicht wiederverwendet.