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:Authorization con el esquema ApiKey:
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
- Navegue a console.truthlocks.com/api-keys
- Haga clic en “Crear clave de API”.
- Ingrese un nombre descriptivo (por ejemplo, “Backend de Producción”)
- Seleccione el entorno (producción o sandbox) y los alcances requeridos
- Copie la clave inmediatamente — no se mostrará de nuevo
Vía API
Request
Response
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: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.- Confirme su contraseña local actual de Truthlocks.
- Escanee el código QR privado o ingrese la clave de configuración en su autenticador como una cuenta basada en tiempo.
- Ingrese el código de seis dígitos de la aplicación para habilitar la MFA.
- 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.
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.

