2FA-Backupcodes mit Seed generieren

Geben Sie eine Anzahl und einen geheimen Seed ein, dann ergeben dieselben Eingaben stets dieselbe geordnete Liste. Diese Reproduzierbarkeit eignet sich für kontrollierte Bereitstellungen, Testdaten, dokumentierte Wiederherstellungsabläufe und Systeme, die Codes rekonstruieren müssen, ohne die erzeugte Liste zu speichern. Die Berechnung erfolgt ausschließlich lokal: Netzwerk, Uhrzeit, Zufallsquelle, Kontodaten und verborgener Zustand werden nicht verwendet. Behandeln Sie den Seed und jeden erzeugten Code als vertrauliches Authentifizierungsmaterial.

Anzahl wählen und Seed schützen

Legen Sie zunächst fest, wie viele Wiederherstellungscodes das Konto oder die Anwendung ausgeben soll. Die Anzahl muss eine ganze Zahl zwischen eins und eintausend sein; eine Anfrage mit einem Wert unter eins wird abgewiesen, statt unbemerkt eine leere Liste zu erzeugen. Geben Sie anschließend einen nicht leeren Seed an. Der Seed ist die vollständige Grundlage der Reproduzierbarkeit. Identische Werte für Seed und Anzahl liefern daher identische Codes in derselben Reihenfolge. Verwenden Sie ein langes Geheimnis mit hoher Entropie, das nach dem von Ihrer Organisation genehmigten Verfahren zur Geheimnisverwaltung erzeugt und gespeichert wurde. Personennamen, E-Mail-Adressen, Projektbezeichnungen und kurze, leicht merkbare Sätze sind für den Produktivbetrieb ungeeignet, weil andere sie erraten und die Codes rekonstruieren könnten. Verwenden Sie denselben Seed nicht für verschiedene Benutzer, Umgebungen oder Dienste. Die interne Domänentrennung des Algorithmus verhindert versehentliche Überschneidungen mit anderen Ableitungen, gleicht aber keinen schwachen oder offengelegten Seed aus. Kennzeichnen und isolieren Sie Test-Seeds für reproduzierbare automatisierte Tests eindeutig, damit deren Ergebnisse niemals von einem produktiven Authentifizierungssystem akzeptiert werden. Die Länge ist auf 4,096 Zeichen begrenzt, damit die Ausführung beschränkt und vorhersehbar bleibt.

Deterministische Erzeugung verstehen

Jede Ausgabeposition wird mit SHA-256 getrennt aus einer versionierten Kennzeichnung, der exakten Seed-Länge, dem Seed-Text, der bei null beginnenden Position und einem Wiederholungszähler abgeleitet. Die Angabe der Länge macht die Gliederung der Eingabe eindeutig, während die versionierte Kennzeichnung diesen Zweck von anderen Seed-basierten Berechnungen trennt. Der Generator liest vorzeichenlose Werte aus dem Hash und wendet Rejection Sampling an, bevor er sie auf acht Dezimalziffern reduziert. Dadurch wird die geringe Verteilungsverzerrung vermieden, die bei einer direkten Modulo-Umrechnung entstünde. Jede akzeptierte Zahl wird als zwei durch einen Bindestrich getrennte Vierergruppen formatiert; führende Nullen bleiben erhalten. Eine Menge hält bereits ausgegebene Werte fest. Bei einer Kollision wird der Zähler deterministisch erhöht, bis ein neuer Code gefunden ist. Das Ergebnis enthält somit die angeforderte Anzahl eindeutiger Codes, und eine erneute Ausführung reproduziert sowohl die Kollisionsentscheidungen als auch die endgültige Liste. Weder Netzwerkdienste noch Systemzeit, Laufzeit-Zufallsgenerator, persistenter Cache oder veränderlicher Modulzustand können die Antwort beeinflussen. Schon die Änderung eines einzigen Zeichens im Seed verändert normalerweise die gesamte Liste.

Codes sicher einsetzen, speichern und ungültig machen

Die Erzeugung ist nur ein Bestandteil eines Backupcode-Verfahrens. Ihr Authentifizierungsdienst muss für jeden Code einen zugelassenen Prüfwert speichern, einen Code nach der ersten erfolgreichen Nutzung als verbraucht markieren, Versuche begrenzen und eine ausdrückliche Funktion zum Widerrufen oder Neuerzeugen anbieten. Schreiben Sie Seed oder Klartextcodes niemals in Analysedaten, Ablaufprotokolle, Supportanfragen, Build-Ausgaben oder gemeinsame Chats. Übermitteln Sie die Codes dem authentifizierten Benutzer in einer geschützten Sitzung und empfehlen Sie eine Offline-Aufbewahrung in einem Passwortmanager oder an einem anderen sicheren Ort. Determinismus erleichtert Notfallwiederherstellung und kontrollierte Bereitstellung, bedeutet jedoch auch, dass jede Person mit Zugriff auf den Seed sämtliche Codes rekonstruieren kann. Wechseln Sie bei vermuteter Offenlegung, auf Wunsch des Benutzers oder bei einer vorgeschriebenen Ungültigmachung der alten Liste zu einem neuen, unabhängigen Seed. Fordern Sie nicht lediglich eine andere Anzahl mit dem bisherigen Seed an: Die gemeinsamen Positionen beider Anfragen bleiben gleich. Gruppierte Ziffern vereinfachen die Übertragung, doch pro Code gibt es nur einhundert Millionen mögliche Werte. Schutzmaßnahmen für Online-Versuche bleiben deshalb unverzichtbar. Die API kostet $0.002 je Anfrage; im Browser läuft dieselbe reine Berechnung.