# Khaos Ffuf Operations

> Use ffuf for bounded content discovery from an approved wordlist and observed in-scope base URL; treat responses as route candidates, not vulnerabilities.

- Skill: `henriqqw/khaos-ffuf-operations` (Agent Skill)
- Install (CLI): `npx get-skill add henriqqw/khaos-ffuf-operations`
- Raw SKILL.md: https://api.skillmd.com/api/skills/henriqqw/khaos-ffuf-operations/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: henriqqw (https://skillmd.com/u/henriqqw)
- Updated: 2026-11-18
- Page: https://skillmd.com/skills/henriqqw/khaos-ffuf-operations

---


# 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=enumeration` ou `stage=fuzzing`. Criar task com o mesmo valor em `role` e `stage` (ex: `role=enumeration`, `stage=enumeration`).
- **Wordlist:** selecione via `wordlist_id` um 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_decision` deve conter `task_id`, `owner` e `tool_id` — além de `action_id` e `allowed: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 `FUZZ` deve aparecer literalmente na `endpoint_url`. O wrapper não aceita `FUZZ` em posições de parâmetro, header ou body.

## Comportamento e resultados

1. Escolha uma wordlist de paths/arquivos compatível com a etapa. Não use wordlist de credenciais, tokens ou payloads.
2. Comece em um prefixo observado e autorizado. Confira baseline de 404/soft-404 antes de classificar status, tamanho ou redirect como rota real.
3. 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.
4. 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`.

