Khaos Browser Operations
As ferramentas de browser fornecem uma sessão Chromium isolada por assessment, restrita ao escopo de URLs declarado no target. Use-as quando ferramentas HTTP puras (khaos_http_request, khaos_authenticated_read_probe) não conseguem observar o DOM renderizado, rotas SPA, estado JavaScript ou chamadas de rede que só disparam após interação do usuário. Não use o browser como cliente HTTP genérico — use khaos_http_request para chamadas de API direta onde execução de JS não é necessária.
A sessão é criada na primeira chamada e tem TTL de 15 minutos de inatividade. Uma navegação a URL fora do escopo encerra a sessão com erro.
Referência de Tools
| Tool | Parâmetros obrigatórios | Retorna | Quando usar |
|---|---|---|---|
khaos_browser_navigate |
assessment_id, target_url |
URL final, page title | Iniciar sessão, seguir redirecionamentos, confirmar estado pós-login |
khaos_browser_fill |
assessment_id, selector, value |
status, selector | Preencher campos de formulário, injetar payloads em inputs |
khaos_browser_click |
assessment_id, selector |
status, clicked | Submeter formulários, acionar links e botões |
khaos_browser_screenshot |
assessment_id |
screenshot_b64 (PNG) | Capturar evidência de estado visual da página |
khaos_browser_cookie_metadata |
assessment_id |
cookie_names, count | Verificar presença de cookies de sessão; analisar nomes (não valores) |
khaos_browser_inspect |
assessment_id, operation |
resultado da operação | Leitura de DOM: source, form fields, scripts, HTMX bindings |
khaos_browser_hook |
assessment_id, action |
resultado do hook | Interceptar fetch/XHR para mapear chamadas de rede client-side |
khaos_browser_close |
assessment_id |
status | Liberar sessão explicitamente ao final do fluxo |
khaos_browser_inspect — Referência de Operações
Todas as operações são leituras puras sem mutação do estado da página.
| Operação | Retorna | Tamanho típico | Uso em pentest |
|---|---|---|---|
page_title |
String | curto | Confirmar que o target renderizou; detectar estados de loading de SPA |
location |
URL atual | curto | Detectar redirecionamentos pós-login; confirmar escopo após navegação |
visible_text |
innerText do body | ≤32 KB | Buscar strings sensíveis, mensagens de debug, tokens expostos em texto |
form_fields |
Array {tag, name, type, required} |
variável | Mapear campos hidden, tokens CSRF, nomes de parâmetros para fuzzing |
page_source |
outerHTML completo | ≤64 KB | Análise estática do HTML renderizado; encontrar endpoints não visíveis ao katana |
htmx_endpoints |
Array de objetos com atributos hx-* |
≤500 entradas | Enumerar todos os targets hx-get/post/put/patch/delete — alimentar khaos-htmx-security |
inline_scripts |
Array com conteúdo de cada <script> inline |
≤20 blocos × 4 KB | Extrair URLs de API base, padrões de token, objetos de config — alimentar khaos-javascript-api |
external_scripts |
Array de URLs src |
variável | Identificar bundles de terceiros, scripts CDN, candidatos a source maps |
khaos_browser_hook — Lifecycle
khaos_browser_hook opera em duas etapas com dependência de ordem:
install — injeta interceptores
fetcheXMLHttpRequestnowindowda página atual. Retorna"installed"ou"already_installed"se já estava ativo. Deve ser chamado apóskhaos_browser_navigatee antes das interações que se quer capturar.collect — retorna um array de requests capturados desde o
install. Cada entrada tem:url,method,body(≤512 bytes),via(fetchouxhr),ts(timestamp).
Importante: os hooks são escopados à página atual. Uma navegação para uma nova origem (khaos_browser_navigate para URL diferente) reseta os interceptores — chame install novamente após a navegação. Chamar collect sem install retorna array vazio.
Uso pós-collect: cruze as URLs coletadas com khaos_endpoint_id para obter observed_endpoint_ids e use-os em khaos_http_request para replay direto com controle total de headers e body.
Sequências por Stage
Surface Mapping (enumeration)
Mapear a superfície client-side renderizada antes de fuzzing ativo.
khaos_browser_navigate → URL alvo
khaos_browser_inspect(page_source) → HTML completo para análise
khaos_browser_inspect(htmx_endpoints) → bindings HTMX → ver khaos-htmx-security
khaos_browser_inspect(inline_scripts) → scripts inline → ver khaos-javascript-api
khaos_browser_inspect(external_scripts) → CDN / bundles externos
khaos_browser_screenshot → evidência do estado
Authenticated Interaction Capture (vuln)
Mapear chamadas de rede que só aparecem após interação autenticada.
khaos_browser_navigate → URL de login
khaos_browser_fill → campo usuário
khaos_browser_fill → campo senha
khaos_browser_click → botão submit
khaos_browser_inspect(location) → confirmar redirecionamento pós-login
khaos_browser_hook(install) → ativar interceptação
khaos_browser_navigate → feature sob teste (ou khaos_browser_click em trigger)
khaos_browser_hook(collect) → ver todas as chamadas fetch/XHR disparadas
khaos_browser_screenshot → evidência
Cookie and Session Inspection (validation)
Inspecionar estado de sessão para análise de fixação, flags e parâmetros.
khaos_browser_navigate → URL autenticada
khaos_browser_inspect(form_fields) → mapear parâmetros de sessão em formulários
khaos_browser_cookie_metadata → nomes de cookies presentes (não valores)
khaos_browser_screenshot → evidência
Para atributos de cookie (HttpOnly, Secure, SameSite), use khaos_http_request inspecionando o header Set-Cookie da resposta — esses atributos não são acessíveis via DOM.
Limites e Restrições
- Valores de cookies nunca são retornados por nenhuma tool de browser.
khaos_browser_cookie_metadataretorna apenas nomes e contagem. Para flags de segurança dos cookies, usekhaos_http_requestcom inspeção deSet-Cookie. - JavaScript arbitrário não é aceito.
khaos_browser_inspectekhaos_browser_hookexecutam apenas scripts pré-auditados e fixos. - Scope enforced: navegação para URL fora do escopo do target retorna erro e pode encerrar a sessão.
- Para análise de vulnerabilidades HTMX (
htmx_endpoints), consulte a skillkhaos-htmx-security. - Para análise de scripts client-side (
inline_scripts,external_scripts), consulte a skillkhaos-javascript-api.