Sdílet prostřednictvím


HarGeneratorPlugin

Generuje soubory HTTP Archive (HAR) z zachycených požadavků a odpovědí.

Příklad konfigurace

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/rc.schema.json",
  "plugins": [
    {
      "name": "HarGeneratorPlugin",
      "enabled": true,
      "pluginPath": "~appFolder/plugins/DevProxy.Plugins.dll",
      "configSection": "harGeneratorPlugin"
    }
  ],
  "harGeneratorPlugin": {
    "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v2.0.0/hargeneratorplugin.schema.json",
    "includeSensitiveInformation": false,
    "includeResponse": true
  }
}

Vlastnosti konfigurace

Vlastnictví Description Výchozí
includeSensitiveInformation Určuje, zda se mají do vygenerovaného souboru HAR zahrnout citlivé informace (autorizační hlavičky, soubory cookie atd.). Pokud je falsenastavená hodnota , citlivé hlavičky se redactují s hodnotou. REDACTED false
includeResponse Určuje, zda se má do vygenerovaného souboru HAR zahrnout obsah textu odpovědi. false

Možnosti příkazového řádku

None

Poznámky

Formát HAR (archiv HTTP) je formát založený na formátu JSON pro protokolování transakcí HTTP. Různé nástroje ho široce podporují a používají se k:

  • Analýza síťového provozu a výkonu
  • Ladění interakcí rozhraní API
  • Sdílení dat relace HTTP
  • Import do vývojářských nástrojů prohlížeče a dalších analytických nástrojů

Pokud includeSensitiveInformation je nastavená hodnota false, modul plug-in automaticky aktualizuje následující citlivé hlavičky:

  • 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

Vygenerovaný soubor HAR obsahuje:

  • Podrobnosti požadavku HTTP (metoda, adresa URL, hlavičky, parametry dotazu, soubory cookie)
  • Podrobnosti odpovědi HTTP (stav, hlavičky, soubory cookie)
  • Data textu žádosti a odpovědi (pokud je k dispozici)
  • Typy a velikosti obsahu
  • Informace o verzi PROTOKOLU HTTP

Modul plug-in vytvoří soubor HAR pojmenovaný devproxy-{timestamp}.har v aktuálním adresáři po zastavení záznamu.