Generator UUID - Stvori jedinstvene identifikatore online

Što je UUID?

UUID (Universally Unique Identifier) je 128-bitni identifikator koji se koristi u računalnim sustavima za jedinstvenu identifikaciju informacija. UUID je standardiziran prema RFC 4122 i zahvaljujući svojoj ogromnoj entropiji jamči praktički nultu vjerojatnost kolizije – što znači da će dva neovisno generirana UUID-a biti gotovo sigurno jedinstvena.

UUID ima standardni format: xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx, gdje je svaki x heksadecimalna znamenka (0-9, a-f), M označava verziju UUID-a, a N označava varijantu.

Verzije UUID-a

UUID v1 (Vremenska oznaka + MAC adresa)

UUID v1 temelji se na trenutnoj vremenskoj oznaci (timestamp) i nasumičnoj vrijednosti (u pregledniku umjesto MAC adrese). Koristi intervale od 100 nanosekundi od 15. listopada 1582. (Gregorijanski kalendar).

Upotreba:

• Situacije kada trebate kronološko sortiranje UUID-a
• Debugging i bilježenje (UUID sadrži informaciju o vremenu stvaranja)
• Distribuirani sustavi s vremenskom sinkronizacijom

Primjer: 6ba7b810-9dad-11d1-80b4-00c04fd430c8

Prednosti:

• UUID-ovi se mogu kronološki sortirati prema vremenu stvaranja
• Korisno za reviziju i debugging
• Sadrži informaciju o vremenskoj oznaci

Mane:

• Potencijalni sigurnosni rizik – sadrži vremensku oznaku
• U pregledniku ne sadrži stvarnu MAC adresu (zamijenjeno nasumičnom vrijednošću)
• Loša lokalizacija baze podataka (vremenska oznaka je u niže-reda bitovima)

UUID v3 (MD5 hash)

UUID v3 generira se pomoću MD5 hasha imenskog prostora UUID-a i naziva. Determinističko – isti imenski prostor + naziv uvijek će stvoriti isti UUID.

Upotreba:

• Konverzija URL-ova, DNS naziva ili drugih identifikatora u UUID
• Situacije kada trebate ponovljive UUID-ove
• Mapiranje između različitih sustava identifikacije

Primjer: a3bb189e-8bf9-3888-9912-ace4e6543002

Prednosti:

• Determinističko (isti ulaz = isti izlaz)
• Idealno za konverzije poznatih identifikatora
• Nema kolizije za različite unose

Mane:

• MD5 je zastarjeli algoritam (preferirajte v5)
• Zahtijeva imenski prostor i naziv
• Nije moguće povratiti izvorni ulaz

UUID v4 (Nasumično) - PREPORUČENO

Najčešće korištena verzija UUID-a. UUID v4 generira se čisto nasumično pomoću kriptografski sigurnog generatora nasumičnih brojeva (crypto.getRandomValues()).

Upotreba:

• Primarni ključevi baze podataka
• Identifikatori sesija (session IDs)
• Jedinstveni nazivi datoteka
• API tokeni
• Opće namjene, gdje trebate zajamčeno jedinstveni ID

Primjer: f47ac10b-58cc-4372-a567-0e02b2c3d479

Prednosti:

• Maksimalna entropija i sigurnost
• Nema ovisnosti o vremenu ili sistemskim parametrima
• Najjednostavnija implementacija

Vjerojatnost kolizije: Pri generiranju 1 milijarde UUID-a u sekundi tijekom 100 godina, šansa za koliziju je približno 0,00000006%.

UUID v5 (SHA-1 hash)

UUID v5 je isti kao v3, ali koristi SHA-1 umjesto MD5. Modernija i sigurnija alternativa v3.

Upotreba:

• Isto kao v3, ali s boljom sigurnošću
• Preferirano u odnosu na v3 za nove projekte
• Generiranje UUID-a iz URL-ova, DNS naziva, OID-ova, X.500 DN-ova

Primjer: 886313e1-3b8a-5372-9b90-0c9aee199e5d

Prednosti:

• Determinističko
• SHA-1 je robusniji od MD5
• Prikladno za mapiranje između sustava

Mane:

• SHA-1 se također smatra zastarjelim (ali je i dalje sigurniji od MD5)
• Zahtijeva imenski prostor i naziv

UUID v6 (Sortirana vremenska oznaka)

UUID v6 je poboljšana verzija v1 s preuređenim vremenskim bitovima za bolje indeksiranje baze podataka. Dizajnirano za rješavanje problema s lokalizacijom u bazama podataka.

Upotreba:

• Primarni ključevi baze podataka s vremenskim sortiranjem
• Sustavi koji zahtijevaju kronološko sortiranje i performanse baze podataka
• Modernija alternativa v1

Primjer: 1ec9414c-232a-6b00-b3c8-9e6bdeced846

Prednosti:

• Bolja lokalizacija baze podataka od v1 (vremenska oznaka u bitovima višeg reda)
• Kronološko sortiranje
• Kompatibilno sa standardom UUID-a

Mane:

• Manje korišteno od v1/v4
• I dalje sadrži vremenske informacije (sigurnosni rizik)

UUID v7 (Unix vremenska oznaka)

UUID v7 koristi Unix vremensku oznaku (milisekunde od 1970) + nasumične bitove. Najnovija verzija UUID-a s najboljom lokalizacijom baze podataka.

Upotreba:

• Moderni primarni ključevi baze podataka
• Sustavi koji zahtijevaju performanse + vremensko sortiranje
• Zamjena za v1/v6 u novim projektima

Primjer: 017f22e2-79b0-7cc3-98c4-dc0c0c07398f

Prednosti:

• Najbolja lokalizacija baze podataka od svih verzija
• Unix vremenska oznaka je standardna
• Kombinira prednosti nasumičnosti i vremenskog sortiranja

Mane:

• Relativno nova specifikacija (RFC 4122bis)
• Manje podržana u zastarjelim sustavima

Koju verziju UUID-a koristiti?

Vodič za odluku

Trebate li maksimalnu sigurnost i nasumičnost? → Koristite UUID v4 (najčešći izbor)

Trebate li vremensko sortiranje i performanse baze podataka? → Koristite UUID v7 (moderno) ili UUID v6 (standardno)

Trebate li ponovljive UUID-ove iz postojećih identifikatora? → Koristite UUID v5 (SHA-1) ili UUID v3 (MD5, zastarjelo)

Trebate li vremensku oznaku i revizijski trag? → Koristite UUID v1 (zastarjelo, lošije performanse baze podataka)

Baze podataka

Za nove projekte: UUID v7 ili v4

• v7 je idealan za vremensko sortiranje + performanse
• v4 za maksimalnu nasumičnost bez vremenskih informacija

Za zastarjele sustave: UUID v1 ili v6

• v6 ima bolju lokalizaciju baze podataka od v1
• v1 je široko podržan

Prednosti UUID-a kao primarnog ključa:

• Globalna jedinstvenost – Možete povezivati podatke iz različitih baza podataka bez sukoba
• Sigurnost – Za razliku od sekvencijalnih ID-ova (1, 2, 3…) ne mogu se pogoditi sljedeće vrijednosti
• Distribuirani sustavi – UUID-ovi se mogu generirati neovisno na više poslužitelja bez koordinacije
• Spajanje baza podataka – Pri spajanju dviju baza podataka ne dolazi do sukoba

Mane:

• Veća veličina (16 bajtova vs 4-8 bajtova za integer)
• Sporije indeksiranje u nekim bazama podataka (koristite v6/v7 za bolje performanse)
• Manje čitljivo za čovjeka

API i web usluge

• REST API – Jedinstveni identifikatori za resurse
• GraphQL – Globalni identifikatori za čvorove
• Webhookovi – Praćenje zahtjeva i odgovora
• Tokeni – ID-ovi sesija, tokeni za osvježavanje

Datoteke i pohrana

• Nazivi datoteka – Sprječavanje kolizija pri učitavanju
• S3/Cloud Storage – Jedinstvene putanje do objekata
• Ključevi predmemorije – Identifikatori u sustavima predmemorije

Frontend aplikacije

• React/Vue komponente – Jedinstveni ključevi za liste
• Privremeni ID-ovi – ID-ovi prije spremanja u bazu podataka
• Lokalna pohrana – Ključevi za pohranjene podatke
• Offline-first aplikacije – Generiranje ID-ova bez povezivanja s poslužiteljem

Napredne značajke generatora

Generiranje UUID-a s vlastitim vremenom

Za verzije temeljene na vremenu (v1, v6, v7) možete odabrati bilo koju vremensku oznaku pomoću birača datuma i vremena. To je korisno za:

Testiranje:

• Simulacija UUID-ova stvorenih u prošlosti
• Testiranje vremenskog sortiranja u bazama podataka
• Reprodukcija UUID-ova za debugging

Migracija podataka:

• Generiranje UUID-ova s povijesnim vremenskim oznakama
• Popunjavanje podataka s ispravnim vrijednostima vremenskih oznaka
• Uvoz podataka iz različitih vremenskih razdoblja

Revizija i usklađenost:

• Rekonstrukcija UUID-ova prema vremenu nastanka zapisa
• Retroaktivno generiranje identifikatora

Primjer upotrebe:

1. Odaberite verziju v1, v6 ili v7
2. Postavite datum i vrijeme pomoću birača datuma i vremena
3. Generirajte UUID s vlastitom vremenskom oznakom

Hash-based UUID (v3, v5)

Za determinističke UUID-ove možete koristiti verzije v3 (MD5) ili v5 (SHA-1):

Kako koristiti:

1. Odaberite imenski prostor prema vrsti vašeg identifikatora
2. Unesite naziv/vrijednost
3. Generirajte UUID

Primjeri:

Važne karakteristike:

• ✅ Determinističko: Isti ulaz = uvijek isti UUID
• ✅ Ponovljivo: Možete ponovno stvoriti UUID u bilo kojem trenutku
• ✅ Konzistentno: Isti UUID u različitim sustavima
• ❌ Ne može se dekodirati: Iz UUID-a se ne može povratiti izvorni naziv
• ℹ️ Jedan UUID: Za v3/v5 uvijek se generira samo jedan UUID (isti ulaz = isti izlaz)

Praktična upotreba:

// Primjer: Konverzija URL-a u UUID v5
Imenski prostor: URL
Naziv: https://example.com/api/users/123
Rezultat: 886313e1-3b8a-5372-9b90-0c9aee199e5d

// Isti ulaz = uvijek isti UUID
Imenski prostor: DNS
Naziv: google.com
Rezultat: uvijek isti UUID za google.com

Kako sigurno koristiti UUID?

Kriptografska sigurnost

Naš generator koristi crypto.getRandomValues(), što je kriptografski siguran generator nasumičnih brojeva. Za razliku od Math.random(), koji je predvidljiv i neprikladan za sigurnosne svrhe, crypto.getRandomValues() pruža stvarnu entropiju prikladnu za:

• Generiranje sigurnosnih tokena
• ID-ovi sesija
• API ključevi
• Kriptografske aplikacije

Usporedba verzija UUID-a

UUID vs drugi identifikatori

Implementacija u različitim jezicima

JavaScript/TypeScript

// UUID v4 - Najjednostavniji način (moderni preglednici)
const uuid = crypto.randomUUID();

// UUID v4 - Ručna implementacija
function generateUUIDv4() {
  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
    const r = (crypto.getRandomValues(new Uint8Array(1))[0] & 0x0f) >> (c === 'x' ? 0 : 2);
    const v = c === 'x' ? r : (r & 0x3) | 0x8;
    return v.toString(16);
  });
}

// UUID v7 - Preporučeno za baze podataka
function generateUUIDv7() {
  const timestamp = Date.now();
  const timeHi = (timestamp >> 16).toString(16).padStart(8, '0');
  const timeLow = (timestamp & 0xFFFF).toString(16).padStart(4, '0');

  const randomBytes = crypto.getRandomValues(new Uint8Array(10));
  const randomHex = Array.from(randomBytes)
    .map(b => b.toString(16).padStart(2, '0'))
    .join('');

  return `${timeHi}-${timeLow}-7${randomHex.substr(0, 3)}-${randomHex.substr(3, 4)}-${randomHex.substr(7)}`;
}

Python

import uuid

# UUID v4
uuid_v4 = str(uuid.uuid4())
# Output: '6ba7b810-9dad-11d1-80b4-00c04fd430c8'

# UUID v1
uuid_v1 = str(uuid.uuid1())

Java

import java.util.UUID;

// UUID v4
String uuidV4 = UUID.randomUUID().toString();

PHP

// UUID v4 (PHP 7+)
function generateUUID() {
    return sprintf('%04x%04x-%04x-%04x-%04x-%04x%04x%04x',
        mt_rand(0, 0xffff), mt_rand(0, 0xffff),
        mt_rand(0, 0xffff),
        mt_rand(0, 0x0fff) | 0x4000,
        mt_rand(0, 0x3fff) | 0x8000,
        mt_rand(0, 0xffff), mt_rand(0, 0xffff), mt_rand(0, 0xffff)
    );
}

C#

using System;

// UUID v4
Guid uuid = Guid.NewGuid();
string uuidString = uuid.ToString();

Najbolje prakse

Pohrana UUID-a u bazi podataka

PostgreSQL:

CREATE TABLE users (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    email VARCHAR(255) NOT NULL,
    created_at TIMESTAMP DEFAULT NOW()
);

MySQL 8.0+:

CREATE TABLE users (
    id BINARY(16) PRIMARY KEY DEFAULT (UUID_TO_BIN(UUID())),
    email VARCHAR(255) NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

Savjet: U MySQL-u pohranjujte UUID kao BINARY(16) umjesto CHAR(36) radi uštede prostora i bržeg indeksiranja.

Validacija UUID-a

function isValidUUID(uuid) {
  const regex = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
  return regex.test(uuid);
}

Konverzija UUID-a

// Uklanjanje crtica
const compact = uuid.replace(/-/g, '');

// Dodavanje crtica natrag
function formatUUID(compactUuid) {
  return [
    compactUuid.substring(0, 8),
    compactUuid.substring(8, 12),
    compactUuid.substring(12, 16),
    compactUuid.substring(16, 20),
    compactUuid.substring(20, 32)
  ].join('-');
}

Rješavanje problema (Troubleshooting)

UUID v3/v5 ne radi

Problem: Nakon odabira v3 ili v5 ništa se ne generira

Rješenje:

1. ✅ Provjerite jeste li ispunili polje “Naziv” - obavezno je!
2. ✅ Odaberite ispravan imenski prostor prema vrsti vašeg unosa
3. ✅ Primjeri valjanih unosa:
   • DNS: example.com, google.com
   • URL: https://example.com/page
   • Bilo koji tekst: moja-aplikacija-v1

Savjet: Prvo pokušajte s jednostavnom vrijednošću poput test i DNS imenskim prostorom.

Vremenski UUID (v1, v6, v7) ima čudno vrijeme

Problem: Generirani UUID ima neočekivanu vremensku oznaku

Rješenje:

1. ✅ Provjerite birač datuma i vremena - je li postavljeno ispravno vrijeme?
2. ✅ Birač datuma i vremena koristi vašu lokalnu vremensku zonu
3. ✅ Ostavite birač datuma i vremena prazan za trenutačno vrijeme

UUID se ne može kopirati

Problem: Gumb “Kopiraj sve” ne radi

Rješenje:

1. ✅ Provjerite jeste li generirali UUID (nisu prazni)
2. ✅ Neki preglednici zahtijevaju HTTPS za clipboard API
3. ✅ Alternativno, odaberite tekst u tekstualnom polju i kopirajte ga ručno (Ctrl+C)

Često postavljana pitanja (FAQ)

Alternative UUID-u

ULID (Universally Unique Lexicographically Sortable Identifier)

• 128-bitni ID (kao i UUID)
• Leksikografski se može sortirati prema vremenu stvaranja
• Kompaktniji prikaz (26 znakova umjesto 36)
• Case-insensitive base32 kodiranje

Primjer: 01ARZ3NDEKTSV4RRFFQ69G5FAV

NanoID

• Manja veličina od UUID-a (standardno 21 znak)
• URL-prijateljski (bez posebnih znakova)
• Brže generiranje
• Konfigurabilna duljina i abeceda

Primjer: V1StGXR8_Z5jdHi6B-myT

Snowflake ID (Twitter)

• 64-bitni ID (manji od UUID-a)
• Vremenski sortabilno
• Sadrži ID radnika i redni broj
• Zahtijeva centraliziranu konfiguraciju

Primjer: 1234567890123456789

Performanse i optimizacija

Brzina generiranja

Naš generator može generirati:

• 1 UUID: < 1 ms
• 100 UUID: ~10-20 ms
• 1000 UUID: ~100-200 ms

Savjeti za performanse

1. Skupno generiranje – Ako trebate mnogo UUID-a, generirajte ih odjednom umjesto pojedinačno
2. Pohrana u DB – Indeksirajte UUID stupce za brzo pretraživanje
3. Kompresija – Pohranite UUID-ove u binarnom obliku (16 bajtova) umjesto stringa (36 bajtova)
4. Keširanje – U nekim slučajevima možete prethodno generirati i keširati UUID-ove

Za programere

Struktura UUID v4

xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
|        |    |    |    |
|        |    |    |    └─ 48 bita nasumičnih podataka (node)
|        |    |    └────── 16 bita nasumičnih podataka s varijantom (clock_seq)
|        |    └─────────── 12 bita nasumičnih podataka + 4 bita verzije (time_hi_and_version)
|        └──────────────── 16 bita nasumičnih podataka (time_mid)
└───────────────────────── 32 bita nasumičnih podataka (time_low)

• Verzija (4 bita): uvijek 0100 (binarno) = 4 (heksadecimalno)
• Varijanta (2-3 bita): uvijek 10 (binarno) za RFC 4122

Testiranje UUID-a

// Jest test
describe('UUID Generator', () => {
  test('generates valid UUID v4', () => {
    const uuid = generateUUIDv4();
    const regex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
    expect(regex.test(uuid)).toBe(true);
  });

  test('generates unique UUIDs', () => {
    const uuid1 = generateUUIDv4();
    const uuid2 = generateUUIDv4();
    expect(uuid1).not.toBe(uuid2);
  });
});

Sigurnosni aspekti

Što ne raditi s UUID-om

❌ Nemojte koristiti UUID v1 za osjetljive aplikacije – Sadrži vremensku oznaku, što može biti sigurnosni rizik

❌ Nemojte koristiti Math.random() za generiranje UUID-a – Nije kriptografski sigurno

❌ Nemojte se oslanjati na UUID za autorizaciju – UUID se može pogoditi (iako s ekstremno malom vjerojatnošću)

❌ Nemojte pohranjivati UUID u kolačićima bez šifriranja – Koristite potpisane kolačiće ili JWT

Što raditi

✅ Koristite UUID v4 za većinu slučajeva – Najviša entropija i sigurnost

✅ Kombinirajte UUID s drugim sigurnosnim mjerama – Za upravljanje sesijama koristite HTTPS, HttpOnly kolačiće i kratko trajanje isteka

✅ Validirajte UUID na poslužitelju – Uvijek provjerite format i verziju UUID-a

✅ Koristite kriptografski sigurne izvore nasumičnosti – crypto.getRandomValues() u pregledniku, /dev/urandom na Linuxu

Zanimljivosti

• Broj mogućih UUID v4: 2^122 ≈ 5.3 × 10^36 (340 undeciliona)
• Potrebna kolizija: Za 50% šanse za koliziju morate generirati 2.71 × 10^18 UUID-ova (2.71 kvintiliona)
• Veličina svih mogućih UUID-ova: Kad bismo svaki UUID pohranili kao 16 bajtova, cijeli prostor bi zauzeo 85 zetabajta (85 milijardi terabajta)
• Porijeklo: UUID je standardiziran kao dio DCE (Distributed Computing Environment) 1990. godine