Operação do Katana no Khaos
O upstream não contém uma skill oficial de operação pertinente; este guia usa o README fixado e o contrato local.
O adapter rastreia a URL inicial com profundidade 2, concorrência/paralelismo 1, limites HTTP/globais de 1 req/s e saída JSONL. Sua finalidade é enumerar links e superfícies observadas; não envia payloads de vulnerabilidade.
Pré-condições obrigatórias
- Stage da task: katana é permitido em
stage=reconoustage=enumeration. Criar task comrole=recon/stage=reconourole=enumeration/stage=enumeration. - Estado do assessment: deve estar em
executing_stage. - Timeout: o crawl pode durar 60–180s. Use
TimeoutSec ≥ 240no cliente HTTP ou execute viaStart-Jobpara evitar encerramento prematuro da conexão.
Fluxo correto de execução via API REST
CRÍTICO: O evento
action_decisiondeve contertask_id,owneretool_id— além deaction_ideallowed:true. Omitir qualquer campo retorna erro 400.
1. POST /assessments/{id}/operator/tasks/{taskId}/claim
{"owner": "<owner>", "lease_seconds": 180}
2. POST /assessments/{id}/operator/events
{"event": "action_proposed", "data": {
"action_id": "<uuid-novo>",
"task_id": "<taskId>",
"owner": "<owner>",
"tool_id": "katana",
"title": "katana crawl: <seed-url>"
}}
3. POST /assessments/{id}/operator/events
{"event": "action_decision", "data": {
"action_id": "<mesmo-uuid>",
"task_id": "<taskId>",
"owner": "<owner>",
"tool_id": "katana",
"allowed": true
}}
4. POST /tools/katana/run
{"target_id": "<id>", "assessment_id": "<id>",
"endpoint_url": "<seed-url>", "execute": true, "confirm": true,
"action_id": "<mesmo-uuid>", "task_id": "<taskId>", "owner": "<owner>"}
O backend pode fechar a conexão HTTP antes de completar o crawl. O resultado fica persistido no assessment independentemente. Para evitar erro de timeout no cliente, use
Start-Jobou curl com--max-time 300.
Comportamento e saída
- Execute somente após o host e seed passarem pelo gate de escopo. Cada URL extraída herda a necessidade de nova validação; JS, redirect ou link externo não amplia o target.
- Normalize e deduplique método/URL/parâmetros. Preserve a referência do documento/JS de origem e o artefato JSONL.
- Checkpoint nativo: o Katana retoma crawl interrompido usando checkpoint em
KHAOS_DATA_DIR. Duas execuções seguidas sem novos caminhos encerram como parcial. - Crawl sem endpoint novo é
no_signal, não falha do produto. Timeout, bloqueio, robots/login ou SPA exigem estado específico. - Não aumente profundidade/concurrency para "forçar cobertura".
Integração com outros tools
| Depois do Katana | Como usar |
|---|---|
| ffuf | Use paths descobertos como wordlist base para content discovery |
| httpx | Confirme status atual de cada endpoint listado |
| dalfox/sqlmap | Use URLs com parâmetros como alvos para XSS/SQLi |
| nuclei | Feed de URLs observadas para template scan |
Referência: projectdiscovery/katana/README.md no commit 3e650646252e4a763d0fc230aff8bf96a3d86303; o adapter Khaos define o perfil efetivo.