Skip to content
VeriSwarm
Sobre
DocumentaçãoPreçosHabilidade do agente
EntrarCadastrar
  1. Início
  2. /Learn
  3. /Verifiable agent identity
VeriSwarm
  • English
  • Español
  • Deutsch
  • Français
  • Italiano
  • ✓ Português
  • 日本語
  • 한국어
  • 简体中文

Produto

  • Preços
  • Documentação
  • API
  • Habilidade do agente
  • Especificação OATS

Confiança

  • Central de confiança
  • Segurança
  • Conformidade
  • Status
  • Changelog

Empresa

  • Sobre
  • Blog
  • Código aberto
  • Investidores
  • Imprensa

Jurídico

  • Termos
  • Privacidade
  • SLA
  • DPA
  • Acessibilidade
Guia técnico

Identidade verificável de agentes, sem necessidade de blockchain

Seu agente não precisa de um NFT nem de um DID em uma chain para provar quem ele é. Uma credencial JWT assinada com ES256 e um endpoint JWKS publicado permitem que qualquer terceiro verifique offline a identidade de um agente de IA, com a mesma criptografia de chave pública que já protege o HTTPS — sem carteira, sem consulta à chain e sem taxa de gas.

O que significa identidade verificável de um agente

A identidade verificável de um agente é uma afirmação criptograficamente verificável sobre a identidade de um agente de IA — estabelecida por meio de uma credencial assinada e uma chave pública publicada — que um terceiro pode confirmar sem precisar retornar à plataforma emissora e sem confiar na palavra do requerente. A própria credencial carrega a prova; a verificação acontece localmente, offline, em relação a uma chave que o verificador já obteve.

Por que os resultados de busca para essa pergunta estão cheios de blockchain

Pesquise "identidade verificável de agente de IA" e a maior parte do que aparece pressupõe uma chain: registros de agentes ERC-8004, identificadores descentralizados (DIDs), reputação on-chain, credenciais vinculadas a NFT. É uma escolha de design legítima — ela compra resistência à censura e uma proveniência pública e permanente que nenhuma empresa sozinha pode revogar. Não é a única escolha, e para a maioria das equipes em produção não é a primeira que resolve o problema real que têm pela frente: a plataforma do outro lado consegue confirmar, agora mesmo, que esse agente é quem diz ser, sem consultar uma chain?

O VeriSwarm Passport responde a isso com verificação de chave pública baseada em padrões e offline — JSON Web Tokens (JWTs) assinados com ES256 e um endpoint JWKS. É a mesma primitiva criptográfica por trás do OAuth e do HTTPS, aplicada à identidade de agentes em vez de sessões web. Sem chain para sincronizar, sem carteira para financiar, sem smart contract para auditar.

Como funciona: solicitar, assinar, carregar, verificar

O ciclo de vida da credencial tem quatro etapas, e nenhuma delas exige uma chamada síncrona de volta ao VeriSwarm depois da primeira busca da chave.

1. Solicitação

O agente se autentica com sua chave de API de agente e chama POST /v1/credentials/issue.

2. Assinatura

O VeriSwarm carrega o snapshot de confiança mais recente do agente, monta um payload JWT e o assina com a chave privada ES256 da plataforma (kid: "veriswarm-2026").

3. Transporte

O agente inclui a credencial assinada em requisições de saída, handshakes ou negociações de capacidade com outros agentes ou plataformas.

4. Verificação

A parte receptora busca a chave pública do VeriSwarm em GET /.well-known/jwks.json e verifica a assinatura e a expiração localmente — nenhuma chamada de API é necessária depois que a chave é armazenada em cache.

O ciclo de vida completo, exemplos de código em Python e Node, e o esquema exato das claims estão em Agent Passports: confiança portátil que acompanha seu agente para onde ele for.

O que há dentro da credencial

O JWT usa o algoritmo ES256 com um cabeçalho de ID de chave. As claims padrão mais um namespace veriswarm carrega a postura de confiança em tempo real do agente — não apenas uma afirmação estática de identidade.

ClaimSignificado
issEmissor — sempre https://api.veriswarm.ai
subAssunto — o ID exclusivo do agente
iat / expEmissão e expiração — 1-hour TTL
veriswarmPontuações por dimensão, confiança composta, nível de política, faixa de risco, confiança de calibração, status de verificação e um link para o perfil público do agente

Como a afirmação de identidade e a postura comportamental viajam no mesmo objeto assinado, uma parte confiável obtém as duas coisas em uma única verificação — a identidade do agente e se ele é confiável o suficiente no momento para receber uma tarefa.

Identidade não é a resposta completa

Provar quem um agente é responde a apenas uma das duas perguntas que importam para uma decisão de acesso. A segunda — se esse agente está se comportando de um jeito que justifique manter seu acesso agora — é uma pergunta separada e continuamente atualizada que uma credencial de identidade estática, apoiada em blockchain ou não, não consegue responder sozinha. Essa distinção, e o motivo pelo qual confundir as duas é o que faz a governança de agentes falhar em produção, é o tema de Identidade x confiança para agentes de IA. Esta página é o guia prático para a metade da identidade; aquele guia é o argumento de por que a identidade sozinha nunca seria suficiente.

Onde a identidade verificável mais importa: agente a agente

O caso de uso mais claro para identidade verificável offline é a transferência entre agentes, em que não há tempo para uma pessoa revisar uma credencial antes que uma tarefa seja delegada. A implementação do protocolo A2A do VeriSwarm usa exatamente esse modelo de credenciais para permitir que um agente avalie outro antes de confiar a ele uma tarefa — os detalhes desse mecanismo estão em Segurança do protocolo A2A: por que Agent Cards não são confiança.

Perguntas frequentes

Preciso de blockchain ou de um DID para dar ao meu agente uma identidade verificável?

Não. A identidade de agente baseada em blockchain (ERC-8004, identificadores descentralizados, passaportes on-chain) é uma abordagem válida, construída para resistência à censura e proveniência on-chain. Mas a maioria das equipes não precisa consultar uma chain para responder «esse é realmente o agente que ele diz ser?». O VeriSwarm Passport usa JWTs assinados com ES256 verificados contra um endpoint JWKS publicado — a mesma criptografia de chave pública que já protege HTTPS e OAuth, sem carteira, sem taxa de gas e sem chain para sincronizar.

O que realmente torna a identidade de um agente «verificável»?

Uma afirmação é verificável quando um terceiro consegue confirmá-la sem confiar na palavra de quem a fez e sem precisar retornar a uma autoridade central a cada verificação. O VeriSwarm assina a credencial de cada agente com uma chave privada ES256; a chave pública correspondente é publicada em um endpoint JWKS. Qualquer um — uma plataforma parceira, um marketplace, outro agente — pode buscar essa chave pública uma vez, armazená-la em cache e verificar localmente cada credencial seguinte.

Como funciona de fato a verificação ES256 JWT + JWKS?

Quatro etapas. O agente solicita uma credencial ao VeriSwarm usando sua chave de API de agente. O VeriSwarm assina um JWT contendo a identidade e o estado de confiança atual do agente com sua chave privada ES256. O agente carrega esse JWT em requisições de saída ou handshakes. A parte receptora busca a chave pública do VeriSwarm em /.well-known/jwks.json, faz a correspondência do ID da chave no cabeçalho do JWT e verifica a assinatura offline — nenhuma chamada de rede ao VeriSwarm é necessária depois da busca inicial da chave.

O que realmente há dentro de uma credencial do Passport?

Claims JWT padrão — emissor, assunto (o ID do agente), data de emissão e uma expiração de uma hora — mais um namespace veriswarm que carrega as pontuações por dimensão, o nível de política, a faixa de risco, a confiança de calibração e o status de verificação do agente. Não é apenas uma afirmação de identidade; é uma afirmação de identidade com uma postura comportamental ao vivo anexada, que é justamente a parte que um DID puro ou uma credencial NFT não carregam.

De qual plano eu preciso para emitir credenciais verificáveis?

Nenhum — a emissão básica de credenciais ES256, a verificação offline e o endpoint JWKS são gratuitos e ilimitados em todos os planos, incluindo o Free. A pontuação de confiança subjacente incorporada em cada credencial é calculada pelo Gate, que também é gratuito, com ingestão ilimitada de eventos. O produto de identidade mais completo do Passport — manifestos assinados, escopos de delegação e fluxos manuais de verificação de identidade — está disponível a partir do plano Pro; a credencial em si não exige isso.

Em que isso é diferente das credenciais de cliente OAuth ou da identidade de máquina (SPIFFE, mTLS)?

Os sistemas OAuth e de identidade de máquina foram criados para serviços com identificadores estáveis e credenciais de longa duração, verificadas ao retornar a um emissor. As credenciais do Passport são de curta duração (1 hora), carregam uma pontuação comportamental ao vivo em vez de uma afirmação de papel estática, e são projetadas para serem verificadas offline por uma parte que não tem relação prévia com o VeriSwarm. Use identidade de máquina para sua camada de serviço a serviço; use uma credencial do Passport para a camada de agente a agente acima dela.

Dê ao seu agente uma identidade que ele possa provar

A emissão de credenciais ES256, a verificação offline e o endpoint JWKS público são gratuitos e ilimitados em todos os planos. Escopos de delegação e manifestos assinados — o produto Passport mais completo — estão disponíveis a partir do Pro. A pontuação de confiança de cada credencial é calculada pelo Gate, que também é gratuito.

Experimente a demoComece grátis