# Khaos Katana Operations

> Crawl one authorized seed URL at low rate to expand a provenance-backed endpoint inventory, including links and client-side references.

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

---


# 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=recon` ou `stage=enumeration`. Criar task com `role=recon`/`stage=recon` ou `role=enumeration`/`stage=enumeration`.
- **Estado do assessment:** deve estar em `executing_stage`.
- **Timeout:** o crawl pode durar 60–180s. Use `TimeoutSec ≥ 240` no cliente HTTP ou execute via `Start-Job` para evitar encerramento prematuro da conexão.

## 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":   "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-Job` ou 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.

