Saltar al contenido principal
Truthlocks admite múltiples métodos de autenticación para asegurar el acceso a la API. Esta guía cubre las claves API, los tokens JWT y las mejores prácticas de seguridad.

Métodos de autenticación

Claves API

Credenciales de larga duración para comunicación de servidor a servidor. Recomendado para servicios de backend.

Tokens de portador (JWT)

Tokens de corta duración para usuarios autenticados. Ideales para aplicaciones frontend y contexto de usuario.

Claves de API

Truthlocks tiene dos tipos de claves API según cómo utilice la plataforma:

Pasando su clave

Incluya su clave API utilizando cualquiera de estos encabezados:
También puede usar el encabezado Authorization con el esquema ApiKey:
Estos formatos autentican los puntos finales habilitados con clave API. Algunas operaciones requieren un token de portador de usuario y comprobaciones de rol; los puntos finales de salud pública no necesitan ninguno. X-API-Key es más común en los ejemplos a lo largo de esta documentación.

Claves API de inquilino

Las claves de inquilino son el método de autenticación principal para las organizaciones que utilizan Truthlocks. Están limitadas a un inquilino y admiten permisos granulares.

Estructura clave

Alcances

Las claves API de inquilino se pueden restringir a permisos específicos:
Principio de privilegio mínimo: Conceda solo los alcances que su aplicación realmente necesita. Una clave con solo attestations:mint no debería tener también users:write.

Creación de una clave de inquilino

Vía consola

  1. Navegue a console.truthlocks.com/api-keys
  2. Haga clic en “Crear clave de API”.
  3. Ingrese un nombre descriptivo (por ejemplo, “Backend de Producción”)
  4. Seleccione el entorno (producción o sandbox) y los alcances requeridos
  5. Copie la clave inmediatamente — no se mostrará de nuevo

Vía API

Request
Response
Crítico: El campo secret se devuelve solo una vez en el momento de la creación. Almacene inmediatamente en un gestor de secretos.

Claves de API de consumidor

Las claves de consumidor permiten a los usuarios individuales acceder a las API de protección y verificación de forma programática, por ejemplo, para acuñar atestaciones desde una canalización de CI o integrar la protección de contenido en sus propias herramientas.

Detalles clave

  • Cada cuenta admite hasta 5 claves activas.
  • Las claves caducan automáticamente después de 90 días.
  • Las claves revocadas o caducadas no se pueden reactivar; cree una nueva en su lugar.

Ámbitos fijos

Las claves de consumidor se emiten con un conjunto fijo de alcances que no se pueden personalizar:

Creación de una clave de consumidor

1

Abrir configuración

En la barra lateral del portal de verificación, ve a Configuración > Claves de API.
2

Crear una clave

Haga clic en Crear clave API, ingrese un nombre descriptivo y confirme. El completo el secreto se muestra una vez; cópielo y guárdelo de forma segura.
3

Usar la clave

Pasa la clave en el encabezado X-API-Key con cada solicitud:
Para obtener detalles completos sobre la gestión de claves de consumidor, consulte la guía del portal del consumidor.

Tokens de portador (JWT)

Los tokens JWT se utilizan cuando necesita realizar llamadas a la API en nombre de un usuario autenticado, como desde una aplicación web o móvil.

Uso de tokens de portador

Estructura del token

Vida útil del token

MFA de autenticador para cuentas de Console

En Console, abra Configuración → Seguridad → Autenticador MFA para conectar Google Authenticator u otra aplicación de autenticación basada en tiempo.
  1. Confirme su contraseña local actual de Truthlocks.
  2. Escanee el código QR privado o ingrese la clave de configuración en su autenticador como una cuenta basada en tiempo.
  3. Ingrese el código de seis dígitos de la aplicación para habilitar la MFA.
  4. Guarde los diez códigos de recuperación que se muestran después de la confirmación. Se muestran una vez, y cada código funciona una vez.
Los nuevos inicios de sesión requieren el segundo factor después de su contraseña o de su proveedor de identidad empresarial. El paso de verificación expira después de cinco minutos. Los códigos incorrectos repetidos bloquean temporalmente la verificación de la cuenta. Un código que ya ha sido aceptado no puede ser reutilizado. Para reemplazar los códigos de recuperación o deshabilitar la MFA, confirme su contraseña y un código de autenticador nuevo o un código de recuperación no utilizado. Reemplazar los códigos de recuperación invalida el conjunto anterior. Los usuarios de SSO que nunca hayan establecido una contraseña local de Truthlocks pueden usar el flujo de restablecimiento de contraseña para su correo electrónico registrado antes de la inscripción. La inscripción de MFA se aplica a su propia cuenta. No inscribe a otros miembros ni impone un requisito de MFA en todo el espacio de trabajo. Habilitar MFA no revoca automáticamente las sesiones existentes. Las claves de API siguen siendo credenciales de sistema separadas.

Mejores prácticas de seguridad

✅ Usar gestión de secretos

Almacene las claves API en Google Secret Manager, HashiCorp Vault o similar. Nunca claves codificadas en el código de la aplicación.

✅ Rotar claves regularmente

Cree nuevas claves y revoque las antiguas periódicamente. Use nombres descriptivos con fechas (por ejemplo, “Backend-2026-Q1”).

✅ Restringir ámbitos

Concede solo los permisos que realmente se necesiten. Revisa y audita los alcances de las claves regularmente.

❌ Nunca exponer en el frontend

Las claves de API nunca deben incluirse en JavaScript del lado del cliente. Utilice tokens JWT para autenticación frontend.

❌ Nunca confirmar en Git

Utilice variables de entorno o gestión de secretos. Añada .env* a .gitignore.

Próximos pasos

Portal del consumidor

Gestiona claves de API de consumidor, protecciones y configuraciones.

Entornos

Configuración de sandbox vs. producción y URLs base.

RBAC y permisos

Comprenda los roles, permisos y control de acceso.

Registros de auditoría

Rastree toda la actividad de la API y los eventos de seguridad.