# Khaos Proxy Evasion

> Configure rotating proxy pools to bypass WAF rate-limiting for external-operator assessments.

- Skill: `henriqqw/khaos-proxy-evasion` (Agent Skill)
- Install (CLI): `npx get-skill add henriqqw/khaos-proxy-evasion`
- Raw SKILL.md: https://api.skillmd.com/api/skills/henriqqw/khaos-proxy-evasion/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-proxy-evasion

---


# khaos-proxy-evasion — Proxy Pool & WAF Bypass

**Stage:** recon, enumeration, authentication, authorization, fuzzing, exploitation, validation
**Requires:** active assessment with `executing_stage`, authorization plan com `proxy_pool_ids`

---

## Quando usar

Use este skill quando:
- O alvo usa Cloudflare, AWS WAF, Akamai ou outro WAF com rate-limiting por IP
- Ferramentas automatizadas (katana, gobuster, ffuf) retornam 403/429 após poucas requisições
- A enumeração manual é necessária porque as tools automatizadas foram bloqueadas
- Você precisa escalar o volume de requisições sem triggerar circuit-breakers

---

## Configuração do Proxy Pool

### 1. Adicionar proxies ao CustomConfig da assessment

Configure os proxies em `custom_config.proxy_pool` antes de iniciar a assessment (ou enquanto ela está `pending`/`paused`):

```json
{
  "proxy_pool": [
    {
      "id": "dataimpulse-br-sp",
      "label": "DataImpulse BR São Paulo",
      "host": "gw.dataimpulse.com",
      "port": "824",
      "username": "USER__cr.br;state.saopaulo;city.saopaulo",
      "password": "ENCRYPTED_PASSWORD"
    }
  ]
}
```

**Atenção:** a senha deve ser criptografada via `POST /api/v1/assessments/{id}/secrets/encrypt` antes de salvar no CustomConfig. O campo `username` suporta parâmetros geo do DataImpulse (semicolons são aceitos; o Khaos faz URL-encoding automático).

### 2. Atualizar o Authorization Plan

Ao definir o plano de autorização, inclua os IDs do proxy pool e ative o bootstrap:

```json
{
  "authorized_by": "operador",
  "authorization_summary": "Teste com proxy rotativo para bypass de rate-limit do Cloudflare.",
  "allow_anonymous_requests": true,
  "allowed_methods": ["GET", "POST", "OPTIONS"],
  "allowed_action_classes": ["safe", "active", "passive"],
  "proxy_pool_ids": ["dataimpulse-br-sp"],
  "proxy_rotation": "round_robin",
  "bootstrap_seed_endpoint": true,
  "max_requests": 2000,
  "rate_limit_per_second": 2,
  "expires_at": "2026-10-31T23:59:00Z"
}
```

**`bootstrap_seed_endpoint: true`** — promove a URL base do alvo como endpoint verificado para GET, resolvendo o problema de bootstrap sem precisar rodar uma tool de crawl primeiro.

**`proxy_rotation`** — `round_robin` (padrão) ou `random`. Com um único proxy, ambos funcionam igual.

---

## Bootstrap de Endpoints Verificados

### O problema

`runOperatorHTTPRequest` exige `endpoint.Verified == true`. O endpoint semente (base URL do alvo) sempre começa como `Verified: false`. Sem um endpoint verificado, não há como fazer a primeira requisição via backend do Khaos.

### Solução 1: `bootstrap_seed_endpoint: true` (recomendado)

Com esta flag no plano de autorização, a URL base do alvo é automaticamente tratada como verificada para GET. Calcule o `endpoint_id` assim:

```
endpoint_id = SHA256("GET|" + base_url)[:24]
```

Exemplo para `https://hsc.tl7.fun/`:
```
endpoint_id = SHA256("GET|https://hsc.tl7.fun/")[:24] = "0fa5532707cd1d449ca1cda5"
```

### Solução 2: Rodar katana antes

Se o proxy pool estiver configurado, katana roda sem ser bloqueado. Mesmo recebendo 403, o Khaos marca o URL como verificado (status HTTP 100–599 = verified). Após o run do katana, use `runOperatorHTTPRequest` normalmente.

---

## Bypass de WAF com Proxy Pool

### Fluxo de requisições

Todas as chamadas `runOperatorHTTPRequest` e runs de ferramentas com proxy configurado seguem:

```
Khaos Backend → Proxy Externo (IP rotativo) → Alvo
```

O Cloudflare vê o IP do proxy, não o IP do Khaos.

### Rate limits e cadência

Mesmo com proxy rotativo, respeite a cadência:
- Configure `rate_limit_per_second: 2` no plano para Cloudflare agressivo
- Use `max_requests: 2000` para orçamento generoso
- O Khaos aplica `rate_limit_per_second` via `operatorRequestRateAvailable` antes de cada requisição

### DataImpulse: parâmetros geo

O DataImpulse permite geolocalização via username. Formato:
```
USER__cr.COUNTRY;state.STATE;city.CITY
```

Exemplos:
- Brasil genérico: `USER__cr.br`
- São Paulo: `USER__cr.br;state.saopaulo;city.saopaulo`
- EUA Nova York: `USER__cr.us;state.newyork;city.newyork`

Use o país/cidade do alvo para maximizar chance de bypass — alvos regionais muitas vezes têm regras mais permissivas para tráfego local.

---

## Checklist Operacional

### Antes de começar

- [ ] Proxy pool configurado em `custom_config.proxy_pool` com senha criptografada
- [ ] Authorization plan com `proxy_pool_ids`, `bootstrap_seed_endpoint: true` e `rate_limit_per_second` ajustado
- [ ] `expires_at` no futuro
- [ ] Assessment em `executing_stage`
- [ ] Task válida com `http_request` em `tool_ids` e lease ativa

### Bootstrap (primeira requisição)

```json
POST /api/v1/assessments/{id}/operator/http-request
{
  "task_id": "...",
  "owner": "claude-codex-operator-v1",
  "endpoint_id": "0fa5532707cd1d449ca1cda5",
  "method": "GET",
  "profile_id": "anonymous"
}
```

Após este GET retornar (qualquer status), o endpoint `/` estará no contexto como verificado via `addPersistedOperatorHTTPEndpoints`, desbloqueando todos os demais endpoints derivados.

---

## Casos de Uso Específicos

### 1. Enumeração de diretórios via proxy (gobuster/ffuf)

Ferramentas como gobuster e ffuf fazem centenas de requisições. Com proxy rotativo configurado, o Khaos injeta automaticamente `HTTPS_PROXY` no ambiente do processo — nenhuma mudança de argumento é necessária.

### 2. Análise de JS bundles

Após o bootstrap, use `runOperatorHTTPRequest` com GET para baixar cada JS bundle:

```json
{
  "endpoint_id": "<id calculado para o JS>",
  "method": "GET",
  "profile_id": "anonymous"
}
```

O campo `response_preview` na resposta contém os primeiros 16 KB do bundle — analise em busca de hardcoded tokens, endpoints de API, chaves de serviço.

### 3. Teste de endpoints escondidos

Para testar `POST /api/register` (endpoint não visível na UI):
1. Adicione o endpoint no `state_changing_endpoint_ids` do plano
2. Bootstrap o endpoint via GET primeiro (endpoint observado no contexto)
3. Use `runOperatorHTTPRequest` com `method: "POST"` e `body` de teste

### 4. Brute-force de login com lockout testing

Use a tool `ffuf` com o proxy para testar lockout:
- Configure `max_requests: 500+`
- Inclua o endpoint de login em `authentication_endpoint_ids`
- Inicie task com stage `authentication`

---

## Notas de Segurança

- Senhas de proxy nunca aparecem em logs ou eventos de assessment (redactadas por `RedactSensitiveText`)
- O Khaos mantém o scope enforcement mesmo via proxy (scopedTransport valida a URL de destino)
- Proxies externos burlam apenas o rate-limit por IP; o scope enforcement permanece ativo
- Credenciais de proxy são armazenadas criptografadas no banco via `encryptAssessmentSecret`
- O campo `username` com semicolons é URL-encoded automaticamente pelo Khaos (`url.PathEscape`)

