UUID v5 생성기

버전 5 UUID는 추첨이 아니라 해시입니다. 네임스페이스 UUID 뒤에 이름을 붙여 SHA-1을 돌리고, 앞의 16바이트가 식별자가 되며, 6비트를 덮어써서 버전과 변형을 기록합니다. 그 결과 같은 네임스페이스와 같은 이름은 어떤 기계에서든, 어떤 언어에서든, 언제까지나 같은 UUID를 만들어 냅니다. 이것이 존재 이유 전부이고, 버전 4의 무작위성과는 정반대입니다. 표준 네임스페이스 네 가지 중 하나를 고르거나 직접 붙여 넣고 이름을 입력하면, 해싱은 웹 크립토 API를 통해 로컬에서 이뤄집니다.

쓸모를 만들어 내는 것이 바로 이 결정성입니다. 시스템의 모든 서비스가 레코드의 식별자를 안정적인 자연 키 — URL, 도메인, 파일 경로, 계정 번호 — 에서 유도한다면, 서로 조율하지 않고도, 공유 카운터 없이도, ID가 무엇인지 물어보는 왕복 없이도 전부 같은 UUID에 도달합니다. 같은 데이터를 두 번 들여와도 같은 식별자가 나오므로, 옛 키를 새 키에 대응시키는 조회 테이블 없이 멱등한 업서트가 가능해집니다.

여러분의 UUID가 남들 것과 일치하는지를 가르는 세부가 둘 있습니다. 네임스페이스는 하이픈이 든 36자 텍스트가 아니라 16바이트 원시 값으로 해싱됩니다. 문자열을 그대로 해싱하는 것이야말로, 그럴듯해 보이지만 다른 어떤 라이브러리와도 일치하지 않는 UUID를 만들어 내는 가장 흔한 경로입니다. 이름도 바이트로 해싱되므로 인코딩이 중요합니다. 같은 이름이라도 UTF-8과 UTF-16에서 서로 다른 UUID가 나오는데, RFC는 하나를 강제하는 대신 그 선택을 네임스페이스 자체의 관례에 맡깁니다. 이 도구는 UTF-8을 쓰고, 흔히 쓰이는 모든 라이브러리가 그렇게 합니다.

버전 5가 아닌 것은 보안 수단입니다. 이름을 추측할 수 있는 사람은 UUID를 계산할 수 있다는 의미에서 입력은 복원 가능하므로, 이메일 주소에서 UUID를 유도한다고 해서 추측을 대조해 보는 사람에게서 그 주소를 감출 수는 없습니다. 또 SHA-1은 작정한 공격자에 대해 더 이상 충돌 저항성이 없습니다. 자기 데이터로 직접 만드는 식별자에는 문제가 되지 않지만, 공격자가 이름을 고를 수 있는 상황이라면 문제가 됩니다.