Skip to main content
Sign in →

Configuración del proxy de API

Configura ShieldAgent como un proxy REST transparente con políticas por endpoint y registro de auditoría.

Cómo funciona el proxy REST

Además del proxy MCP, ShieldAgent puede interceptar llamadas REST de API realizadas por agentes a servicios externos (Stripe, Slack, microservicios internos, etc.). Cada solicitud es autenticada, verificada por políticas y registrada en auditoría antes de reenviarse.

Agente──▶ShieldAgent Proxy :$PROXY_PORT──▶API externa
verificación auth·eval. política·escritura auditoría·límite de tasa

Registrar un endpoint de API

Indica a ShieldAgent qué endpoints externos pueden alcanzar tus agentes:

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

Configurar el agente para usar el proxy

Los agentes realizan llamadas REST a ShieldAgent en lugar de a la API externa directamente. ShieldAgent reenvía las solicitudes autenticadas tras la evaluación de políticas.

El agente realizando una llamada REST proxificada
# Instead of calling Stripe directly:
# curl https://api.stripe.com/v1/charges -H 'Authorization: Bearer sk_live_...'

# The agent calls the ShieldAgent proxy:
curl https://proxy.shieldagent.io/rest/stripe-charges \
  -H 'Authorization: Bearer <agent-key>' \
  -H 'Content-Type: application/json' \
  -d '{"amount": 2000, "currency": "usd", "source": "tok_..."}'

Políticas por endpoint

Aplica restricciones a nivel de método sobre el registro de endpoints:

policy — block DELETE on stripe-charges
{
  "tenantId": "<tenant-id>",
  "agentId": "<agent-id>",
  "toolName": "rest:stripe-charges",
  "action": "deny",
  "conditions": [
    {
      "type": "param_contains",
      "param": "method",
      "value": "DELETE"
    }
  ]
}

Filtrado de respuestas y DLP

ShieldAgent escanea las respuestas en busca de patrones de datos sensibles (PII, secretos, números de tarjeta) antes de devolverlas al agente. Configura reglas DLP por tenant:

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

Registro de auditoría para llamadas REST

Cada solicitud REST proxificada se registra en el registro de auditoría inmutable con metadatos completos de solicitud/respuesta:

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

Campos del registro de auditoría

agentId
tenantId
toolName (rest:<endpoint-name>)
method
statusCode
durationMs
policyDecision
timestamp
merkleHash
Configuración del proxy de API