Aduana Digital de Defensa Argentina
Criar acesso ADDA
← Manual ADDA

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

Integrações e SDK

Primeiros percursos para conectar sensores, receber sinais e consumir a leitura ADDA.

O manual de integrações mostra como conectar sensores, consultas de confiança, evidence e módulos de reputação usando uma referência compartilhada.

Uma boa integração não termina quando o endpoint responde. Também exige validar formato, governança, rastreabilidade e como a nova fonte afeta tasks, incidents, automations e o manual vivo.

Use este guia para transformar uma conexão técnica em uma capacidade operacional real dentro do ADDA.

Checklist

  • • Registrar sensor ou domínio antes de habilitar a ingestão produtiva.
  • • Testar a leitura de confiança e o registro de evidence com casos controlados.
  • • Documentar erros frequentes por integração.

Início rápido

  1. 1. Registre primeiro a fonte ou o domínio a integrar.
  2. 2. Teste um fluxo mínimo end-to-end antes de considerar a integração pronta.
  3. 3. Se a integração deixar uma dúvida recorrente, transforme-a em manual candidate.

Fluxo operacional

Conectar

Cadastrar o sensor, a fonte ou o módulo que enviará sinais.

Definir a identidade técnica e operacional da integração.

Validar

Verificar se eventos, scores ou evidence saem em formato útil para o ADDA.

Confirmar se a leitura realmente entra no fluxo correto.

Transformar em produto

Vincular a integração a docs, manual, tasks ou automations quando aplicável.

Evitar integrações isoladas do restante do produto.

flowchart LR
  S1["Conectar"]
  S2["Validar"]
  S3["Transformar em produto"]
  S1 --> S2
  S2 --> S3

Validadores e verificações

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

Validar percurso da integração

Resume artigos e próximos passos para onboarding técnico-operacional.

Exemplos

Evento mínimo para ingestão

{
  "type": "sensor.alert",
  "source": "adda-agent-demo",
  "severity": "yellow",
  "summary": "Se detecta actividad anómala en endpoint observado."
}

Problemas frequentes

  • • Conectar uma fonte sem validação operacional costuma produzir mais ruído que cobertura.
  • • Não documentar erros frequentes faz a equipe repetir diagnósticos.

Ações sugeridas

  • • Transforme a integração em produto com quickstarts, exemplos e rotas visíveis.
  • • Eleve a manual candidate qualquer lacuna recorrente de onboarding.

Reason codes úteis

Dicionário de score

severity

Prioridade institucional do sinal na escala ADDA.

action

Próximo passo operacional recomendado pelo motor.

reasonCodes

Motivos explicáveis que justificam a leitura.

Notas do protocolo

  • • Uma integração pronta entra nos fluxos operacionais, não apenas na API.

Histórico do artigo

9 de jul. de 2026

O artigo foi ampliado com quickstart de integração e exemplo de ingestão.