Skip to main content
Sign in →
REST API

Autenticación

ShieldAgent utiliza autenticación mediante token Bearer para todas las solicitudes de API y proxy. El acceso al proxy usa un JWT de agente generado en el panel, y las operaciones de gestión usan una clave API de administración separada.

Tipos de token

JWT de agenteJWT (eyJ…)

Uso: Autenticar solicitudes al proxy MCP. Limitado a un único agente dentro de un tenant. Se genera y rota desde el panel.

Obtener: Panel → Agentes → [tu agente] → Claves → Copiar token

Clave API de administraciónToken opaco

Uso: Gestionar tenants, agentes, políticas y registros de auditoría mediante la API REST.

Obtener: Panel → Configuración → Claves API → Nueva clave

Realizar solicitudes autenticadas

Incluye el token en la cabecera Authorization . Copia el JWT de agente desde Panel → Agentes → [tu agente] → Claves.

Los ejemplos de SDK se han retirado. Para integrar ShieldAgent, usa la referencia OpenAPI.

Rotación de claves

Rota las claves de agente sin tiempo de inactividad usando el patrón de solapamiento de dos claves:

  1. 1.Genera una nueva clave — la clave antigua permanece activa.
  2. 2.Actualiza la configuración de tu agente para usar la nueva clave.
  3. 3.Verifica que la nueva clave funciona en la pestaña Eventos del panel.
  4. 4.Revoca la clave antigua.

Respuestas de error

401Cabecera Authorization ausente o con formato incorrecto
403Clave válida pero permisos insuficientes para esta operación
429Límite de tasa superado — consulta la cabecera Retry-After

Siguiente

Referencia OpenAPI

Especificación completa de la API REST

Referencia de la API REST

Catálogo de endpoints navegable

Autenticación