Operação do ffuf no Khaos
O repositório upstream não apresentou skill oficial de uso. O wrapper atual substitui FUZZ apenas no caminho da URL (<base>/FUZZ), usa saída JSON em stdout, uma thread, uma taxa de 1 req/s e timeout de request definido. Não assume suporte a POST, headers ou fuzz de parâmetros neste fluxo.
Pré-condições obrigatórias
- Stage da task: ffuf é permitido em
stage=enumerationoustage=fuzzing. Criar task com o mesmo valor emroleestage(ex:role=enumeration,stage=enumeration). - Wordlist: selecione via
wordlist_idum wordlist registrado no sistema (ex:zinnes-api-paths,common-api-paths). Não use wordlists de credenciais ou payloads de injeção. - Estado do assessment: deve estar em
executing_stage.
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": "ffuf",
"title": "ffuf discovery: <base-url>/FUZZ"
}}
3. POST /assessments/{id}/operator/events
{"event": "action_decision", "data": {
"action_id": "<mesmo-uuid>",
"task_id": "<taskId>",
"owner": "<owner>",
"tool_id": "ffuf",
"allowed": true
}}
4. POST /tools/ffuf/run
{"target_id": "<id>", "assessment_id": "<id>",
"endpoint_url": "<base-url>/FUZZ",
"wordlist_id": "<wordlist-id>",
"execute": true, "confirm": true,
"action_id": "<mesmo-uuid>", "task_id": "<taskId>", "owner": "<owner>"}
O placeholder
FUZZdeve aparecer literalmente naendpoint_url. O wrapper não aceitaFUZZem posições de parâmetro, header ou body.
Comportamento e resultados
- Escolha uma wordlist de paths/arquivos compatível com a etapa. Não use wordlist de credenciais, tokens ou payloads.
- Comece em um prefixo observado e autorizado. Confira baseline de 404/soft-404 antes de classificar status, tamanho ou redirect como rota real.
- Guarde JSONL bruto, hash, versão, lista/revisão e contagem de linhas. Deduplique por caminho e valide candidatos com uma requisição individual de baixo impacto.
- Pare em 401/403 repetido, 429, timeout, mudança de estado ou escopo negado. Não aumentar workers nem remover atraso para compensar falta de sinal.
Limite de produto: a etapa do agente aplica truncamento de wordlist. Use lista de teste pequena nessa rota até o limite ser aplicado centralmente.
Interpretação dos resultados
| Status HTTP | Interpretação |
|---|---|
| 200 + tamanho consistente | Rota real — validar individualmente |
| 301/302 | Redirect — seguir e validar destino |
| 401/403 | Rota existe mas requer auth — registrar como candidato |
| 404 + tamanho variável (soft-404) | Ignorar — checar baseline primeiro |
| 429 | Rate limit — parar imediatamente |
Referência: ffuf/ffuf/README.md no commit 8d65e0373e5f223530174e5694285af849770078; a sintaxe real do Khaos vem de wrappers.Build.