Generador de claves API

Cómo utilizar el generador de claves API

1. Elige formato, entropía y cantidad. Empieza por 256 bits y Base64URL, salvo que tu aplicación indique otra cosa.
2. Abre las opciones avanzadas para prefijos, alfabetos o identificadores públicos. Revisa la longitud calculada antes de generar.
3. Genera y copia una clave o revisa la exportación. Guarda los secretos de producción en tu gestor de secretos, no en documentos públicos.
4. Registra el secreto en tu aplicación. Configura allí el acceso, la caducidad y la revocación, y borra esta página al terminar.

Pensado para trabajar con secretos

La tarea sencilla sigue siendo rápida: elige, genera y copia. Si tu integración necesita más, dispones de codificaciones de bytes, alfabetos, etiquetas de aplicación, identificadores públicos y lotes de hasta 1.000 claves. No necesitas cuenta ni instalación. Las explicaciones te ayudan a elegir con criterio, sin asumir que una cadena visualmente más larga siempre es más fuerte.

Formatos que encajan en tu aplicación

Base64URL evita el signo más y la barra de Base64 normal y omite el relleno. Hexadecimal resulta fácil de revisar y se acepta ampliamente, aunque ocupa más caracteres para los mismos bytes. Base32 utiliza aquí A–Z y 2–7 sin relleno. Base64 normal conserva su relleno estándar. Comprueba siempre lo que exige la aplicación receptora: codificar no es cifrar.

Alfabetos propios sin etiquetas engañosas

Puedes usar letras, dígitos, un conjunto definido de símbolos o tu propio alfabeto ASCII imprimible. Eliminamos los caracteres repetidos para que no tengan más probabilidad. La exclusión de caracteres similares retira 0, O, 1, I, l y |. Un objetivo en bits calcula la longitud necesaria; un número exacto de caracteres permite respetar límites de campos. Cuantas menos opciones tenga el alfabeto, más caracteres harán falta para la misma entropía teórica.

Puntos de partida, no credenciales de proveedores

Token de API empieza con Base64URL de 256 bits. Secreto de webhook usa hexadecimal de 256 bits para tu propio sistema de verificación con secreto compartido. Secreto de aplicación utiliza Base64URL de 512 bits; Lote de desarrollo prepara diez tokens de 256 bits. Son atajos de configuración, no estándares universales ni claves emitidas por proveedores. Los prefijos y sufijos identifican aplicaciones o entornos. Añadir live_ no activa la clave ni concede permisos.

De una clave a una exportación organizada

Copia secretos individuales o el lote completo. Los pares opcionales añaden un identificador público aleatorio de 96 bits para localizar el registro; conserva el secreto privado y no autentiques con el ID. JSON mantiene los valores exactos. TXT admite líneas, comas o espacios. CSV escapa celdas y neutraliza comienzos de fórmula, a veces añadiendo un apóstrofo. .env valida nombres y rechaza comillas incompatibles. Está pensado para Node dotenv, no para ejecutarlo como script de consola. Las descargas contienen secretos en texto plano, no copias cifradas.

Cómo calculamos bits, bytes y caracteres

Para formatos de bytes obtenemos ceil(bits objetivo / 8) bytes aleatorios y mostramos bytes × 8 bits nominales. Con N caracteres independientes y uniformes elegidos entre A caracteres distintos, la entropía teórica es N × log₂(A). Un objetivo requiere ceil(bits objetivo / log₂(A)) caracteres. Por ejemplo, 256 bits solo con números necesitan 78 dígitos, no 32. Prefijos, sufijos e identificadores públicos separados no cuentan como entropía del secreto. Son cálculos del diseño de generación, no una medición ni certificación de la fuente aleatoria del navegador.

Un valor aleatorio, distintas representaciones

32 bytes × 8 = 256 bits

Estas longitudes no incluyen prefijos ni sufijos. La codificación cambia la representación, no la aleatoriedad subyacente.

Nuestra metodología de generación

Usamos crypto.getRandomValues y exigimos un contexto seguro. Nunca recurrimos a Math.random, marcas de tiempo, actividad del teclado o semillas predecibles. Las codificaciones de bytes son representaciones sin pérdida. Para alfabetos aplicamos muestreo por rechazo: descartamos el resto desigual antes de asignar bytes a caracteres. Esto evita el sesgo de aplicar módulo a todos los bytes cuando el tamaño del alfabeto no divide 256. Cada lote se comprueba para detectar secretos e identificadores repetidos. Los reintentos están limitados y un fallo no entrega un resultado incompleto.

Qué permanece en tu navegador

La generación y preparación de exportaciones son locales. ClockTools no envía las claves a sus servidores ni las coloca en URLs, analítica o almacenamiento persistente. Incluso al llegar desde otra herramienta, esta página abre un documento nuevo sin nuestros cargadores de analítica ni grabación de sesiones. Los ajustes guardados y compartidos excluyen campos libres y claves. El proveedor de alojamiento sigue recibiendo las peticiones normales de página. Copiar envía el valor al portapapeles; descargar crea un archivo en texto plano. Extensiones, portapapeles sincronizados, malware o alguien mirando la pantalla siguen siendo riesgos. Borrar elimina los resultados de la interfaz, sin garantizar el borrado seguro de memoria ni eliminar copias externas.

Cómo usar una clave de forma segura

Una cadena aleatoria se convierte en credencial API cuando tu aplicación la registra y verifica. Configura allí privilegios mínimos, HTTPS, revocación, caducidad y rotación. No incluyas secretos del servidor en código frontend ni repositorios. Para producción, utiliza una gestión de secretos adecuada. En entornos sensibles conviene generar dentro de tu propia infraestructura de confianza. Los ejemplos de Node.js, Python y OpenSSL crean secretos nuevos localmente, sin copiar valores de una web. Ningún sitio garantiza que el navegador o dispositivo esté libre de compromisos.

Qué comprobamos y qué no demuestran las pruebas

Las pruebas de regresión cubren longitudes, vectores de codificación conocidos, alfabetos, muestreo por rechazo, entropía, afijos, duplicados, exportaciones y serialización segura de ajustes. Las comprobaciones de navegador incluyen generación, copia, exportación, diseños traducidos y separación de analítica. La ausencia de duplicados o una distribución visualmente uniforme no demuestra aleatoriedad criptográfica. La herramienta no está certificada de forma independiente y nuestras pruebas no son una auditoría de toda tu aplicación.

Informa de errores sin revelar secretos

Indica formato, modo de longitud, bits o caracteres, cantidad, navegador y pasos para reproducir el problema. Usa ejemplos inventados en lugar de claves activas, secretos de webhook o datos de clientes. Aplicamos nuestra política de correcciones. Ante un defecto importante confirmado, debemos explicar el comportamiento afectado, añadir una prueba de regresión e indicar si es necesario regenerar claves anteriores. Cambiar esta página no revoca claves registradas en otros sistemas; debes sustituirlas o revocarlas allí.

Generar en tu propio equipo

Los ejemplos crean un secreto nuevo con el formato y los afijos elegidos. Nunca incluyen la clave mostrada ni crean cuentas, permisos o reglas de caducidad. No incluyen identificadores públicos ni generación por lotes.

import { randomBytes } from 'node:crypto';
const key = randomBytes(32).toString('base64url');