Generatore di codici di recupero 2FA con seme

Indicando una quantità e un seme segreto, gli stessi dati producono sempre il medesimo elenco ordinato. Tale riproducibilità è utile per il provisioning controllato, i dati di test, le procedure documentate di recupero e i sistemi che devono ricostruire i codici senza archiviare l’elenco generato. L’elaborazione è esclusivamente locale: non usa rete, orologio, fonti casuali, dati dell’account o stato nascosto. Il seme e ogni codice prodotto devono essere protetti come materiale di autenticazione riservato.

Scelga la quantità e protegga il seme

Inizi stabilendo quanti codici di recupero deve emettere l’account o l’applicazione. La quantità deve essere un intero compreso tra uno e mille; una richiesta inferiore a uno viene rifiutata anziché produrre silenziosamente un insieme vuoto. Fornisca quindi un seme non vuoto. Il seme è l’unica fonte della riproducibilità, perciò valori identici di seme e quantità generano codici identici nello stesso ordine. Utilizzi un segreto lungo e ad alta entropia, creato e conservato secondo la procedura di gestione dei segreti approvata dalla Sua organizzazione. Il nome di una persona, un indirizzo e-mail, l’etichetta di un progetto o una breve frase facile da ricordare non sono semi adatti alla produzione, poiché un’altra persona potrebbe indovinarli e ricostruire i codici. Non riutilizzi lo stesso seme per utenti, ambienti o servizi diversi. La separazione dei domini interna all’algoritmo evita sovrapposizioni accidentali con altre derivazioni, ma non può compensare un seme debole o esposto. Se occorrono dati riproducibili per test automatizzati, identifichi e isoli chiaramente i semi di test affinché i relativi risultati non vengano mai accettati da un sistema di autenticazione di produzione. Il seme è limitato a 4,096 caratteri per mantenere l’esecuzione circoscritta e prevedibile.

Comprenda il processo di generazione deterministico

Ogni posizione dell’output viene derivata separatamente con SHA-256 usando un’etichetta con versione, la lunghezza esatta del seme, il testo del seme, la posizione a partire da zero e un contatore dei tentativi. La lunghezza del seme rende inequivocabile la delimitazione dell’input, mentre l’etichetta con versione separa questo scopo da altri calcoli basati su semi. Il generatore legge valori senza segno dal digest e applica il campionamento per rifiuto prima di ridurli a otto cifre decimali. Questo passaggio elimina il piccolo errore di distribuzione che una conversione diretta tramite modulo introdurrebbe. Ogni numero accettato viene formattato in due gruppi di quattro cifre separati da un trattino, mantenendo gli zeri iniziali. Un insieme registra i valori già emessi; in caso di collisione, il contatore avanza in modo deterministico finché non trova un nuovo codice. Il risultato contiene quindi il numero richiesto di codici univoci, e una nuova esecuzione riproduce sia le decisioni sulle collisioni sia l’elenco finale. Nessun servizio di rete, orologio di sistema, generatore casuale dell’ambiente, cache persistente o stato mutabile del modulo può influire sulla risposta. La modifica anche di un solo carattere del seme normalmente cambia l’intero elenco.

Distribuisca, conservi e invalidi i codici in sicurezza

La generazione è solo una parte di una procedura per i codici di recupero. Il Suo servizio di autenticazione deve conservare un verificatore approvato per ogni codice, contrassegnare un codice come consumato dopo il primo utilizzo riuscito, limitare la frequenza dei tentativi e offrire un’azione esplicita di revoca o rigenerazione. Non registri mai il seme o i codici in chiaro in strumenti di analisi, tracce, richieste di assistenza, output di compilazione o conversazioni condivise. Consegni i codici all’utente autenticato tramite una sessione protetta e consigli l’archiviazione offline in un gestore di password o in un altro luogo sicuro. Il determinismo semplifica il ripristino di emergenza e il provisioning controllato, ma consente anche a chiunque ottenga il seme di ricostruire tutti i codici. Passi a un seme nuovo e indipendente quando si sospetta un’esposizione, quando l’utente richiede la rigenerazione o quando una regola impone di invalidare il vecchio insieme. Non richieda semplicemente una quantità diversa con il vecchio seme: le posizioni comuni alle due richieste rimarranno uguali. Le cifre raggruppate facilitano la trascrizione, ma ogni codice offre solo cento milioni di valori possibili; le difese online restano quindi essenziali. L’API costa $0.002 per richiesta e il browser usa lo stesso calcolo puro.