Generador TOTP: cómo se calcula el código de 6 dígitos

PublicadoHerramientaGenerador y probador de TOTP / OTP (2FA)

Contenido
  1. Cuando no sabes por qué el número no coincide
  2. El procedimiento estándar para calcular los 6 dígitos sin ninguna herramienta
  3. Los puntos que más confunden
  4. En resumen
  5. Preguntas frecuentes

El código de 6 dígitos que aparece en apps como Google Authenticator o Authy no es un valor que el servidor envíe en tiempo real. Es el resultado que tu propio dispositivo calcula con una única clave secreta y la hora actual. Por eso el número aparece incluso en modo avión y, en cambio, si el reloj del dispositivo está desfasado, el número sale mal.

Este artículo explica, tal como lo fija el estándar (RFC), en qué orden se generan esos 6 dígitos y qué se guarda dentro del código QR. No es un texto para decidir qué método de autenticación deberías usar, sino para quienes quieren comprobar cómo funciona, con hechos verificables.

Resumen ① La clave secreta en Base32 es el único material secreto que genera el número; el emisor y la cuenta son solo la etiqueta que aparece en la lista de la app y no entran en el cálculo de los 6 dígitos. ② Los 6 dígitos son el resto de dividir entre 1.000.000 el resultado de mezclar con HMAC-SHA1 "la clave secreta (llave) + el contador de la hora UTC actual dividida entre 30 (mensaje)", y luego recortar ese resultado. ③ La causa más habitual de que el número no coincida es que el reloj del dispositivo esté desfasado o que se hayan metido en la clave secreta caracteres que no existen en Base32 (como 0, 1, 8 y 9).

Cuando no sabes por qué el número no coincide

Piensa en la situación de cambiar de móvil y trasladar la app de autenticación. Cuando ya no puedes volver a mostrar el código QR y entras en la pantalla de "introducir la clave de configuración manualmente", la app te pide tres campos: clave secreta, emisor y nombre de la cuenta.

Si en ese momento no sabes qué va en cada casilla ni cuál de los tres cambia realmente el número, acabas rellenando a ojo. Y si terminas el registro y aparece "El código no es válido", no puedes distinguir si la clave secreta está mal o si el reloj está desfasado.

El problema es que el proceso con el que se generan los 6 dígitos está escondido dentro de la app. Una vez que ves el mecanismo con tus propios ojos, puedes señalar por tu cuenta en qué paso te equivocaste.

El procedimiento estándar para calcular los 6 dígitos sin ninguna herramienta

TOTP es un estándar abierto. Las reglas para generar el número están escritas tal cual en los documentos RFC, así que, si quieres, puedes reproducir el mismo valor a mano o con un comando.

Qué significa cada uno de los tres campos

Primero hay que distinguir la función de las tres casillas que pide la app.

  • Clave secreta en Base32 (Secret): es el material original que comparten el servidor y tu dispositivo. Es el único valor secreto que entra en el cálculo del número.
  • Emisor (Issuer): el nombre del servicio que se muestra en la lista de la app, como "Google" o "GitHub".
  • Cuenta (Account): el correo o usuario que distingue varias cuentas dentro del mismo servicio.

La clave está en que los dos últimos valores no participan en absoluto en el cálculo del número. Por mucho que cambies la etiqueta, los 6 dígitos siguen igual.

Los cinco pasos que producen los 6 dígitos

Es el orden que fijan RFC 4226 (HOTP) y RFC 6238 (TOTP).

  1. Decodificar Base32: se convierte la clave secreta de vuelta a bytes. Base32 (RFC 4648) usa solo 32 caracteres, de la A a la Z y del 2 al 7, agrupados de 5 en 5 bits, así que hay que reagruparlos en unidades de 8 bits.
  2. Convertir la hora en contador: el contador es el cociente de dividir entre 30 los segundos transcurridos desde el 1 de enero de 1970 en UTC (hora Unix). El intervalo por defecto de RFC 6238 es de 30 segundos. Ese valor se escribe en 8 bytes.
  3. HMAC-SHA1: se calcula HMAC-SHA1 usando la clave secreta como llave y el contador de 8 bytes como mensaje, y sale un hash de 20 bytes.
  4. Truncamiento dinámico (dynamic truncation): con los 4 bits menos significativos del último de los 20 bytes se elige la posición inicial (0~15), se toman 4 bytes desde ahí y se descarta el bit más significativo para obtener un entero de 31 bits.
  5. Reducir a 6 dígitos: el resto de dividir ese entero entre 1.000.000 son los 6 dígitos. Si quedan menos cifras, se rellenan con ceros a la izquierda.

Con la misma clave secreta y el mismo intervalo de 30 segundos, el resultado es idéntico se calcule donde se calcule. Ahí está la razón de que el número de tu app y el del servidor coincidan.

Qué contiene un código QR

Un código QR no es una imagen: contiene una sola línea de URI. El formato es este.

otpauth://totp/발급기관:계정?secret=비밀키&issuer=발급기관

Aquí el único valor que genera el número es secret. El 발급기관:계정 del principio y el issuer son las etiquetas que la app usa para mostrar el nombre en la lista. Por eso escanear el QR y escribir la clave secreta a mano dan el mismo resultado.

Cómo verificarlo con la línea de comandos

Si quieres reproducirlo tú mismo, basta una línea con la herramienta de línea de comandos de código abierto oathtool (oath-toolkit).

oathtool --totp -b JBSWY3DPEHPK3PXP

-b indica que la clave secreta está en Base32, y el valor de salida son los 6 dígitos de este mismo instante. Si lo ejecutas otra vez 30 segundos después, el valor cambia. Con las bibliotecas estándar hmac y hashlib de Python también puedes escribir estos cinco pasos en pocas líneas.

Vamos a comprobarlo con nuestra herramienta gratuita, el Generador y probador de TOTP / OTP (2FA).

Generador y probador de TOTP / OTP (2FA)

Sin registro y desde el navegador: genera la clave Base32 y el código QR, y comprueba al instante el token de 6 dígitos que se renueva cada 30 segundos.

Los puntos que más confunden

"Si cambio el emisor o la cuenta, el número cambiará también." No. Como vimos, los 6 dígitos se definen solo por la clave secreta y la hora. Si resumimos otra vez la función de los tres campos, queda así.

CampoFunción¿Influye en los 6 dígitos?
Clave secreta Base32Único material secreto del cálculo (llave)Sí
Emisor (Issuer)Etiqueta del servicio que aparece en la lista de la appNo
Cuenta (Account)Etiqueta que distingue de qué cuenta se trataNo

"El número no deja de ser incorrecto." La causa más frecuente es un desfase horario. El contador se obtiene dividiendo entre 30 la hora UTC del dispositivo; si el reloj del móvil se aleja del servidor decenas de segundos o más, cada uno usa un contador distinto y salen números distintos. Algunos servidores de validación toleran un pequeño margen hacia delante y hacia atrás, pero si la diferencia es grande, al final no coincide.

"Metí la clave secreta y me da error." Es el caso de haber introducido caracteres que no existen en Base32. Base32 usa solo de la A a la Z y del 2 al 7, así que si se cuelan un 0, un 1, un 8, un 9 o caracteres especiales, el proceso se bloquea en el paso de decodificación. Las diferencias de mayúsculas y minúsculas o los espacios suelen corregirse automáticamente, pero los caracteres que no existen no se pueden recuperar.

CategoríaCaracteres
Caracteres que usa Base32A~Z, 2~7
Caracteres que no usa (dan error)0, 1, 8, 9 y caracteres especiales

"¿Por qué cambia cada 30 segundos?" Porque el contador es "la hora ÷ 30, el cociente". En el momento en que se cruza el intervalo de 30 segundos, el cociente sube 1 y, como el contador cambia, el resultado de HMAC y los 6 dígitos cambian por completo. La barra de la pantalla muestra los segundos que quedan hasta que termine el intervalo actual.

En resumen

  • Los 6 dígitos no los envía el servidor: se calculan. Solo hay dos ingredientes: la clave secreta y la hora UTC actual.
  • El procedimiento estándar tiene cinco pasos. Decodificar Base32 → convertir la hora en un contador de 30 segundos → HMAC-SHA1 → truncamiento dinámico → resto de dividir entre 1.000.000.
  • Solo cambian el número la clave secreta y la hora. El emisor y la cuenta son etiquetas que no entran en el cálculo.
  • El código QR es una línea de URI otpauth://, y el valor que se usa de verdad dentro de ella es secret.
  • Las causas de que no coincida suelen ser dos. Un desfase del reloj del dispositivo o caracteres que no existen en Base32.

La herramienta de abajo, el Generador y probador de TOTP / OTP (2FA), ejecuta estos cinco pasos en el navegador en tiempo real y, en el momento en que introduces la clave secreta, te muestra juntos el código QR, los 6 dígitos y el tiempo restante.

Generador y probador de TOTP / OTP (2FA)

Sin registro y desde el navegador: genera la clave Base32 y el código QR, y comprueba al instante el token de 6 dígitos que se renueva cada 30 segundos.

Preguntas frecuentes

¿Puedo comprobar solo el código de 6 dígitos sin registrarlo en una app?

Sí. Con la clave secreta Base32 correcta, el navegador hace el cálculo HMAC-SHA1 ahí mismo y te muestra los 6 dígitos del ciclo de 30 segundos. No envía la clave a ningún servidor: el cálculo ocurre en la propia pantalla.

¿Por qué el número coincide exactamente con el de otros dispositivos y con el del servidor?

Porque TOTP usa como material únicamente la clave secreta fija y el tiempo universal coordinado (UTC), que es común en todo el mundo. Con la misma clave y el mismo intervalo de 30 segundos, el resultado del cálculo es el mismo. Por eso, si la sincronización horaria entre dispositivos falla, los números dejan de coincidir.

¿Puede la clave secreta tener minúsculas o espacios?

Normalmente sí. En el procesamiento estándar las minúsculas se pasan a mayúsculas y los espacios se eliminan antes de decodificar. Ahora bien, si se incluye un carácter que no existe en Base32, como 0, 1, 8 o 9, se produce un error en ese paso.

¿Sirve el número que apareció justo antes de que pasaran los 30 segundos?

Cuando se cruza el intervalo, el contador cambia y el número también. Aun así, muchos servidores de validación están diseñados para aceptar durante un momento el número del intervalo inmediatamente anterior, así que a veces la validación pasa aunque el intervalo haya cambiado mientras lo escribías. El margen de tolerancia varía según el servidor.

Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano

Artículos relacionados

  1. Conversión de escape Unicode: \uXXXX, U+ y entidades HTMLAprende a convertir texto a \uXXXX, U+ y entidades HTML y a deshacerlo, con ejemplos de hangul y emojis y el motivo por el que un emoji se parte en dos.
  2. Normalizar URL: quitar utm y obtener el enlace canónicoAprende qué reglas sigue la normalización de URL: cómo se eliminan los parámetros utm_, fbclid, gclid y ref, y cómo leer la lista de cambios aplicados.
  3. Codificación URL: por qué el espacio se convierte en %20Por qué el espacio se convierte en %20 y cada letra coreana en %EA%B0%80, cuándo usar encodeURI o encodeURIComponent y cómo evitar la doble codificación.
  4. Extraer segmentos de ruta de una URL y convertirlos en rutasAprende cómo se divide una URL en protocolo, host, segmentos y query, por qué solo las barras reciben índice y cuándo un segmento pasa a :param o [param].
  5. Codificación URL: qué es el percent encoding y sus reglasDescubre por qué la URL no admite espacios ni texto no ASCII, cómo funciona el percent encoding y en qué se diferencian encodeURI y encodeURIComponent.
  6. User-Agent: estructura del encabezado y simulación de botsAprende cómo se compone la cadena User-Agent, cómo detectar navegador, móvil o bot con regex y Client Hints, y cómo probarlo sin dispositivos reales.

Herramientas relacionadas