Referência da API/Endpoints
Testes de controlo
POST /control-tests
Regista um teste de controlo. Aceita chave de API ou sessão; a sessão exige permissão para criar testes de controlo.
Para um teste com verificação automática, envie checkDefinition (e, nos tipos que dependem de uma integração, integrationId):
{
"controlId": "<id do controlo>",
"result": "NOT_TESTED",
"integrationId": "<id da integração WAZUH>",
"checkDefinition": { "kind": "wazuh_sca_rule", "params": { "pattern": "ssh", "minSeverity": "HIGH" } }
}
O servidor valida o tipo, os parâmetros e a integração exigida. Se a verificação for válida, o teste fica AUTOMATED (o type enviado é ignorado). Se for inválida, a resposta é 400 com error: "Validation error" e a mensagem em details.checkDefinition.
kind |
Integração exigida | Parâmetros (intervalo, valor por omissão) |
|---|---|---|
gws_admins_2sv |
GOOGLE_WORKSPACE |
nenhum |
authentik_mfa_enrolment |
AUTHENTIK |
nenhum |
wazuh_sca_failed |
WAZUH |
nenhum |
wazuh_sca_rule |
WAZUH |
pattern (obrigatório, até 200 caracteres), minSeverity (HIGH ou CRITICAL, por omissão HIGH) |
backup_coverage |
BACKUP_REPORT |
nenhum |
alert_delivery_configured |
SLACK (procurada automaticamente) |
nenhum |
policies_approved |
nenhuma | nenhum |
risk_methodology_in_use |
nenhuma | minRisks (1 a 1000, 5) |
vendor_assessments_current |
nenhuma | days (30 a 1095, 365) |
assets_criticality_classified |
nenhuma | passPct (1 a 100, 90), partialPct (0 a 99, 50) |
awareness_program_active |
nenhuma | days (30 a 1095, 365) |
restore_test_recency |
nenhuma | days (30 a 1095, 365), titleContains (obrigatório, por omissão restauro) |
devices_encrypted |
nenhuma (módulo de IT) | passPct (1 a 100, 100), partialPct (0 a 99, 90) |
devices_checkin_recent |
nenhuma (módulo de IT) | days (1 a 365, 30), passPct (1 a 100, 100), partialPct (0 a 99, 90) |
Os dois últimos tipos medem o parque de equipamento (dispositivos ASSIGNED, IN_STOCK e RETURN_PENDING): cifragem desconhecida conta como não cifrado e, sem dispositivos ativos, o resultado é FAIL. A evidência (ITOPS) lista as máquinas que falham.
Em breveEsta página estará disponível em breve.