Administração do módulo Compliance
Habilite avaliações de estruturas, revise lacunas, crie regras vinculadas, registre atestações e exporte evidências.
O módulo Compliance mostra quais controles técnicos da instalação AIFW podem ser comprovados. Lê configuração de regras ativa, avalia estruturas selecionadas, registra lacunas e atestações e gera relatórios de evidências.
O módulo é separado do mecanismo de regras: o mecanismo aplica políticas ao tráfego; Compliance avalia a configuração e reporta o resultado. Uma lacuna não é decisão de tráfego.
O módulo Compliance não é aconselhamento jurídico, certificação nem substituto de controles organizacionais. Consulte fontes primárias e confirme aplicabilidade com profissionais qualificados.
Habilitar o módulo#
Abra AI Firewall -> Agent Config -> Compliance. A seção fica disponível quando habilitada. Desligada, nenhuma avaliação ou tarefa agendada roda e o item de navegação Compliance fica oculto.
| Configuração | Padrão | Significado |
|---|---|---|
| Enable the compliance module (ai_fw_compliance_enabled) | Off | Liga/desliga avaliações e geração de evidências. |
| Frameworks (compliance_frameworks_enabled) | Nenhum selecionado | Estruturas avaliadas, salvas como lista separada por vírgulas. |
| Report schedule (compliance_report_schedule) | weekly | off, daily, weekly ou monthly. |
| Assessment interval (minutes) | 1440 | Frequência, de 15 a 10080 minutos. |
| Evidence retention (days) | Configuração de implantação | Retenção; UI aceita 30 a 3650 dias. |
| Raise drift events | Configuração de implantação | Registra alteração de regra que afeta controle avaliado. |
| Attestation expiry (days) | Configuração de implantação | Validade da atestação manual; 1 a 3650 dias. |
Revisar a página Compliance#
Após habilitar o módulo, abra Compliance na barra lateral. A página mostra estruturas gerenciadas, controles avaliados, lacunas abertas e score de postura, ou Not measured antes da primeira avaliação.
Use Run assessment para avaliar o escopo selecionado. Estados vazios são explícitos; página vazia não significa aprovação.
Gerenciar estruturas e controles#
A tabela de estruturas mostra estado, quantidade de controles, lacunas e score. Use Enable e Disable para alterar quais estruturas são gerenciadas.
| Filtro | Uso |
|---|---|
| Status | Ver conformidade, lacunas, desconhecidos e outros resultados. |
| Severity | Priorizar controles de maior impacto. |
| Mandatory | Separar controles obrigatórios dos complementares. |
Cada controle mostra requisito, severidade, estado, regra vinculada, atestação e evidência. Regra ausente ou desabilitada é lacuna, não aprovação.
Criar e vincular regra#
Quando uma estrutura oferece rule pack, escolha Control e Template, informe Pattern or keywords e selecione Create and link. O módulo fornece direção, ação e severidade esperadas. A regra é criada habilitada e vinculada; revise o padrão antes de produção.
Registrar atestação#
Quando uma obrigação exige decisão humana, use Attest e informe sua base. A atestação registra responsável, vencimento e nota opcional. Use Withdraw quando deixar de ser válida. Atestações vencidas ou retiradas não contam como controles comprovados.
Interpretar resultados#
| Resultado | Significado |
|---|---|
| Compliant | O controle configurado passa nas verificações. |
| Unknown | Não foi possível verificar configuração ou cobertura de identidade. |
| GapMissing | Regra ou controle esperado ausente. |
| GapDisabled | Regra existe, mas está desabilitada. |
| GapMisconfigured | Regra não corresponde à configuração esperada. |
| AttestationExpired | Atestação humana obrigatória venceu. |
Inventário de regras ilegível resulta em unknown, não em inventário vazio.
Evidências e drift#
Relatórios por estrutura podem ser exportados em JSON ou CSV. Incluem estado de controles e regras, configurações relevantes, retenção e evidências de inventário; não incluem conteúdo de prompts ou respostas.
Com Raise drift events, alterações em regras vinculadas registram controle afetado, alteração e responsável. Execute outra avaliação após corrigir drift.
Pré-requisito de identidade A2A#
Controles por identidade exigem tráfego de agente autenticado. Se a2a_auth_mode estiver off, Compliance informa o requisito e marca controles afetados UNKNOWN, não conformes. Habilite A2A em AI Firewall -> Agent Config -> Access & Identity.