Saltar al contenido principal

Autorización de Agente

Cada agente de IA en la plataforma Truthlocks opera bajo un estricto modelo de autorización. Los agentes deben estar registrados, tener alcances asignados y crear sesiones con límite de tiempo antes de poder realizar cualquier acción.

Flujo de autorización

Todos los endpoints de autorización de agentes —ámbitos, sesiones y herramientas— tienen un API playground interactivo. Abra cualquier endpoint en la referencia de la API Sesiones y Herramientas de Agente y haga clic en Enviar para probarlo contra el Sandbox.

Modelo de alcance

Los alcances siguen un patrón jerárquico resource:action. Cuando un agente solicita una sesión, solo puede solicitar los alcances que se le asignaron en el registro.

Definición de ámbitos personalizados

Ámbitos incorporados

Gestión de sesiones

Las sesiones proporcionan contextos de ejecución con límite de tiempo con caducidad automática y lista de permitidos de IP opcional.

Creación de una sesión

Respuesta:

Ciclo de vida de la sesión

Finalizar una sesión

Registro e invocación de herramientas

Los agentes pueden registrar las herramientas que exponen e invocar herramientas registradas por otros agentes (sujeto a comprobaciones de alcance).

Registrar una herramienta

Invocar una herramienta

Cada invocación de herramienta es:
  1. Alcance verificado: la sesión debe tener el alcance requerido.
  2. Con límite de velocidad: según la cuota de invocación de herramientas de su plan.
  3. Registrado en auditoría — entrada/salida completa registrada en el registro de auditoría
  4. Medido — contado contra sus derechos de facturación

Mejores prácticas de seguridad

Nunca incruste tokens de sesión en el código del lado del cliente. Los tokens de sesión otorgan el alcance completo de la sesión y deben tratarse como secretos.
  1. Principio de privilegio mínimo: Solicite solo los alcances necesarios para la tarea actual.
  2. Sesiones de corta duración: Utilice el TTL más corto posible (predeterminado: 1 hora).
  3. Lista de IP permitidas — Restringir sesiones a rangos de red conocidos
  4. Rotar credenciales — Regenerar las claves de firma del agente en un horario regular
  5. Monitorear puntuaciones de confianza — Configure alertas cuando las puntuaciones de confianza caigan por debajo de los umbrales
  6. Use el interruptor de emergencia — Revoque inmediatamente los agentes comprometidos

Próximos pasos

Políticas MAIP

Reglas de aplicación en tiempo de ejecución basadas en puntuaciones de confianza, alcances y profundidad de delegación.

Puntuaciones de Confianza

Evaluación continua de la confianza conductual para los agentes.

Delegación entre inquilinos

Permitir que los agentes actúen a través de los límites organizacionales.