GUID- en UUID-generator

UUID v4 is de algemene willekeurige keuze. Nadat de vereiste versie- en variantbits zijn gezet, blijven 122 bits willekeurig. Het is een goede standaard voor onafhankelijke clients, testgegevens, openbare resource-identifiers en systemen waarbij de identifier zelf geen tijd hoeft te onthullen.

UUID v7 plaatst een Unix-milliseconde-tijdstempel in de meest significante 48 bits en gebruikt in deze implementatie willekeurige bits voor de resterende variabele ruimte. Daardoor sorteren waarden uit verschillende milliseconden globaal op aanmaaktijd wanneer klokken vooruitlopen, wat kan helpen bij logreview en sommige indexpatronen.

Versie 7 is geen belofte van strikte generatievolgorde. Deze generator voegt geen monotone teller of submillisecondevolgorde toe. Waarden die in dezelfde milliseconde worden gemaakt bevatten willekeurige achterliggende bits, en een apparaatklok die terugloopt kan de zichtbare ordening verstoren.

De vertrouwde vorm met streepjes is een tekstpresentatie van 16 bytes. De vijf groepen hebben 8, 4, 4, 4 en 12 hexadecimale cijfers, maar de groepen zijn geen afzonderlijke willekeurige strings. De versienibble staat aan het begin van de derde groep en de RFC-variant staat in het eerste hexadecimale cijfer van de vierde groep.

Het vaste openbare v4-voorbeeld 550e8400-e29b-41d4-a716-446655440000 heeft 4 op de versiepositie en a op de RFC-variantpositie. Het variantcijfer kan 8, 9, a of b zijn voor de RFC-variant omdat de leidende bits 10 zijn. Deze posities verklaren hoe inspectie velden herkent; ze onthullen niet of de andere bits willekeurig zijn gegenereerd. Een handgeschreven waarde kan hetzelfde patroon imiteren.

De inspecteur herkent ook nil- en maxwaarden als speciale sentinels. Nil is alle bits nul; max is alle bits één. Ze kunnen structureel betekenisvol zijn in een protocol, maar zijn geen willekeurig gegenereerde identifiers en mogen niet voor gewone unieke waarden worden aangezien.

Voor UUID v7 neemt ClockTools één apparaatklok-milliseconde-tijdstempel voor de reeks en schrijft die in de eerste zes bytes van elke waarde. Elke waarde krijgt nog steeds verse willekeurige bytes voordat de versie- en variantbits worden vastgezet. Als de klokwaarde buiten het bereik van het 48-bit v7-tijdstempelveld valt, wordt die geweigerd en mislukt de generatie; de klokwaarde wordt niet tot 48 bits ingekort.

De unieke telling is lokaal voor de huidige gegenereerde reeks. De generator gebruikt een Set en begrensde pogingen zodat dubbele willekeurige uitvoer binnen de gevraagde reeks niet wordt teruggegeven. Hij raadpleegt geen wereldwijd register, database, andere tab of waarden die gisteren zijn gemaakt.

Waarschijnlijkheid is nog geen bedrijfsregel. Als dubbele sleutels gevolgen zouden hebben, dwing uniciteit dan af waar de identifiers worden opgeslagen en behandel conflictfouten daar. Generatie kan de staat van je applicatie niet kennen. Een mislukte nieuwe generatie wist de vorige reeks in plaats van een oud resultaat te laten lijken op een geslaagde nieuwe aanvraag, dus kopieer benodigde fixtures voordat je met de volgende reeks experimenteert.

Tekstformaat is nuttig wanneer de ontvanger een afgedrukte UUID verwacht. Kleine letters is de canonieke browseruitvoer die de generator gebruikt, hoofdletters is voor systemen met die conventie, accolades en aanhalingstekens zijn omsluitingen, zonder streepjes is de compacte 32-hex-vorm, en URN voegt de urn:uuid:-prefix toe.

Codering is een andere laag. Platte tekst behoudt het geselecteerde tekstformaat. URL-gecodeerde uitvoer percent-encodeert die tekst. Base64 en Base64 URL negeren de tekstformaatomsluiting en coderen de 16 ruwe bytes in netwerkvolgorde; de formaatsselector is uitgeschakeld voor die coderingen omdat accolades of hoofdletters geen deel zijn van de bytewaarde.

Indeling bepaalt hoe meerdere waarden worden geschikt. Eén per regel is het makkelijkst te scannen. CSV maakt één rij met kommagescheiden velden. JSON-array is nuttig voor fixtures en code. SQL-waarden maakt gequote waarden gescheiden door komma’s; het is een waardenlijst, geen volledige SQL-opdracht.

Voor de vaste UUID 550e8400-e29b-41d4-a716-446655440000 zijn de bytecoderingen VQ6EAOKbQdSnFkRmVUQAAA== in Base64 en VQ6EAOKbQdSnFkRmVUQAAA in Base64 URL. De gewone tekst heeft 36 tekens, compacte hex heeft 32, Base64 met padding heeft 24, en deze ongepadded Base64 URL-vorm heeft 22. Ze vertegenwoordigen dezelfde 16 bytes. De 36 afgedrukte ASCII-tekens coderen zou in plaats daarvan een andere invoer coderen en niet die byteresultaten geven.

RFC 4648 beschrijft de Base64- en URL-veilige alfabetten. De URL-veilige vorm vervangt de plus- en slashtekens die gewone Base64 gebruikt en laat in deze tool afsluitende padding weg. Hoofdlettergebruik blijft in beide Base64-alfabetten tellen; zet een Base64-waarde niet in kleine letters alsof het hexadecimale UUID-tekst is. URL-codering is een derde keuze: accolades worden %7B en %7D, terwijl canonieke UUID-letters, cijfers en streepjes geen percentvervanging nodig hebben.

Bytevolgorde is onderdeel van een uitwisselingscontract. Deze pagina codeert bytes in dezelfde netwerkvolgorde als de canonieke hexadecimale tekst. De Microsoft Guid.ToByteArray-documentatie laat zien dat de parameterloze byte-uitvoer de eerste drie veldgroepen omkeert ten opzichte van tekst. Als de ontvanger die representatie gebruikt, vergelijk dan expliciet de gedocumenteerde bytevolgorde; overeenkomen dat beide velden een GUID bevatten, bewijst niet dat hun Base64-strings overeenkomen.

Ook aanhalingstekens zijn gelaagd. Tekstformaat Aanhalingstekens voegt quote-tekens toe aan elke waarde; een JSON-indeling moet die tekens daarna escapen binnen zijn string, en CSV escapet ze binnen een veld. Extra ge-escapete quotes kunnen dus correcte serialisatie zijn maar toch verkeerd voor een ontvanger die een kale UUID wilde. Kleine letters plus Platte tekst is een rechttoe rechtaan startpunt voor JSON- en CSV-imports. SQL-waarden gebruikt enkel-gequote strings; lever de omringende querystructuur apart en geef de voorkeur aan geparametriseerde applicatiequeries boven gegenereerde strings in een live query plakken.

Een geldige structuur betekent dat de tekst in een ondersteunde UUID-vorm past en dat versie- en variantvelden kunnen worden gelezen. Zij bewijst niet dat de identifier door ClockTools, door Web Crypto, door een bepaalde service of op de gedecodeerde v7-tijd is gegenereerd.

Voor UUID v7 is de tijdstempel alleen nuttig bewijs binnen een groter onderzoek. Hij kan de apparaatklok van een generator weerspiegelen, een bewust aangepaste tijdstempel zijn of een gekopieerde testwaarde. Behandel hem als sorteeraanwijzing en vergelijk daarna serverlogs, databasetijdstempels en vertrouwde auditrecords.

De inspecteur accepteert compacte hex of tekst met streepjes, en kan gewone omsluitingen zoals accolades, haakjes, aanhalingstekens of een urn:uuid:-prefix verwijderen vóór controle. Hij decodeert geen Base64, Base64 URL of URL-gecodeerde invoer voor validatie; decodeer die representaties in het ontvangende systeem vóór structurele inspectie.

Inspectie accepteert één identifier tegelijk, geen geëxporteerde CSV-rij of JSON-array. Gegenereerde waarde gebruiken plakt de eerste oorspronkelijke UUID uit de huidige reeks, niet zijn gecodeerde weergave, zodat je een reeks kunt inspecteren terwijl Base64 is geselecteerd. De inspecteur herkent ondersteunde RFC-versies 1 tot en met 8, maar generatie biedt alleen v4 en v7. Een waarschuwing voor niet-ondersteunde variant kan nog steeds een genormaliseerde vorm tonen; het is geen geslaagde RFC-validatie of toestemming om velden van het bronprotocol te herschrijven.

Een aantalfout betekent dat het aantal geen geheel getal van 1 tot en met 1.000 is. De tool rondt niet af, begrenst niet en verlaagt de aanvraag niet stilzwijgend. Een fout in de toevalsbron betekent dat Web Crypto geen bruikbare willekeurige bytes leverde, dus er zijn geen identifiers gegenereerd.

Een coderingsfout kan optreden wanneer een browser de API mist die nodig is voor de gekozen uitvoercodering. Schakel over naar Platte tekst om de onderliggende reeks terug te halen of probeer een andere browser. Een generatiefout is anders: die verwerpt de reeks in plaats van gedeeltelijke waarden te bewaren. Klembord-, deel- en downloadfouten genereren identifiers niet opnieuw. Wanneer exporttoegang faalt, selecteer de zichtbare uitvoer handmatig als die beschikbaar is; controleer downloads voordat je aanneemt dat een gestart bestand is opgeslagen.

Plak geen productiegeheimen in een UUID-rapport. Een UUID kan openbaar, privé of beveiligingsgevoelig zijn afhankelijk van hoe je systeem die gebruikt, maar de vorm alleen maakt er geen wachtwoord van. Gebruik voor bearer tokens, wachtwoordresets of API-credentials een daarvoor ontworpen geheimgenerator en lifecyclecontroles.