GUID- und UUID-Generator

UUID v4 ist die allgemeine Zufallswahl. Nach dem Setzen der erforderlichen Versions- und Variantenbits bleiben 122 Bits zufällig. Sie ist eine gute Voreinstellung für unabhängige Clients, Testdaten, öffentliche Ressourcenkennungen und Systeme, bei denen die Kennung selbst keine Zeit offenlegen soll.

UUID v7 setzt einen Unix-Millisekunden-Zeitstempel in die höchstwertigen 48 Bits und verwendet in dieser Implementierung Zufallsbits für den verbleibenden variablen Raum. Dadurch sortieren sich Werte aus unterschiedlichen Millisekunden grob nach Erzeugungszeit, wenn Uhren vorwärts laufen; das kann Logprüfung und einige Indexmuster unterstützen.

Version 7 ist kein Versprechen strenger Erzeugungsreihenfolge. Dieser Generator fügt keinen monotonen Zähler und keine Sub-Millisekunden-Sequenz hinzu. Werte, die in derselben Millisekunde erstellt werden, enthalten zufällige nachfolgende Bits, und eine rückwärts laufende Geräteuhr kann die sichtbare Ordnung stören.

Die vertraute Form mit Bindestrichen ist eine Textdarstellung von 16 Bytes. Die fünf Gruppen haben 8, 4, 4, 4 und 12 Hexadezimalziffern, aber die Gruppen sind keine getrennten Zufallszeichenfolgen. Das Versions-Nibble steht am Anfang der dritten Gruppe, und die RFC-Variante steht in der ersten Hexziffer der vierten Gruppe.

Das feste öffentliche v4-Beispiel 550e8400-e29b-41d4-a716-446655440000 hat 4 an der Versionsposition und a an der RFC-Variantenposition. Die Varianten-Ziffer kann für die RFC-Variante 8, 9, a oder b sein, weil die führenden Bits 10 sind. Diese Positionen erklären, wie die Prüfung Felder erkennt; sie verraten nicht, ob die anderen Bits zufällig erzeugt wurden. Ein handgeschriebener Wert kann dasselbe Muster nachahmen.

Die Prüfung erkennt außerdem Nil- und Max-Werte als besondere Sentinels. Nil besteht vollständig aus Nullbits; Max vollständig aus Einsbits. Sie können in einem Protokoll strukturell bedeutsam sein, sind aber keine zufällig erzeugten Kennungen und sollten nicht mit gewöhnlichen eindeutigen Werten verwechselt werden.

Für UUID v7 nimmt ClockTools einen Geräteuhr-Millisekundenzeitstempel für den Satz und schreibt ihn in die ersten sechs Bytes jedes Werts. Jeder Wert erhält weiterhin frische Zufallsbytes, bevor Versions- und Variantenbits gesetzt werden. Wenn der Uhrwert nicht in das 48-Bit-Zeitstempelfeld von v7 passt, wird er abgelehnt und die Erzeugung schlägt fehl; der Zeitstempel wird nicht auf 48 Bit gekürzt.

Die Eindeutigkeitszahl ist lokal für den aktuell erzeugten Satz. Der Generator verwendet ein Set und begrenzte Wiederholungsversuche, damit doppelte Zufallsausgaben innerhalb des angeforderten Satzes nicht zurückgegeben werden. Er fragt kein globales Register, keine Datenbank, keinen anderen Tab und keine gestern erzeugten Werte ab.

Wahrscheinlichkeit ist trotzdem nicht dasselbe wie eine Geschäftsregel. Wenn doppelte Schlüssel Folgen hätten, erzwinge Eindeutigkeit dort, wo die Kennungen gespeichert werden, und behandle Konfliktfehler dort. Die Erzeugung kann den Zustand deiner Anwendung nicht kennen. Eine fehlgeschlagene neue Erzeugung löscht den vorherigen Satz, statt ein altes Ergebnis wie eine erfolgreiche neue Anfrage aussehen zu lassen; kopiere benötigte Fixtures also, bevor du mit dem nächsten Satz experimentierst.

Das Textformat ist nützlich, wenn der Empfänger eine gedruckte UUID erwartet. Kleinbuchstaben ist die kanonische Browserausgabe des Generators, Großbuchstaben ist für Systeme mit dieser Konvention, geschweifte Klammern und Anführungszeichen sind Hüllen, ohne Bindestriche ist die kompakte Form aus 32 Hexziffern, und URN fügt das Präfix urn:uuid: hinzu.

Kodierung ist eine andere Ebene. Klartext bewahrt das gewählte Textformat. URL-kodierte Ausgabe percent-kodiert diesen Text. Base64 und Base64 URL ignorieren die Textformat-Hülle und kodieren die 16 Rohbytes in Netzwerkreihenfolge; der Formatwähler ist für diese Kodierungen deaktiviert, weil Klammern oder Großbuchstaben nicht Teil des Bytewerts sind.

Das Ausgabeformat entscheidet, wie mehrere Werte angeordnet werden. Eine pro Zeile lässt sich am einfachsten prüfen. CSV erzeugt eine Zeile mit kommagetrennten Feldern. JSON-Array ist nützlich für Fixtures und Code. SQL-Werte erzeugt Werte in einfachen Anführungszeichen, getrennt durch Kommas; es ist eine Werteliste, keine vollständige SQL-Anweisung.

Für die feste UUID 550e8400-e29b-41d4-a716-446655440000 lauten die Bytekodierungen VQ6EAOKbQdSnFkRmVUQAAA== in Base64 und VQ6EAOKbQdSnFkRmVUQAAA in Base64 URL. Der gewöhnliche Text hat 36 Zeichen, kompaktes Hex hat 32, Base64 mit Padding hat 24 und diese Base64-URL-Form ohne Padding hat 22; die beiden abschließenden = des Base64-Beispiels sind Padding-Zeichen. Sie repräsentieren dieselben 16 Bytes. Stattdessen die 36 gedruckten ASCII-Zeichen zu kodieren, würde eine andere Eingabe kodieren und nicht diese Byteergebnisse liefern.

RFC 4648 beschreibt die Base64- und URL-sicheren Alphabete. Die URL-sichere Form ersetzt Plus- und Schrägstrichzeichen des gewöhnlichen Base64 und lässt in diesem Werkzeug nachgestelltes Padding weg. Groß-/Kleinschreibung zählt auch in beiden Base64-Alphabeten; schreibe einen Base64-Wert nicht klein, als wäre er hexadezimaler UUID-Text. URL-kodiert ist eine dritte Wahl: Klammern werden zu %7B und %7D, während kanonische UUID-Buchstaben, Ziffern und Bindestriche keine Percent-Ersetzung brauchen.

Byte-Reihenfolge gehört zu einem Austauschvertrag. Diese Seite kodiert Bytes in derselben Netzwerkreihenfolge wie der kanonische Hexadezimaltext. Microsofts Guid.ToByteArray-Dokumentation zeigt, dass ihre parameterlose Byteausgabe die ersten drei Feldgruppen relativ zum Text umkehrt. Wenn der Empfänger diese Darstellung verwendet, vergleiche die dokumentierte Byte-Reihenfolge ausdrücklich; die Einigkeit, dass beide Felder eine GUID enthalten, beweist nicht, dass ihre Base64-Zeichenfolgen übereinstimmen.

Auch Anführungszeichen können auf mehreren Ebenen hinzukommen. Das Textformat Anführungszeichen fügt jedem Wert Anführungszeichen hinzu; ein JSON-Ausgabeformat muss diese Zeichen dann in seiner Zeichenkette maskieren, und CSV maskiert sie innerhalb eines Feldes. Zusätzliche maskierte Anführungszeichen können daher korrekte Serialisierung sein, aber trotzdem für einen Empfänger falsch, der eine nackte UUID wollte. Kleinbuchstaben plus Klartext ist ein einfacher Startpunkt für JSON- und CSV-Importe. SQL-Werte verwendet einfache Anführungszeichen; liefere die umgebende Abfragestruktur separat und bevorzuge parametrisierte Anwendungsabfragen, statt erzeugte Zeichenfolgen in eine Live-Abfrage einzufügen.

Eine gültige Struktur bedeutet, dass der Text in eine unterstützte UUID-Form passt und seine Versions- und Variantenfelder gelesen werden können. Sie beweist nicht, dass die Kennung von ClockTools, von Web Crypto, von einem bestimmten Dienst oder zur dekodierten v7-Zeit erzeugt wurde.

Bei UUID v7 ist der Zeitstempel nur innerhalb einer größeren Untersuchung ein nützlicher Beleg. Er kann die Geräteuhr eines Generators widerspiegeln, einen absichtlich veränderten Zeitstempel oder einen kopierten Testwert. Behandle ihn als Sortierhinweis und vergleiche dann Serverlogs, Datenbankzeitstempel und vertrauenswürdige Auditaufzeichnungen.

Die Prüfung akzeptiert kompaktes Hex oder Text mit Bindestrichen und kann gewöhnliche Hüllen wie geschweifte Klammern, Klammern, Anführungszeichen oder ein urn:uuid:-Präfix vor der Prüfung entfernen. Sie dekodiert Base64, Base64 URL oder URL-kodierte Eingaben nicht für die Validierung; dekodiere diese Darstellungen im empfangenden System vor der Strukturprüfung.

Die Prüfung akzeptiert jeweils eine Kennung, keine exportierte CSV-Zeile und kein JSON-Array. Erzeugten Wert verwenden fügt die erste ursprüngliche UUID aus dem aktuellen Satz ein, nicht ihre kodierte Anzeige, sodass du einen Satz auch prüfen kannst, während Base64 ausgewählt ist. Die Prüfung erkennt unterstützte RFC-Versionen 1 bis 8, aber die Erzeugung bietet nur v4 und v7. Eine Warnung zu nicht unterstützter Variante kann trotzdem eine normalisierte Form anzeigen; sie ist keine erfolgreiche RFC-Validierung und keine Erlaubnis, Felder des Quellprotokolls umzuschreiben.

Ein Anzahlfehler bedeutet, dass die Anzahl keine ganze Zahl von 1 bis 1.000 ist. Das Werkzeug rundet, begrenzt oder reduziert die Anfrage nicht still. Ein Zufallsquellenfehler bedeutet, dass Web Crypto keine verwendbaren Zufallsbytes geliefert hat, also wurden keine Kennungen erzeugt.

Ein Kodierungsfehler kann auftreten, wenn einem Browser die API fehlt, die für die gewählte Ausgabekodierung nötig ist. Wechsle zu Klartext, um den zugrunde liegenden Satz wieder sichtbar zu machen, oder versuche einen anderen Browser. Ein Erzeugungsfehler ist anders: Er verwirft den Satz, statt Teilwerte zu behalten. Zwischenablage-, Teilen- und Downloadfehler erzeugen keine Kennungen neu. Wenn Exportzugriff scheitert, markiere die sichtbare Ausgabe manuell, falls sie verfügbar ist; prüfe Downloads, bevor du annimmst, dass eine gestartete Datei gespeichert wurde.

Füge keine Produktionsgeheimnisse in einen UUID-Bericht ein. Eine UUID kann öffentlich, privat oder sicherheitssensibel sein, je nachdem, wie dein System sie verwendet, aber die Form allein macht sie nicht zu einem Passwort. Für Bearer-Token, Passwortzurücksetzungen oder API-Zugangsdaten nutze einen dafür ausgelegten Geheimnisgenerator und Lebenszykluskontrollen.