Generatore di GUID e UUID

UUID v4 è la scelta casuale di uso generale. Dopo l’impostazione dei bit obbligatori di versione e variante, restano 122 bit casuali. È una buona impostazione predefinita per client indipendenti, dati di prova, identificatori pubblici di risorse e sistemi che non hanno bisogno che l’identificatore stesso riveli un’ora.

UUID v7 inserisce un timestamp Unix in millisecondi nei 48 bit più significativi, poi in questa implementazione usa bit casuali per lo spazio variabile restante. Questo fa sì che valori di millisecondi diversi si ordinino in modo ampio per ora di creazione quando gli orologi avanzano, cosa utile per revisione dei log e alcuni schemi di indice.

La versione 7 non è una promessa di ordine di generazione rigoroso. Questo generatore non aggiunge un contatore monotono né una sequenza sotto il millisecondo. I valori creati nello stesso millisecondo contengono bit finali casuali, e un orologio del dispositivo che torna indietro può disturbare l’ordinamento visibile.

La forma familiare con trattini è una presentazione testuale di 16 byte. I cinque gruppi hanno 8, 4, 4, 4 e 12 cifre esadecimali, ma i gruppi non sono stringhe casuali separate. Il nibble di versione appare all’inizio del terzo gruppo e la variante RFC appare nella prima cifra esadecimale del quarto gruppo.

L’esempio v4 pubblico fisso 550e8400-e29b-41d4-a716-446655440000 ha 4 nella posizione della versione e a nella posizione della variante RFC. La cifra di variante può essere 8, 9, a o b per la variante RFC perché i bit iniziali sono 10. Queste posizioni spiegano come l’analisi riconosce i campi; non rivelano se gli altri bit siano stati generati casualmente. Un valore scritto a mano può imitare lo stesso schema.

L’analizzatore riconosce anche valori nullo e massimo come sentinelle speciali. Il nullo è composto da tutti bit zero; il massimo da tutti bit uno. Possono avere significato strutturale in un protocollo, ma non sono identificatori generati casualmente e non vanno confusi con normali valori unici.

Per UUID v7, ClockTools prende un timestamp in millisecondi dall’orologio del dispositivo per il lotto e lo scrive nei primi sei byte di ogni valore. Ogni valore riceve comunque byte casuali freschi prima che i bit di versione e variante vengano fissati. Se il valore dell’orologio è fuori dall’intervallo del campo timestamp v7 a 48 bit, viene rifiutato e la generazione fallisce, senza troncare il timestamp.

Il conteggio univoco è locale al lotto generato corrente. Il generatore usa un Set e tentativi limitati affinché output casuali duplicati nel lotto richiesto non vengano restituiti. Non consulta un registro globale, un database, un’altra scheda o valori prodotti ieri.

La probabilità non è la stessa cosa di una regola di business. Se chiavi duplicate avrebbero conseguenze, imponi l’unicità dove gli identificatori vengono salvati e gestisci lì gli errori di conflitto. La generazione non può conoscere lo stato della tua applicazione. Una nuova generazione fallita cancella il lotto precedente invece di lasciare un vecchio risultato con l’aspetto di una nuova richiesta riuscita, quindi copia le fixture necessarie prima di sperimentare con il lotto successivo.

Il formato del testo è utile quando il ricevente si aspetta un UUID stampato. Minuscole è l’output canonico del browser usato dal generatore, maiuscole serve per sistemi con quella convenzione, parentesi graffe e virgolette sono involucri, senza trattini è la forma compatta a 32 esadecimali e URN aggiunge il prefisso urn:uuid:.

La codifica è un livello diverso. Testo semplice conserva esattamente il formato del testo selezionato. L’output con codifica URL codifica percentualmente quel testo. Base64 e Base64 URL ignorano l’involucro del formato del testo e codificano i 16 byte grezzi in ordine di rete; il selettore di formato è disabilitato per quelle codifiche perché parentesi graffe o lettere maiuscole non fanno parte del valore byte.

Il formato di uscita decide come vengono disposti più valori. Uno per riga è il più facile da scorrere. CSV crea una riga di campi separati da virgole. Array JSON è utile per fixture e codice. Valori SQL crea valori tra apici separati da virgole; è una lista di valori, non un’istruzione SQL completa.

Per l’UUID fisso 550e8400-e29b-41d4-a716-446655440000, le codifiche byte sono VQ6EAOKbQdSnFkRmVUQAAA== in Base64 e VQ6EAOKbQdSnFkRmVUQAAA in Base64 URL. Il testo ordinario ha 36 caratteri, l’esadecimale compatto ne ha 32, il Base64 con padding ne ha 24 e questa forma Base64 URL senza padding ne ha 22. Rappresentano gli stessi 16 byte. Codificare invece i 36 caratteri ASCII stampati codificherebbe un input diverso e non darebbe quei risultati byte.

RFC 4648 descrive gli alfabeti Base64 e sicuro per URL. La forma sicura per URL sostituisce i caratteri più e barra usati dal Base64 ordinario e, in questo strumento, omette il padding finale. Le maiuscole e minuscole contano comunque in entrambi gli alfabeti Base64; non trasformare in minuscolo un valore Base64 come se fosse testo UUID esadecimale. La codifica URL è una terza scelta: le parentesi graffe diventano %7B e %7D, mentre lettere, cifre e trattini dell’UUID canonico non richiedono sostituzioni percentuali.

L’ordine dei byte fa parte di un contratto di scambio. Questa pagina codifica i byte nello stesso ordine di rete del testo esadecimale canonico. La documentazione Microsoft di Guid.ToByteArray mostra che il suo output byte senza parametri inverte i primi tre gruppi di campi rispetto al testo. Se il ricevente usa quella rappresentazione, confronta esplicitamente l’ordine dei byte documentato; concordare che entrambi i campi contengono un GUID non stabilisce che le loro stringhe Base64 coincideranno.

Anche le virgolette sono stratificate. Il formato del testo Tra virgolette aggiunge caratteri di virgolette a ogni valore; un formato JSON poi applica l’escape a quei caratteri dentro la sua stringa, e CSV li sottopone a escape dentro un campo. Virgolette con escape aggiuntivo possono quindi essere serializzazione corretta ma comunque sbagliate per un ricevente che voleva un UUID nudo. Minuscole più Testo semplice è un punto di partenza diretto per importazioni JSON e CSV. Valori SQL usa stringhe tra apici singoli; fornisci separatamente la struttura della query circostante e preferisci query applicative parametrizzate invece di incollare stringhe generate in una query live.

Una struttura valida significa che il testo rispetta una forma UUID supportata e che i suoi campi versione e variante possono essere letti. Non prova che l’identificatore sia stato generato da ClockTools, da Web Crypto, da un servizio particolare o all’ora v7 decodificata.

Per UUID v7, il timestamp è una prova utile solo dentro un’indagine più ampia. Può riflettere l’orologio del dispositivo usato da un generatore, un timestamp alterato deliberatamente o un valore di prova copiato. Trattalo come indizio di ordinamento, poi confrontalo con log del server, timestamp del database e registri di audit affidabili.

L’analizzatore accetta esadecimale compatto o testo con trattini, e può rimuovere involucri comuni come parentesi graffe, parentesi tonde, virgolette o un prefisso urn:uuid: prima del controllo. Non decodifica input Base64, Base64 URL o con codifica URL per la convalida; decodifica quelle rappresentazioni nel sistema ricevente prima dell’ispezione strutturale.

L’analisi accetta un identificatore alla volta, non una riga CSV esportata o un array JSON. Usa un valore generato incolla il primo UUID originale del lotto corrente, non la sua visualizzazione codificata, così puoi analizzare un lotto anche mentre Base64 è selezionato. L’analizzatore riconosce le versioni RFC supportate da 1 a 8, ma la generazione offre solo v4 e v7. Un avviso di variante non supportata può comunque mostrare una forma normalizzata; non è una convalida RFC riuscita né un permesso di riscrivere i campi del protocollo di origine.

Un errore di quantità significa che il conteggio non è un numero intero da 1 a 1.000. Lo strumento non arrotonda, limita o riduce silenziosamente la richiesta. Un errore della sorgente casuale significa che Web Crypto non ha fornito byte casuali utilizzabili, quindi non sono stati generati identificatori.

Un errore di codifica può verificarsi quando un browser non ha l’API necessaria per la codifica di output scelta. Passa a Testo semplice per recuperare il lotto sottostante oppure prova un altro browser. Un fallimento di generazione è diverso: scarta il lotto invece di conservare valori parziali. Errori di appunti, condivisione e download non rigenerano gli identificatori. Quando l’accesso all’esportazione fallisce, seleziona manualmente l’output visibile se è disponibile; controlla i download prima di presumere che un file avviato sia stato salvato.

Non incollare segreti di produzione in una segnalazione UUID. Un UUID può essere pubblico, privato o sensibile alla sicurezza a seconda di come il tuo sistema lo usa, ma la sola forma non lo rende una password. Per bearer token, reset password o credenziali API, usa un generatore di segreti e controlli di ciclo di vita progettati per quello scopo.