Generador de GUID y UUID

UUID v4 es la opción aleatoria de propósito general. Después de fijar los bits obligatorios de versión y variante, quedan 122 bits aleatorios. Es un buen valor predeterminado para clientes independientes, datos de prueba, identificadores públicos de recursos y sistemas que no necesitan que el propio identificador revele una hora.

UUID v7 coloca una marca temporal Unix en milisegundos en los 48 bits más significativos y luego, en esta implementación, usa bits aleatorios para el espacio variable restante. Eso hace que los valores de milisegundos distintos se ordenen en líneas generales por hora de creación cuando los relojes avanzan, lo que puede ayudar en la revisión de logs y algunos patrones de índice.

La versión 7 no promete un orden estricto de generación. Este generador no añade un contador monótono ni una secuencia de submilisegundos. Los valores creados en el mismo milisegundo contienen bits finales aleatorios, y un reloj de dispositivo que retrocede puede alterar el orden visible.

La forma familiar con guiones es una presentación textual de 16 bytes. Los cinco grupos tienen 8, 4, 4, 4 y 12 dígitos hexadecimales, pero los grupos no son cadenas aleatorias separadas. El nibble de versión aparece al comienzo del tercer grupo, y la variante RFC aparece en el primer dígito hexadecimal del cuarto grupo.

El ejemplo v4 público fijo 550e8400-e29b-41d4-a716-446655440000 tiene 4 en la posición de versión y a en la posición de variante RFC. El dígito de variante puede ser 8, 9, a o b para la variante RFC porque los bits iniciales son 10. Estas posiciones explican cómo la inspección reconoce campos; no revelan si los demás bits se generaron aleatoriamente. Un valor escrito a mano puede imitar el mismo patrón.

El inspector también reconoce valores nulo y máximo como centinelas especiales. Nulo son todos los bits a cero; máximo son todos los bits a uno. Pueden tener significado estructural en un protocolo, pero no son identificadores aleatorios generados y no deben confundirse con valores únicos ordinarios.

Para UUID v7, ClockTools toma una marca temporal de milisegundo del reloj del dispositivo para el lote y la escribe en los seis primeros bytes de cada valor. Cada valor recibe aún bytes aleatorios frescos antes de fijar los bits de versión y variante. Si el valor del reloj no cabe en el campo de marca temporal v7 de 48 bits, la generación falla en lugar de desbordar.

El recuento de únicos es local al lote generado actual. El generador usa un Set y reintentos limitados para que no se devuelvan salidas aleatorias duplicadas dentro del lote solicitado. No consulta un registro global, una base de datos, otra pestaña ni valores producidos ayer.

La probabilidad no es lo mismo que una regla de negocio. Si las claves duplicadas tendrían consecuencias, impón la unicidad donde se almacenan los identificadores y gestiona allí los errores de conflicto. La generación no puede conocer el estado de tu aplicación. Una generación nueva fallida borra el lote anterior en lugar de dejar un resultado antiguo con aspecto de solicitud nueva correcta, así que copia los datos de prueba necesarios antes de experimentar con el siguiente lote.

El formato de texto es útil cuando el receptor espera un UUID impreso. Minúsculas es la salida canónica del navegador usada por el generador, mayúsculas sirve para sistemas con esa convención, llaves y comillas son envoltorios, sin guiones es la forma compacta de 32 hexadecimales y URN añade el prefijo urn:uuid:.

La codificación es otra capa. Texto sin formato conserva el formato de texto seleccionado. La salida con codificación URL codifica porcentualmente ese texto. Base64 y Base64 URL ignoran el envoltorio de formato de texto y codifican los 16 bytes sin procesar en orden de red; el selector de formato se desactiva para esas codificaciones porque las llaves o mayúsculas no forman parte del valor en bytes.

La presentación decide cómo se ordenan varios valores. Uno por línea es lo más fácil de revisar. CSV crea una fila de campos separados por comas. Array JSON sirve para datos de prueba y código. Valores SQL crea valores entre comillas separados por comas; es una lista de valores, no una sentencia SQL completa.

Para el UUID fijo 550e8400-e29b-41d4-a716-446655440000, las codificaciones de bytes son VQ6EAOKbQdSnFkRmVUQAAA== en Base64 y VQ6EAOKbQdSnFkRmVUQAAA en Base64 URL. El texto ordinario tiene 36 caracteres, el hexadecimal compacto tiene 32, Base64 con relleno tiene 24 y esta forma Base64 URL sin relleno tiene 22. Representan los mismos 16 bytes. Codificar los 36 caracteres ASCII impresos en su lugar codificaría otra entrada y no daría esos resultados de bytes.

RFC 4648 describe los alfabetos Base64 y seguro para URL. La forma segura para URL sustituye los caracteres más y barra usados por Base64 ordinario y, en esta herramienta, omite el relleno final. Las mayúsculas y minúsculas siguen importando en ambos alfabetos Base64; no pongas en minúsculas un valor Base64 como si fuera texto UUID hexadecimal. Codificación URL es una tercera opción: las llaves se convierten en %7B y %7D, mientras que las letras, dígitos y guiones del UUID canónico no necesitan sustitución porcentual.

El orden de bytes forma parte de un contrato de intercambio. Esta página codifica bytes en el mismo orden de red que el texto hexadecimal canónico. La documentación de Guid.ToByteArray de Microsoft muestra que su salida de bytes sin parámetros invierte los tres primeros grupos de campos respecto al texto. Si el receptor usa esa representación, compara explícitamente el orden de bytes documentado; acordar que ambos campos contienen un GUID no establece que sus cadenas Base64 coincidan.

Las comillas también son una capa. El formato de texto Entre comillas añade caracteres de comillas a cada valor; una presentación JSON luego escapa esas comillas dentro de su cadena, y CSV las escapa dentro de un campo. Por tanto, las comillas escapadas extra pueden ser una serialización correcta y aun así ser incorrectas para un receptor que quería un UUID desnudo. Minúsculas más Texto sin formato es un punto de partida directo para importaciones JSON y CSV. Valores SQL usa cadenas entre comillas simples; aporta por separado la estructura de consulta circundante y prefiere consultas de aplicación parametrizadas en lugar de pegar cadenas generadas en una consulta activa.

Una estructura válida significa que el texto encaja en una forma UUID admitida y que pueden leerse sus campos de versión y variante. No demuestra que el identificador haya sido generado por ClockTools, por Web Crypto, por un servicio concreto ni en la hora v7 decodificada.

Para UUID v7, la marca temporal es evidencia útil solo dentro de una investigación más amplia. Puede reflejar el reloj del dispositivo usado por un generador, una marca temporal alterada deliberadamente o un valor de prueba copiado. Trátala como una pista de ordenación y luego compárala con logs de servidor, marcas temporales de base de datos y registros de auditoría confiables.

El inspector acepta hexadecimal compacto o texto con guiones, y puede quitar envoltorios comunes como llaves, paréntesis, comillas o un prefijo urn:uuid: antes de comprobar. No decodifica Base64, Base64 URL ni entradas con codificación URL para validarlas; decodifica esas representaciones en el sistema receptor antes de la inspección estructural.

La inspección acepta un identificador a la vez, no una fila CSV exportada ni un array JSON. Usar valor generado pega el primer UUID original del lote actual, no su visualización codificada, así que puedes inspeccionar un lote aunque Base64 esté seleccionado. El inspector reconoce versiones RFC admitidas de 1 a 8, pero la generación ofrece solo v4 y v7. Una advertencia de variante no admitida aún puede mostrar una forma normalizada; no es una validación RFC correcta ni permiso para reescribir los campos del protocolo de origen.

Un error de cantidad significa que el recuento no es un número entero de 1 a 1.000. La herramienta no redondea, limita ni reduce silenciosamente la solicitud. Un error de fuente aleatoria significa que Web Crypto no proporcionó bytes aleatorios utilizables, así que no se generaron identificadores.

Puede producirse un error de codificación cuando un navegador no tiene la API necesaria para la codificación de salida elegida. Cambia a Texto sin formato para recuperar el lote subyacente o prueba otro navegador. Un fallo de generación es distinto: descarta el lote en lugar de conservar valores parciales. Los fallos de portapapeles, compartir y descarga no regeneran identificadores. Cuando falla el acceso de exportación, selecciona manualmente la salida visible si está disponible; revisa las descargas antes de suponer que se guardó un archivo iniciado.

No pegues secretos de producción en un informe de UUID. Un UUID puede ser público, privado o sensible para la seguridad según cómo lo use tu sistema, pero la forma por sí sola no lo convierte en una contraseña. Para tokens portadores, restablecimientos de contraseña o credenciales de API, usa un generador de secretos y controles de ciclo de vida diseñados para ese fin.