UUID 생성기 · 디코더 (UUID Generator & Decoder)

UUID란 무엇인가요?

// Generate a UUID v4 using the Web Crypto API
const uuid = crypto.randomUUID();
console.log(uuid);
// → '550e8400-e29b-41d4-a716-446655440000'

// Manual v4 generation with crypto.getRandomValues()
function generateUUIDv4() {
  const bytes = new Uint8Array(16);
  crypto.getRandomValues(bytes);
  bytes[6] = (bytes[6] & 0x0f) | 0x40; // version 4
  bytes[8] = (bytes[8] & 0x3f) | 0x80; // variant 10
  const hex = Array.from(bytes, b => b.toString(16).padStart(2, '0')).join('');
  return `${hex.slice(0,8)}-${hex.slice(8,12)}-${hex.slice(12,16)}-${hex.slice(16,20)}-${hex.slice(20)}`;
}

주요 기능

UUID 버전 비교

용도에 맞는 UUID 버전을 선택하십시오.

UUID와 다른 ID 형식 비교

UUID 버전 예시

550e8400-e29b-41d4-a716-446655440000

01906b5e-4a3e-7234-8f56-b8c12d4e5678

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

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

사용 방법

1. 1

   UUID 버전 선택

   v1(타임스탬프 기반), v3(MD5 이름 기반), v4(무작위), v5(SHA-1 이름 기반), v7(시간 정렬 무작위) 중에서 선택하십시오. 각 버전은 다른 용도를 지원하며 일반적인 용도로는 v4가 가장 많이 쓰입니다.

2. 2

   옵션 설정

   v3와 v5는 네임스페이스(DNS, URL, OID, X.500 또는 사용자 지정)를 선택하고 해시할 이름을 입력합니다. 수량은 1에서 50 사이로 설정하고 출력 형식을 고릅니다: 표준 소문자, 대문자, 하이픈 없음, 중괄호 {GUID}.

3. 3

   UUID 생성

   생성 버튼을 클릭하십시오. 각 UUID는 Web Crypto API(crypto.getRandomValues())를 사용해 암호 수준의 안전성으로 만들어집니다. 버전별 필드인 타임스탬프(v1/v7)와 해시(v3/v5)도 올바르게 인코딩됩니다.

4. 4

   복사 후 사용

   UUID 옆의 복사 버튼으로 개별 값을 클립보드로 복사하거나 모두 복사를 사용해 생성된 모든 UUID를 한 번에 가져오십시오. 디코드 탭으로 전환하면 기존 UUID의 버전, 변형, 타임스탬프, 기타 내장 정보를 분석할 수 있습니다.

일반적인 활용 사례

데이터베이스 기본 키

데이터베이스 노드 간 조정 없이 UUID v4 또는 v7을 고유한 기본 키로 사용합니다. UUID v7은 시간 정렬 특성 덕분에 B-트리 인덱스 성능이 향상되어 특히 적합합니다.

분산 시스템

마이크로서비스, 메시지 큐, 이벤트 소싱 시스템에서 고유 식별자를 독립적으로 생성합니다. UUID는 중앙 ID 생성 서비스가 필요 없게 해 줍니다.

API 개발

RESTful과 GraphQL API용 고유 요청 ID, 상관 ID, 멱등 키를 만듭니다. UUID를 사용하면 분산 서비스 경계를 넘어 요청을 쉽게 추적할 수 있습니다.

세션 · 토큰 관리

인증 흐름용 고유 세션 식별자와 임시 토큰을 생성합니다. UUID는 대규모 사용자 기반에서 세션 충돌을 방지할 만큼 충분한 고유성을 제공합니다.

테스트 · 개발

자동화 테스트용 테스트 데이터, 모의 식별자, 고유 픽스처 ID를 빠르게 생성합니다. 일괄 생성으로 개발 데이터베이스와 테스트 스위트에 쉽게 값을 채울 수 있습니다.

기술 세부사항

UUID 구조

UUID는 128비트(16바이트)이며 32자리 16진수를 8-4-4-4-12 형식으로 표기합니다. 비트 48-51(13번 16진수 자리)은 버전 번호를 인코딩합니다. 비트 64-65는 UUID 레이아웃을 식별하는 변형 필드입니다. 나머지 비트는 버전별 페이로드(타임스탬프, 무작위 데이터, 해시 출력)를 담습니다.

버전 비트

비트 48-51(7번째 바이트의 상위 니블)이 UUID 버전을 인코딩합니다: 0001 = v1(타임스탬프 기반), 0011 = v3(MD5 이름 기반), 0100 = v4(무작위), 0101 = v5(SHA-1 이름 기반), 0110 = v6(재정렬 시간), 0111 = v7(Unix 에폭 시간). 이 네 비트는 생성 시 항상 명시적으로 설정됩니다.

변형 필드

비트 64-65(9번째 바이트의 최상위 두 비트)는 변형을 정의합니다. 패턴 10x는 RFC 4122/9562 UUID(대다수)를 의미합니다. 패턴 110은 혼합 엔디언 바이트 순서의 Microsoft GUID를 의미합니다. 패턴 0xx는 NCS 역호환 UUID(레거시)입니다. 패턴 111은 미래 사용을 위해 예약되어 있습니다.

RFC 9562 표준

2024년 5월에 발행된 RFC 9562는 RFC 4122를 대체하는 공식 UUID 명세입니다. UUID 버전 6, 7, 8을 공식 도입합니다. 버전 6은 정렬을 위해 v1 필드를 재정렬합니다. 버전 7은 48비트 Unix 밀리초 타임스탬프와 무작위 데이터를 사용하여 새로운 시간 기반 UUID의 권장 버전이 됩니다. 버전 8은 구현에 특화된 사용자 정의 UUID 형식을 제공합니다. RFC 9562은 또한 v1을 공식적으로 비권장하며 v6/v7을 선호합니다.

모범 사례

올바른 버전 선택

정렬이나 결정성이 필요하지 않은 범용 고유 식별자에는 v4를 사용하십시오. 데이터베이스 기본 키에는 v7을 사용하십시오. 시간 정렬 속성이 인덱스 성능을 크게 향상시킵니다. 이름에서 유도한 결정적 ID가 필요하면 v5를 사용하십시오(더 강한 해싱을 위해 v3보다 v5를 선호).

데이터베이스 기본 키에는 UUID v7 사용

UUID v7의 시간 정렬 구조는 B-트리 삽입을 순차적으로 유지하여 무작위 v4 UUID 대비 인덱스 단편화를 약 90% 줄입니다. 이는 쓰기 속도 향상, 더 작은 인덱스, 더 나은 캐시 활용으로 이어집니다. 대부분의 현대 데이터베이스(PostgreSQL 17+, MySQL 8.0+)가 이 패턴에 최적화된 네이티브 UUID 지원을 제공합니다.

UUID를 보안 토큰으로 사용하지 말 것

UUID는 고유성을 목적으로 설계되었고 비밀성을 위한 것이 아닙니다. UUID v1은 생성 타임스탬프와 MAC 주소를 노출합니다. UUID v4는 예측 가능한 구조와 함께 122비트 엔트로피만 가집니다. 보안 토큰, API 키, 세션 비밀에는 UUID 구조 오버헤드 없이 128비트 또는 256비트 순수 무작위 데이터를 전용 CSPRNG로 생성하십시오.

파싱 전 검증

파싱이나 저장 전에 항상 정규식으로 UUID 형식을 검증하십시오. API 엔드포인트, 폼 제출, 데이터베이스 입력 같은 시스템 경계에서 잘못된 입력을 거부하십시오. 유효하지 않은 식별자가 시스템 전반으로 전파되어 발생하는 삽입 공격, 데이터 손상, 디버깅이 어려운 오류를 예방합니다.

자주 묻는 질문