Los Tokens de API de Analítica Son Credenciales, No Identificadores
Un token de API concede acceso a datos. Trátalo como un secreto con ciclo de vida: muéstralo una vez, almacena un verificador, limita sus permisos y facilita su revocación.
Un token de API no es una etiqueta para un usuario o sitio. Es una credencial: quien obtenga un token válido puede actuar como su titular. Tratarlo como identificador hace que aparezca en registros, URL, capturas de soporte y configuraciones permanentes que nadie sabe revocar con seguridad.
Las mejores prácticas de seguridad de OAuth 2.0 de la IETF, publicadas en enero de 2025, actualizan el modelo de amenazas y las recomendaciones para despliegues OAuth. Un token personal de API no tiene por qué ser un token de acceso OAuth, pero se aplica el mismo principio: las credenciales basadas en posesión deben protegerse en tránsito, restringirse al servicio previsto y limitarse a los permisos necesarios.
Muestra el secreto una sola vez
Genera tokens con una fuente criptográficamente segura y suficiente entropía para impedir intentos prácticos de adivinación. Devuelve el token completo solo al crearlo; después, almacena un prefijo no secreto para identificarlo y un verificador unidireccional para buscarlo más adelante. Si se copia la base de datos, un verificador es más seguro que una credencial reutilizable en texto claro. No trates un hash genérico como un hash de contraseñas: los tokens de API deben tener alta aleatoriedad, mientras que las contraseñas humanas necesitan una función de hash deliberadamente lenta.
Deja claro en la interfaz y la respuesta de la API que el token se muestra una sola vez. Cuando el usuario abandone la pantalla de creación, ofrece revocarlo y emitir otro en lugar de recuperar el secreto original. Nunca incluyas tokens en parámetros de consulta, URL, eventos de analítica, informes de errores ni capturas de pantalla. Las URL acaban en el historial del navegador, referentes, registros de proxy y solicitudes de soporte con más facilidad que los encabezados de autorización.
Envía la credencial por el canal adecuado
Para las API HTTP, acepta los tokens en el encabezado Authorization a través de TLS. RFC 6750 describe los tokens bearer como utilizables por cualquiera que los posea y advierte que su exposición durante el almacenamiento o el transporte permite un uso indebido. También desaconseja incluir credenciales bearer en parámetros de consulta URI, porque las URL suelen quedar registradas. Rechaza tokens en cadenas de consulta y cuerpos de petición, salvo que un protocolo requiera otro transporte y exista un modelo de amenazas documentado.
En el servidor, valida el token antes de procesar la operación. Resuelve su titular y permisos desde almacenamiento confiable; no aceptes como autoridad un usuario o propietario de sitio incluido en la petición. Mantén los secretos fuera de logs de aplicación, trazas y mensajes de excepción. Si hace falta correlacionar operaciones, registra el ID o prefijo no secreto del token, nunca la credencial.
Limita, caduca y revoca
Un token debe conceder el conjunto mínimo de permisos útiles. Si el producto lo permite, deja que el usuario limite el token a sitios concretos y a operaciones de lectura o específicas. No concedas acceso de escritura a toda la cuenta a un script de automatización que solo necesita obtener un informe. Las mejores prácticas de seguridad de OAuth tratan la restricción de privilegios y audiencia de los tokens; sirven como referencia de diseño aunque una API use su propio formato opaco.
Ofrece caducidad y revocación como controles esenciales. Las vidas útiles más cortas reducen el tiempo durante el que una credencial filtrada sigue siendo útil; la revocación responde a incidentes y cambios de personal o integración. Si la rotación necesita un periodo de solapamiento, limita su duración e indica qué token está activo. La revocación debe aplicarse en el límite de la API, no limitarse a ocultar el token en el panel.
En la API programática de Monoid, los tokens mnd_live_… creados por los usuarios son opacos, se devuelven en texto claro una sola vez y se almacenan como hashes SHA-256 con caducidad opcional y revocación lógica. Este diseño protege el valor original ante una lectura de la base de datos, pero no vuelve inocuo un token activo filtrado. No lo incluyas en el control de versiones, la salida de CI, los bundles del navegador ni el historial compartido del terminal; si sospechas que se ha expuesto, emite otro y revoca el anterior.
Haz que el ciclo de vida se pueda probar
Prueba el flujo completo: crear, usar con los permisos previstos, rechazar un token inválido o caducado, revocarlo y confirmar que deja de funcionar. Verifica que un token no pueda cruzar cuentas o sitios y que todos los endpoints apliquen las mismas reglas de autenticación y autorización. Añade comprobaciones operativas para que los logs oculten credenciales y las respuestas de la API nunca devuelvan el token almacenado.
El ciclo de gestión de secretos incluye creación, control de acceso, rotación, auditoría y revocación, no solo almacenamiento seguro. Un token de API sigue protegido únicamente si el sistema identifica a su titular, limita lo que puede hacer, detecta la exposición sin registrar el secreto y puede desactivarlo enseguida.
Comments
Loading comments…