Como gerar um arquivo HAR no Chrome, Edge, Firefox e Safari

arquivos HAR

Um arquivo HAR é uma gravação em JSON de todas as requisições que o navegador fez enquanto as ferramentas de desenvolvedor estavam abertas: URLs, cabeçalhos, cookies, corpos de requisição e de resposta, e os tempos. Para gerar um, abra as ferramentas de desenvolvedor na aba Network, ative a opção que mantém o registro entre um carregamento de página e outro, repita o que deu errado e exporte.

Chrome e Edge

  1. Abra a página com o problema.

  2. Pressione F12, ou Cmd+Option+I no Mac, e selecione a aba Network.

  3. Marque Preserve log, para que a lista sobreviva a recarregamentos e redirecionamentos.

  4. Recarregue a página e repita o que deu errado.

  5. Clique em Export HAR (sanitized)... na barra do topo do painel Network e salve o arquivo.

O Chrome exporta o arquivo sanitizado por padrão. Ele deixa de fora os cabeçalhos Cookie, Set-Cookie e Authorization. Se uma equipe de suporte pedir esses cabeçalhos, ative Allow to generate HAR with sensitive data em Settings → Preferences → Network e depois escolha Export HAR (with sensitive data) no menu de exportação.

O Edge usa os mesmos rótulos, segundo a Microsoft. As configurações dele abrem pelo menu «…», Customize and control DevTools, no canto superior direito das ferramentas de desenvolvedor.

Firefox

  1. Abra a página com o problema.

  2. Pressione F12, ou Cmd+Option+I no Mac, e selecione Network.

  3. Abra o menu com o ícone de engrenagem no canto superior direito do painel e marque Persist Logs.

  4. Recarregue a página e repita o que deu errado.

  5. No mesmo menu, escolha Save All As HAR.

Não encontrei uma exportação sanitizada no menu do Firefox, então trate o arquivo como se ele contivesse os seus cookies.

Safari

  1. Ative o menu de desenvolvedor: Safari → Settings → Advanced → Show features for web developers.

  2. Abra a página, escolha Develop → Show Web Inspector (Cmd+Option+I) e selecione a aba Network.

  3. Ative Preserve Log.

  4. Recarregue a página e repita o que deu errado.

  5. Clique em Export, ou pressione Cmd+S, e salve o arquivo.

No iPhone, ative Settings → Safari → Advanced → Web Inspector, conecte o celular a um Mac e inspecione a página pelo menu Develop do Safari no Mac. Para o Chrome no Android, ative a depuração USB e abra chrome://inspect no Chrome de um computador.

O que um arquivo HAR contém

Um arquivo HAR é JSON puro. Para cada requisição, ele traz o método, a URL com a query string, os cabeçalhos de requisição e de resposta, os cookies, os dados enviados, a própria resposta e quanto tempo levou cada fase: DNS, conexão, TLS, espera, download. Isso vale para o HTML da página, os scripts, as imagens e as fontes, não só para as chamadas de API.

Um HAR de uma sessão logada também contém o que mantém você logado: o cookie de sessão, o cabeçalho Authorization e, muitas vezes, tokens em URLs e em respostas JSON. Entre 28 de setembro e 17 de outubro de 2023, um invasor teve acesso a arquivos que 134 clientes da Okta tinham enviado ao sistema de suporte da empresa, e alguns deles eram arquivos HAR. Segundo a Okta, o invasor usou tokens de sessão desses arquivos para sequestrar as sessões de cinco clientes.

O que remover antes de enviar

A exportação sanitizada do Chrome tira os três cabeçalhos e mantém todo o resto. Isso inclui:

  • tokens em URLs, como ?token=, ?code= ou ?key=;

  • cabeçalhos personalizados, como X-Api-Key;

  • corpos de resposta que trazem tokens, como a resposta a uma requisição de login.

Abra o arquivo num editor de texto e procure por token, key, secret, session, password, Bearer e o seu endereço de e-mail. O HAR sanitizer da Cloudflare remove cookies de sessão e JSON Web Tokens no próprio navegador, sem fazer upload do arquivo. Depois de enviar o arquivo, saia da sua conta no site. Nos sites que encerram a sessão no servidor quando você sai, os cookies do arquivo param de funcionar.

Quando é você que pede o HAR

Quando você pede um HAR, o cliente precisa passar pelos cinco passos acima, num painel do navegador que talvez nunca tenha aberto, e depois mandar para você um arquivo que contém a sessão dele. Criei o widget do BugDump para enviar as requisições da página junto com o relatório de bug, e assim o cliente nunca abre as ferramentas de desenvolvedor. A partir do momento em que o script do widget começa a rodar, ele registra as requisições que a sua página faz com fetch e XMLHttpRequest: método, URL, status, tempo, os cabeçalhos de requisição que o seu código passa para o fetch (nenhum no caso do XMLHttpRequest), os cabeçalhos de resposta e os corpos, se você ativar captureNetworkBodies.

Veja como isso fica numa requisição que carrega segredos. Na loja de demonstração que uso para as capturas de tela, o código da loja buscou os pedidos recentes de um cliente com um token na URL, um cabeçalho Authorization e um token CSRF, e a API respondeu 401 session_expired. O cliente, Daniel, é inventado, e um script fez o papel dele usando o widget de verdade. Ele escreveu: «Tried to open my last order from the cart and it says my session expired. I signed in five minutes ago.» Em português: «Tentei abrir meu último pedido pelo carrinho e aparece que minha sessão expirou. Fiz login há cinco minutos.»

A aba Network do relatório do Daniel: um GET para /api/account/orders respondido com 401, com access_token, X-CSRF-Token e Authorization ocultos

O relatório mantém o que o desenvolvedor precisa: o 401, session_expired e o cabeçalho www-authenticate, que diz que o token era inválido. Os segredos não chegaram até ele:

  • Antes de um relatório ser armazenado, o servidor substitui por [REDACTED] os valores de cabeçalhos, parâmetros de URL e campos JSON ou de formulário cujos nomes contêm palavras como token, secret, password, session, api_key, jwt ou csrf. O valor de Authorization também é armazenado como [REDACTED], e o app o mostra como pontos.

  • Os cookies nunca chegam lá. Os scripts de uma página não conseguem ler o cabeçalho Cookie que o navegador acrescenta nem um cabeçalho de resposta Set-Cookie, então o widget nunca os vê.

  • Os corpos de requisição e de resposta ficam de fora, a menos que você os ative. Esta loja ativa, por isso o 401 chegou com o corpo.

Quando você ainda precisa do HAR

O widget vê o que os próprios scripts da página veem. Peça um HAR quando o problema estiver no que eles não veem:

  • requisições feitas antes de o script do widget começar a rodar, como as primeiras chamadas de API no carregamento da página;

  • o documento HTML, os scripts, os estilos, as imagens e as fontes: o relatório traz a URL, a duração e o tamanho dos últimos 20 deles, mas nenhum status, cabeçalho ou corpo;

  • uma falha de CORS: a página recebe só um erro de rede, enquanto o HAR mostra a requisição de preflight OPTIONS e os cabeçalhos de resposta que o navegador rejeitou;

  • cada salto de um redirecionamento, se o navegador respondeu do próprio cache e os cabeçalhos do documento e dos arquivos estáticos;

  • tráfego de WebSocket;

  • uma sessão longa: o widget guarda as últimas 150 requisições, ou 1.000 enquanto quem reporta grava a tela, e os primeiros 32.768 caracteres de cada corpo.

Perguntas sobre arquivos HAR

É seguro enviar um arquivo HAR? Só para alguém a quem você confiaria a sua sessão, e só depois de remover cookies e tokens. Sair da conta também ajuda, se o site encerra as sessões no servidor.

Como abro um arquivo HAR? No Chrome e no Edge, arraste o arquivo para a lista de requisições do painel Network ou clique em Import HAR. No Firefox, escolha Import HAR no menu da engrenagem. No Safari, clique em Import na aba Network. É JSON, então qualquer editor de texto também abre o arquivo.

Por que o meu arquivo HAR está vazio? As ferramentas de desenvolvedor só gravam enquanto estão abertas. Abra-as primeiro, depois recarregue a página e repita os passos.

Leia também