JPKCom DB

UUID-Generator — Manual

Vollständige Funktionsbeschreibung: UUID v4, v7, v1 und v5, Namespaces, Massen-Erzeugung 1–1000, NIL-UUID, Ausgabeformat und die Zufallsquelle im Browser.

Zurück zur Übersicht: UUID-Generator · Tool live öffnen: www.jpkc.com/tools/uuid/

Dieses Manual beschreibt den UUID-Generator vollständig: wie die Oberfläche aufgebaut ist, was jede der vier Versionen erzeugt, wie Namespaces, Massen-Erzeugung und die NIL-UUID funktionieren und woher die Zufallswerte kommen. Die Oberfläche des Tools ist auf Englisch — die Labels werden hier in ihrer englischen Original-Schreibweise genannt (mit deutscher Erläuterung), damit du dich im echten Interface zurechtfindest.

Aufbau der Oberfläche

Die Bedienung läuft über vier Tabs am oberen Rand der Karte, je einer pro UUID-Version:

  • v4 Random (aktiv beim Laden)
  • v7 Time-ordered
  • v1 Time-based
  • v5 Name-based

Jeder Tab hat einen kurzen Erklär-Hinweis, die nötigen Eingabefelder, einen Generate-Knopf und ein Ergebnisfeld mit Kopier-Knopf (Klemmbrett-Symbol). Das Ergebnisfeld ist editierbar (contenteditable) — du kannst die Anzeige also auch von Hand bearbeiten, bevor du kopierst. Ganz unten, im Fuß der Karte, steht dauerhaft die NIL-UUID mit eigenem Kopier-Knopf.

Beim Laden prüft das Tool, ob die UUID-Bibliothek bereit ist; erst dann werden die Generate-Knöpfe aktiv. Auf einer frisch geladenen Seite steht im Ergebnisfeld der Platzhalter Click "Generate" to create UUIDs….

Gemeinsamer Ablauf

Für jede Version gilt derselbe Grundablauf:

  1. Tab wählen (Version).
  2. Bei v4/v7/v1: Number of UUIDs einstellen (Anzahl). Bei v5: Namespace und Name angeben.
  3. Generate klicken.
  4. Ergebnis aus dem Feld kopieren — entweder über den Kopier-Knopf oder von Hand.

Die UUID-Versionen im Detail

Version 4: Zufall (v4 Random)

Erzeugt rein zufällige UUIDs (RFC 9562, Version 4). Der Hinweis im Tab lautet „Best for most use cases" — für die meisten Anwendungsfälle ist v4 die richtige Wahl. Es steckt keinerlei Zeit- oder Geräte-Information in der UUID; bis auf die festen Versions- und Variant-Bits sind alle Bits zufällig.

Die Zufallswerte kommen aus dem kryptografisch sicheren Generator des Browsers: Sofern verfügbar, nutzt das Tool die native Funktion crypto.randomUUID(), sonst füllt es 16 Byte über crypto.getRandomValues und setzt die Versions-/Variant-Bits selbst. In beiden Fällen ist die Quelle ein CSPRNG, nicht Math.random.

Version 7: zeitsortiert (v7 Time-ordered)

Erzeugt zeitsortierte UUIDs (RFC 9562, Version 7). Die ersten 48 Bit sind ein Unix-Zeitstempel in Millisekunden (Big-Endian), der Rest ist Zufall (CSPRNG). Dadurch sind v7-UUIDs grob nach Erzeugungszeit sortierbar — im Tab als „Sortable by creation time, modern alternative to v1" beschrieben. Das macht sie angenehm als Datenbank-Schlüssel: Neue Einträge landen am Index-Ende, statt ihn wie zufällige v4-Werte zu zerstreuen.

Version 1: zeitbasiert (v1 Time-based)

Erzeugt zeitbasierte UUIDs (im Tab als „RFC 4122 Version 1" bezeichnet). Sie enthalten einen Gregorianischen Zeitstempel und eine Clock-Sequence. Wichtig: Der Node-Teil ist zufällig erzeugt (mit gesetztem Multicast-Bit), das Tool liest keine MAC-Adresse aus — es wird also keine Hardware-Kennung preisgegeben. Die Clock-Sequence ist ebenfalls zufällig initialisiert.

Eine technische Grenze: v1 kann pro Sekunde nicht beliebig viele eindeutige Werte liefern. Überschreitet ein Lauf intern die Auflösung (mehr als rund 10 Millionen UUIDs pro Sekunde), bricht die Erzeugung mit einer Fehlermeldung ab. Bei den hier wählbaren Mengen (bis 1000) ist das praktisch nie ein Thema.

Version 5: namensbasiert (v5 Name-based)

Erzeugt namensbasierte, deterministische UUIDs (RFC 9562, Version 5). Der entscheidende Unterschied zu den anderen Versionen: Derselbe Namespace und derselbe Name ergeben immer dieselbe UUID (Tab-Hinweis: „Same namespace + name always produces the same UUID"). v5 erzeugt also keinen Zufall, sondern eine reproduzierbare Ableitung.

Technisch hängt das Tool den 16-Byte-Namespace und den als UTF-8 kodierten Namen aneinander, bildet darüber einen SHA-1-Hash (über die Web-Crypto-API, daher asynchron) und nimmt dessen erste 16 Byte als UUID, mit gesetzten Versions-Bits (5) und Variant-Bits. v5 erzeugt immer genau eine UUID — es gibt hier keine Mengenauswahl.

Für v5 brauchst du zwei Eingaben:

  • Name — die Zeichenkette, aus der abgeleitet wird (Platzhalter „e.g. example.com"). Ohne Name erscheint der Hinweis „Please enter a name.".
  • Namespace — siehe nächster Abschnitt.

Hinweis: Das Tool bietet v5 (SHA-1) an, kein v3 (MD5). Für namensbasierte UUIDs ist v5 die empfohlene Variante.

Namespaces für v5

Der Namespace legt fest, in welchem „Kontext" der Name interpretiert wird — derselbe Name in zwei verschiedenen Namespaces ergibt zwei verschiedene UUIDs.

Vordefinierte Namespaces

Im Dropdown Namespace stehen die vier in RFC 9562 (Appendix A) festgelegten Standard-Namespaces zur Auswahl:

  • DNS (6ba7b810-9dad-11d1-80b4-00c04fd430c8) — für Domain-Namen, z. B. example.com.
  • URL (6ba7b811-9dad-11d1-80b4-00c04fd430c8) — für vollständige URLs.
  • OID (6ba7b812-9dad-11d1-80b4-00c04fd430c8) — für Object Identifier.
  • X.500 (6ba7b814-9dad-11d1-80b4-00c04fd430c8) — für X.500-Distinguished-Names.

Eigener Namespace (Custom UUID)

Wählst du im Dropdown Custom UUID, wird das Feld Custom Namespace UUID aktiv. Dort trägst du eine eigene Namespace-UUID im Standardformat ein. Das Tool prüft das Format streng (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx, Hex). Fehlt der Wert, erscheint „Please enter a custom namespace UUID."; ist er falsch formatiert, „Invalid namespace UUID format.". So kannst du eine projekteigene Namespace-Hierarchie aufbauen und v5-UUIDs reproduzierbar daraus ableiten.

Anzahl und Massen-Erzeugung

Für v4, v7 und v1 steht das Dropdown Number of UUIDs zur Verfügung. Wählbar sind die festen Stufen 1, 2, 3, 4, 5, 10, 20, 50, 100, 200, 500 und 1000. Erzeugst du mehrere, listet das Tool sie untereinander (eine UUID pro Zeile) im Ergebnisfeld — bequem zum Kopieren als Block. v5 hat keine Mengenauswahl und liefert genau eine UUID.

Die NIL-UUID

Im Fuß der Karte steht dauerhaft die NIL-UUID 00000000-0000-0000-0000-000000000000 — die „leere" UUID, bei der alle 128 Bit Null sind. Sie dient als Platzhalter oder Null-Wert, wo eine UUID erwartet, aber keine echte gesetzt wird. Ein kleiner Kopier-Knopf daneben übernimmt sie in die Zwischenablage. Eine MAX-UUID bietet das Tool nicht an.

Kopieren

Der Kopier-Knopf (Klemmbrett-Symbol) neben jedem Ergebnisfeld übernimmt den gesamten Inhalt in die Zwischenablage. Hast du noch nichts erzeugt (es steht nur der Platzhalter im Feld), erscheint der Hinweis „No UUIDs to copy. Generate some first.". Der separate Knopf am NIL-UUID-Eintrag kopiert ausschließlich die NIL-UUID.

Ausgabeformat

Alle UUIDs werden im kanonischen Format ausgegeben: 32 Hex-Ziffern in Kleinschreibung, gruppiert als 8-4-4-4-12 mit Bindestrichen, zum Beispiel:

f47ac10b-58cc-4372-a567-0e02b2c3d479

Das Tool bietet keine alternativen Ausgabeformate an — keine Großschreibung, keine geschweiften Klammern (Braces), keine Variante ohne Bindestriche und keine Base64-Kodierung. Wer ein anderes Format braucht, formatiert die kopierte UUID nachträglich (das editierbare Ergebnisfeld erlaubt kleine Anpassungen von Hand).

Zufallsquelle und Sicherheit

Die Zufallsversionen v4, v7 und v1 ziehen ihre Zufallsbits aus dem kryptografisch sicheren Zufallsgenerator des Browsers — crypto.getRandomValues, bei v4 wenn verfügbar direkt crypto.randomUUID(). Das ist sicherheitsrelevant: Im Gegensatz zu Math.random ist diese Quelle nicht vorhersagbar, sodass sich UUIDs nicht erraten lassen. v5 ist nicht zufällig, sondern berechnet sich deterministisch über einen SHA-1-Hash. Weil das Tool die Web-Crypto-API verwendet, läuft es in einem sicheren Kontext (HTTPS).

Betriebsgrenzen und Datenschutz

  • Clientseitig: Die gesamte Erzeugung passiert im Browser. Es gibt keinen Server-Aufruf, keine Übertragung von Namen, Namespaces oder Ergebnissen.
  • Sicherer Kontext: Die genutzte Web-Crypto-API setzt HTTPS voraus (oder localhost).
  • Mengen: Pro Lauf 1 bis 1000 UUIDs (v4/v7/v1); v5 genau eine.
  • Format fix: Ausgabe ausschließlich im kanonischen Kleinschreib-Format mit Bindestrichen.
  • Versionen: v4, v7, v1, v5 sowie die NIL-UUID — kein v3, kein MAX.

Für den Einstieg und die Versions-Empfehlung siehe die Übersichtsseite. Konkrete Durchläufe stehen in den Beispielen, Strategie und Stolperfallen in den Tipps & Tricks. Ausprobieren kannst du alles direkt im Tool.