# Khaos Dalfox Operations

> Use Dalfox only on an observed, in-scope parameterized endpoint; interpret its bounded Khaos adapter output as an XSS candidate that still needs context-appropriate validation.

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

---


# Operação do Dalfox no Khaos

O Dalfox upstream oferece mais modos do que o wrapper restrito do Khaos. Aqui, não trate a skill oficial como autorização para chamar flags livres.

## Pré-condições obrigatórias

- **Stage da task:** dalfox é permitido em `stage=exploitation`, `stage=vuln` ou `stage=validation`. Para criação de task, use `role=exploitation` e `stage=exploitation` (ou `role=vuln`/`stage=vuln`).
- **Endpoint:** URL observada com query string e parâmetro real. Raiz sem parâmetros é rejeitada pelo adapter.
- **Estado do assessment:** deve estar em `executing_stage`.
- Hipótese XSS ligada ao parâmetro/localização, evidência de origem e orçamento ativo confirmado.

## 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":   "dalfox",
     "title":     "dalfox XSS scan: <endpoint>?<param>=<value>"
   }}

3. POST /assessments/{id}/operator/events
   {"event": "action_decision", "data": {
     "action_id": "<mesmo-uuid>",
     "task_id":   "<taskId>",
     "owner":     "<owner>",
     "tool_id":   "dalfox",
     "allowed":   true
   }}

4. POST /tools/dalfox/run
   {"target_id": "<id>", "assessment_id": "<id>",
    "endpoint_url": "<url-com-query-string>",
    "execute": true, "confirm": true,
    "action_id": "<mesmo-uuid>", "task_id": "<taskId>", "owner": "<owner>"}
```

## O que o wrapper executa

O adapter usa o modo `url`, JSON, somente PoC refletida, um worker e atraso de 1s. Usa `xss_safe.txt` (canários inertes), timeout de 3s por request. Passa explicitamente os parâmetros da query observada, pula descoberta/mineração e BAV, encerra após um candidato.

Esta é uma triagem de reflexão — não prova execução de JavaScript; não cobre XSS armazenado, DOM completo ou callbacks blind.

## Interpretar sem superafirmar

| Resultado | Interpretação |
|---|---|
| Saída vazia | Sem sinal neste endpoint/parâmetro/perfil — não ausência de XSS |
| Candidato positivo | Preservar URL/parâmetro; confirmar encoding/contexto no browser |
| Timeout / WAF / resposta instável | Lacuna distinta — registrar separadamente |
| Erro de entrada | URL sem query string provavelmente rejeitada |

- Confirme encoding/contexto e execução observável por validator/browser compatível.
- Mantenha controle negativo (sem payload) e não use impacto presumido.
- Para XSS armazenado, DOM ou blind — use outra abordagem; dalfox Khaos não cobre.

## Limites

Não enviar ao Dalfox: URL adivinhada, todos os endpoints sem priorização, dados de terceiros, callback inventada. Não aumentar workers, remover atraso, habilitar outros modos.

## Referência e adaptação

Baseado na skill oficial `hahwul/dalfox`, commit `f9d61ef46a3adefb09f74f84b249d3ff5bcbebfe` (MIT). Conteúdo reescrito para documentar o subconjunto implementado e o fluxo de execução correto via API REST do Khaos.

