trustapi/1.1.0 · atualizado em 9 de jul. de 2026

Índice de confiança e automação

Como identificar se uma visita parece humana, automatizada ou coordenada e definir o próximo passo.

O índice de confiança reúne em um só lugar a leitura de IP, domínio, sessão ou campanha. Ele apoia o critério humano com motivos explícitos e uma ação sugerida.

A leitura do score não substitui a decisão do operador: ela a orienta. Os reason codes esclarecem por que um caso parece benigno, misto ou arriscado e ajudam a escalonar para verificação, limitação, watchlist ou Evidence.

Quando o mesmo padrão aparece em mais de uma superfície, o score melhora se usado com incidents, tasks, Access, Mail, WAF ou Intel.

Checklist

• Comparar a leitura de automação com as de sessão e domínio.
• Confirmar se a ação recomendada corresponde à severidade.
• Registrar contribuições se os motivos não explicarem a decisão.

Início rápido

1. Leia severity, action e reason codes como uma única frase operacional.
2. Cruze o score com o módulo afetado antes de bloquear por padrão.
3. Em casos sensíveis, leve a leitura para um incident, task ou Evidence.

Fluxo operacional

Consultar

Obtenha uma leitura de IP, domínio, sessão ou campanha.

Usar o tipo de score mais adequado ao caso.

Explicar

Converta os reason codes em critérios compartilhados para a equipe.

Alinhar a linguagem técnica e operacional.

Decidir

Conecte a ação sugerida ao módulo que realmente executará a medida.

Não tratar o score como se fosse a própria ação.

flowchart LR
  S1["Consultar"]
  S2["Explicar"]
  S3["Decidir"]
  S1 --> S2
  S2 --> S3

Validadores e verificações

Executam uma leitura contextual desta superfície e devolvem passos sugeridos com foco operacional.

Validar leitura da TrustAPI

Resume artigos, checks e próximos passos sobre score e explicação.

Exemplos

Payload para score de sessão

{
  "sessionId": "sess_ops_001",
  "domain": "login.capacero.ar",
  "ip": "198.51.100.18"
}

Links e referências

Rotas relacionadas

BotRadar no console TrustAPI pública

APIs

/api/adda/v1/trust/score
/api/adda/v1/score/ip
/api/adda/v1/score/domain

Docs e rotas de apoio

docs/ADDA_API.md
docs/ADDA_PROTOCOLO.md

Problemas frequentes

• Tratar a ação sugerida como ordem automática sem revisar o módulo afetado.
• Não registrar motivos quando o sinal é misto impede uma revisão posterior.

Ações sugeridas

• Usar Copilot e Manual quando o score não for suficiente para justificar a ação.
• Escalonar para Evidence se a leitura levou a bloqueio, revogação ou contenção forte.

Reason codes úteis

BOT_HIGH

A automação estimada é alta para o contexto analisado.

Aplicar verificação ou limitação progressiva.

GEO_ANOMALY

A origem ou o percurso esperado não são consistentes.

Cruzar com Access, DNS ou incident antes de confiar.

SESSION_RISK

A sessão apresenta características que merecem acompanhamento próximo.

Revisar a continuidade e os controles da sessão ou do dispositivo.

Dicionário de score

severity

Prioridade institucional do sinal na escala ADDA.

action

Próximo passo operacional recomendado pelo motor.

reasonCodes

Motivos explicáveis para justificar a leitura.

Notas do protocolo

• O score ganha valor quando se conecta a uma superfície concreta de resposta.

Histórico do artigo

9 de jul. de 2026

O glossário e o percurso operacional do score foram ampliados.