Como verificar credenciais de agentes de IA: um guia técnico em português

Introdução

Este é um guia técnico para desenvolvedores falantes de português que querem implementar verificação de credenciais em agentes de IA. Vamos cobrir:

1. Os 8 formatos de credenciais que existem hoje
2. Como o pipeline de 12 etapas funciona
3. Como integrar o UTA no seu código

Os 8 formatos

1. JWT (JSON Web Token)

Padrão IETF RFC 7519. O mais comum. Estrutura: header.payload.signature.

{
  "alg": "EdDSA",
  "typ": "JWT",
  "kid": "did:web:alice.example#key-1"
}
{
  "iss": "did:web:alice.example",
  "sub": "agent:bob",
  "exp": 1735689600,
  "scope": "read:files"
}

2. W3C Verifiable Credential

Padrão W3C. Mais rico que JWT — suporta claims estruturadas e proof chains.

{
  "@context": ["https://www.w3.org/2018/credentials/v1"],
  "type": ["VerifiableCredential"],
  "issuer": "did:web:alice.example",
  "credentialSubject": {
    "id": "did:agent:bob",
    "scope": "read:files"
  },
  "proof": {
    "type": "Ed25519Signature2020",
    "verificationMethod": "did:web:alice.example#key-1",
    "proofValue": "..."
  }
}

3. MCP Server Card

Especificação Anthropic MCP. Para servidores MCP que precisam declarar suas capacidades.

4. A2A Card

Protocolo Google A2A (Agent-to-Agent). Para agentes que falam diretamente com outros agentes.

5. ATC v3 (Agent Trust Card)

Formato proposto pela AliceLabs. Otimizado para agentes de IA — campos como model, provider, tool_scope.

6. EAT-AI

Entity Attestation Token (IETF RATS). Para atestar propriedades de dispositivos e sistemas.

7. ZTA Card

Zero Trust Agent Card. Variante focada em ambientes zero-trust.

8. X.509

O bom e velho certificado ITU-T. Ainda presente em todos os lugares.

O pipeline de 12 etapas

UTA processa cada credencial através destas etapas:

PARSER → DETECT → SCHEMA → CRYPTO → ISSUER → KEY_BINDING
       → POP → PROVENANCE → LIFECYCLE → EVIDENCE → POLICY → DECISION

Cada etapa:

1. PARSER: converte bytes para estrutura interna
2. DETECT: identifica o formato
3. SCHEMA: valida campos obrigatórios
4. CRYPTO: verifica a assinatura criptográfica
5. ISSUER: resolve a identidade do emissor
6. KEY_BINDING: verifica que a chave usada está vinculada ao emissor
7. POP: proof of possession — quem apresenta possui a chave privada?
8. PROVENANCE: traça a origem da credencial
9. LIFECYCLE: verifica vigência (not_before, expires_at, revocation)
10. EVIDENCE: coleta evidência para auditoria
11. POLICY: aplica políticas específicas do sistema
12. DECISION: emite o veredicto final

Integração no seu código

JavaScript/TypeScript

npm install @marketnow/trust-core

import { verify } from '@marketnow/trust-core';

const result = await verify(card);

switch (result.decision) {
  case 'PERMIT':
    // credencial válida, pode executar
    break;
  case 'DENY':
    console.error(`Negada em ${result.failed_stage}: ${result.reason}`);
    break;
  case 'UNDETERMINED':
    // não foi possível determinar — requer revisão humana
    break;
}

Python (adapter)

pip install marketnow-trust

from marketnow_trust import verify

result = verify(card)
if result.decision == 'PERMIT':
    execute_tool()
else:
    log_failure(result.failed_stage)

API REST

curl -X POST https://www.marketnow.site/api/trust?action=verify \
  -H "Content-Type: application/json" \
  -d '{"card": "..."}'

Benchmarks

• 6.744 verificações/segundo (single core)
• Latência p99: 2.1ms
• Latência p50: 0.15ms
• 480+ testes em Node.js, 16 em Python, 23 property tests

Casos de uso

Caso 1: Agente que invoca MCP servers

Antes de invocar um MCP server, verifique a credencial dele:

const result = await verify(mcpServerCard);
if (result.decision !== 'PERMIT') {
  throw new Error(`MCP server não confiável: ${result.failed_stage}`);
}
// agora sim, invoque
await mcpServer.callTool('read_file', { path: '/etc/passwd' });

Caso 2: Bridge entre ecosistemas

Você tem um agente JWT-only e quer falar com um agente W3C VC-only:

const w3cCard = await translate(jwtCard, 'W3C_VC');
await sendToAgent(w3cCard);

Caso 3: Revogação em tempo real

const result = await verify(card);
if (result.stages.LIFECYCLE === 'REVOKED') {
  // issuer revogou — bloqueie imediatamente
  blockAgent();
}

Conclusão

Verificação de credenciais não é opcional em agentes de IA de produção. UTA te dá uma camada única que suporta os 8 formatos relevantes hoje.

Se você é dev brasileiro ou português trabalhando com IA, contribua — seja com código, traduções, ou casos de uso.

Repo: alicelabs-llc/universal-trust-adapter · API: marketnow.site/api/trust