Saltar para o conteúdo principal
Este guia explica os blocos de construção fundamentais da plataforma Truthlocks. Compreender esses conceitos é essencial para uma integração eficaz.

Inquilinos

Um inquilino é a unidade organizacional de nível superior na Truthlocks. Cada inquilino representa um cliente ou organização distinto com isolamento completo de dados.

Controles de multi-tenancy

  • Isolamento de Dados: Os dados de cada locatário são completamente isolados no nível do banco de dados
  • Limites de Recursos: Limites de taxa e cotas são aplicados por inquilino
  • Escopo da Chave de API: As chaves de API são vinculadas a um único locatário e não podem acessar dados de outros locatários
  • Separação de Auditoria: Os logs de auditoria são particionados por locatário

Emissores

Um emissor é uma entidade que pode criar e assinar atestados. Os emissores representam organizações, instituições ou serviços que fazem reivindicações sobre assuntos.

Identidade

Cada emissor tem um domínio verificado (por exemplo, acme.edu) que estabelece sua identidade do mundo real.

Chaves Criptográficas

Os emissores registram chaves públicas Ed25519 usadas para verificar assinaturas de atestação.

Status de Confiança

Novos emissores são ativados imediatamente após a criação. Níveis de confiança mais altos exigem uma revisão da aplicação: ATIVO → SUSPENSO.

Nível de Confiança

BÁSICO, VERIFICADO ou PREMIUM com base na profundidade da verificação de identidade.

Ciclo de vida do emissor

Novos emissores são ativados imediatamente com o nível de confiança Básico. Nenhuma aprovação manual é necessária para começar a emitir atestados. Para atualizar para um nível de confiança superior (Organização Verificada, Entidade Governamental ou Instituição Acreditada), envie uma solicitação de emissor para revisão.

Atestados

Um atestado é uma reivindicação criptograficamente assinada feita por um emissor sobre um assunto. Atestados são o primitivo central do sistema Truthlocks.

Estrutura de Atestado

Propriedades de Atestado

Proteções ao consumidor

Uma proteção ao consumidor é um atestado criado através do fluxo simplificado de cunhagem do consumidor, projetado para criadores individuais. Você faz o hash do seu arquivo no lado do cliente (SHA-256) e envia o hash junto com metadados como título, categoria e tipo de conteúdo. A Truthlocks provisiona sua identidade de assinatura automaticamente no primeiro uso. A resposta de cunhagem do consumidor inclui: Cada proteção gera uma página de prova pública. Qualquer pessoa pode buscar os metadados da página de prova via GET /v1/public/proof/{attestation_id} — nenhuma autenticação é necessária. Este endpoint é projetado para renderizar páginas de prova e gerar prévias de links do Open Graph para URLs compartilhadas. Consulte o endpoint de metadados de prova para detalhes.

Sinais de risco

Um sinal de risco é uma observação pontuada de uma fonte de detecção de fraude — impressão digital do dispositivo, reputação de IP, verificação de e-mail, análise de documentos ou seu próprio motor de regras. Você pode ingerir sinais diretamente via API ou enviar eventos de identidade brutos e deixar a plataforma normalizá-los em sinais automaticamente. Cada sinal inclui:

Normalização de eventos

Em vez de construir sinais de risco manualmente, você pode enviar eventos de identidade brutos — logins falhos, assinaturas inválidas, suspeitos de deepfake — para POST /v1/risk/events. A plataforma mapeia cada evento para um tipo de sinal canônico e pontuação de risco base automaticamente. Consulte a referência da API de normalização de eventos de identidade. Os sinais de risco são totalmente isolados por inquilino usando segurança em nível de linha e formam a base do Firewall de Identidade Antifraude. Consulte o guia de sinais de risco para detalhes de integração.

Agentes de máquina

Um agente de máquina é um agente de IA, bot ou serviço automatizado registrado com o Protocolo de Identidade de Agente de Máquina (MAIP). Cada agente recebe um identificador único (maip-agent:<ulid>) e um par de chaves Ed25519 para assinar recibos. Os agentes operam dentro de sessões — contextos de execução de curta duração, com escopo limitado e expiração automática. Cada ação que um agente realiza gera um recibo criptograficamente assinado que se encadeia ao recibo anterior para trilhas de auditoria à prova de adulteração. Nove tipos de recibo cobrem todo o ciclo de vida do agente: gênese, delegação, ação, revogação, atestado de dados, atestado de modelo, conformidade, reivindicação de verdade e verificação. Consulte o guia de identidade da máquina para configuração e o guia de autorização do agente para o modelo de escopo e sessão.

Pacotes de prova

Um pacote de prova é um pacote autocontido que inclui tudo o necessário para verificar um atestado offline, sem contatar os servidores da Truthlocks.
Caso de Uso: Pacotes de prova são ideais para cenários onde os verificadores podem estar offline ou deseja verificar independentemente sem chamadas de API.

Modelo de Verificação

A verificação Truthlocks verifica várias camadas para determinar se um atestado deve ser confiável:
1

Verificação Criptográfica

Verifique se a assinatura Ed25519 corresponde à carga útil usando a chave pública do emissor. chave.
2

Verificação de Status

Verifique se a atestação foi revogada ou substituída pelo emissor. Atestações substituídas se vinculam ao seu substituto via superseded_by_attestation_id.
3

Status de Confiança do Emissor

Confirme se o emissor está no status ATIVO e não suspenso.
4

Validade da Chave

Verifique se a chave de assinatura estava ativa no momento da criação do atestado.

Próximos passos

Ambientes

Saiba mais sobre ambientes de desenvolvimento vs. produção e configuração.

Autenticação

Aprofunde-se em chaves de API, tokens JWT e integração OAuth.