Compartilhar via


HarGeneratorPlugin

Gera arquivos DE ARQUIVO HTTP (HAR) das solicitações e respostas interceptadas.

Definição de instância do plug-in

{
  "name": "HarGeneratorPlugin",
  "enabled": true,
  "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
  "configSection": "harGeneratorPlugin"
}

Exemplo de configuração

{
  "harGeneratorPlugin": {
    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v1.3.0/hargeneratorplugin.schema.json",
    "includeSensitiveInformation": false,
    "includeResponse": true
  }
}

Propriedades de configuração

Propriedade Description Padrão
includeSensitiveInformation Determina se as informações confidenciais (cabeçalhos de autorização, cookies etc.) devem ser incluídas no arquivo HAR gerado. Quando definido como false, cabeçalhos confidenciais são redigidos com o valor REDACTED false
includeResponse Determina se o conteúdo do corpo da resposta deve ser incluído no arquivo HAR gerado false

Opções de linha de comando

None

Observações

O formato HAR (Arquivo HTTP) é um formato baseado em JSON para registrar transações HTTP em log. Várias ferramentas dão suporte a ela e a usaram para:

  • Analisar o tráfego e o desempenho da rede
  • Depurar interações de API
  • Compartilhar dados de sessão HTTP
  • Importar para ferramentas de desenvolvedor do navegador e outras ferramentas de análise

Quando includeSensitiveInformation é definido como false, o plug-in redicializa automaticamente os seguintes cabeçalhos confidenciais:

  • authorization
  • cookie
  • from
  • proxy-authenticate
  • proxy-authorization
  • set-cookie
  • www-authenticate
  • x-api-key
  • x-auth-token
  • x-csrf-token
  • x-forwarded-for
  • x-real-ip
  • x-session-token
  • x-xsrf-token

O arquivo HAR gerado inclui:

  • Detalhes da solicitação HTTP (método, URL, cabeçalhos, parâmetros de consulta, cookies)
  • Detalhes da resposta HTTP (status, cabeçalhos, cookies)
  • Dados do corpo da solicitação e da resposta (quando aplicável)
  • Tipos e tamanhos de conteúdo
  • Informações de versão HTTP

O plug-in cria um arquivo HAR nomeado devproxy-{timestamp}.har no diretório atual após as paradas de gravação.