Skip to main content
Sign in →

Pasaporte de agente

Un certificado de seguridad firmado criptográficamente por agente — postura de seguridad en tiempo real, estado de cumplimiento y permisos de herramientas en una URL compartible.

¿Qué es un Pasaporte de agente?

Cada agente supervisado por ShieldAgent recibe un Pasaporte de agente — un documento en vivo y firmado que describe la postura de seguridad del agente. Incluye la puntuación de riesgo actual y el nivel, las herramientas que el agente tiene permitidas y bloqueadas, la cobertura del marco de cumplimiento y un historial completo de bloqueos y eventos.

Los pasaportes se emiten automáticamente en minutos tras la primera actividad del proxy. No se requiere configuración.

Niveles de visibilidad

Cada pasaporte tiene uno de tres niveles de visibilidad:

NivelQuién puede verloCaso de uso
PrivadoNadie fuera de tu equipoPor defecto — mientras configuras o revisas
InternoCualquier usuario autenticado en tu inquilinoRevisión del CISO y el equipo de seguridad antes de aprobar el agente
PúblicoCualquiera con la URLCompartir con clientes, socios, reguladores; insertar insignias

Solo los usuarios con los permisos de administración adecuados pueden publicar un pasaporte públicamente. Cualquier administrador del equipo puede publicarlo internamente.

Proceso de verificación

ShieldAgent verifica la identidad del agente a través de un proceso de verificación de múltiples pasos. Cada pasaporte refleja la postura de seguridad verificada del agente, incluyendo lo que tiene permitido hacer, la puntuación de riesgo actual y la cobertura de cumplimiento. Su equipo puede revisar los pasaportes directamente desde el panel antes de decidir si compartirlos.

01El agente se conecta a través de ShieldAgent
02El pasaporte se genera automáticamente
03Su equipo revisa el pasaporte en el panel
04Opcionalmente comparta el pasaporte públicamente

Obtener un pasaporte

Los pasaportes públicos son accesibles sin autenticación:

bash
curl https://shieldagent.io/passport/pa_9c3f2a

Respuesta (resumida)

json
{
  "id": "pa_9c3f2a",
  "agentName": "Apex Procurement Agent",
  "organization": "Meridian Financial Group",
  "riskScore": 18,
  "tier": "normal",
  "visibility": "public",
  "toolsAllowed": ["erp.vendor.read", "erp.po.create_draft", ...],
  "toolsBlocked": ["erp.vendor.write", "erp.payment.approve", ...],
  "frameworks": [
    { "name": "SOC 2 Type II", "status": "compliant" },
    { "name": "ISO 27001", "status": "compliant" },
    { "name": "GDPR Article 25", "status": "partial" }
  ],
  "verificationId": "shld_v1_9c3f2a_0419T142233Z",
  "publicKeyFingerprint": "SHA256:zR9Fx2K4mQpLvJ3eNdWhUcBiYsOgAT8EH6KRl5X1P0=",
  "certExpires": "2026-10-21",
  "lastVerified": "2026-04-21T14:22:33Z"
}

Verificación criptográfica

Los pasaportes están firmados con Ed25519. Cualquiera puede verificar un pasaporte de forma independiente sin confiar en los servidores de ShieldAgent — útil para auditores, socios y comprobaciones de cumplimiento automatizadas.

bash
# Download the public key
curl https://shieldagent.io/passport/public-key > shieldagent.pub

# Verify a passport
curl https://shieldagent.io/passport/pa_9c3f2a > passport.json
shieldagent verify --passport passport.json --key shieldagent.pub

El ID de verificación (verificationId) y la huella de la clave pública se incluyen en cada respuesta del pasaporte. El SDK gestiona la verificación automáticamente.

Insignias integrables

Integra una insignia de confianza en vivo en cualquier página HTML, README de GitHub o sitio de documentación. La insignia SVG refleja el nivel de certificación actual y enlaza al pasaporte público completo.

html
<!-- Basic embed -->
<img
  src="https://shieldagent.io/badge/pa_9c3f2a.svg"
  alt="ShieldAgent Certified"
/>

<!-- With link to passport -->
<a href="https://shieldagent.io/passport/pa_9c3f2a">
  <img
    src="https://shieldagent.io/badge/pa_9c3f2a.svg"
    alt="ShieldAgent Certified — view passport"
  />
</a>

Formato de URL de la insignia

https://shieldagent.io/badge/{passportId}.svg

La insignia se actualiza automáticamente cuando cambia el nivel de riesgo. No se aplica caché CDN — la respuesta siempre está actualizada.

Publicación mediante API

bash
# Publish internally (team review)
curl -X POST https://api.shieldagent.io/passports/pa_9c3f2a/publish \
  -H 'Authorization: Bearer <your-api-key>' \
  -H 'Content-Type: application/json' \
  -d '{ "visibility": "internal" }'

# Publish publicly (requires appropriate permissions)
curl -X POST https://api.shieldagent.io/passports/pa_9c3f2a/publish \
  -H 'Authorization: Bearer <your-api-key>' \
  -H 'Content-Type: application/json' \
  -d '{ "visibility": "public" }'

Relacionado

Pasaporte de agente