HarGeneratorPlugin

Genereert HTTP Archive-bestanden (HAR) van de onderschepte aanvragen en antwoorden.

Configuratievoorbeeld

{
  "$schema": "https://raw.githubusercontent.com/dotnet/dev-proxy/main/schemas/v4.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/v4.0.0/hargeneratorplugin.schema.json",
    "includeSensitiveInformation": false,
    "includeResponse": true
  }
}

Configuratie-eigenschappen

Vastgoed	Description	Verstek
includeSensitiveInformation	Bepaalt of gevoelige informatie (autorisatieheaders, cookies, enzovoort) moet worden opgenomen in het gegenereerde HAR-bestand. Wanneer deze instelling is ingesteld false, worden waarden van gevoelige headers, cookies en gevoelige queryparameters met de waarde gewijzigd REDACTED	false
includeResponse	Bepaalt of de inhoud van de antwoordtekst moet worden opgenomen in het gegenereerde HAR-bestand	false

Opdrachtregelopties

Geen

Opmerkingen

De HAR-indeling (HTTP Archive) is een JSON-indeling voor het registreren van HTTP-transacties. Verschillende hulpprogramma's ondersteunen het op grote schaal en gebruikten het om:

• Netwerkverkeer en prestaties analyseren
• Fouten opsporen in API-interacties
• HTTP-sessiegegevens delen
• Importeren in hulpprogramma's voor browserontwikkelaars en andere analysehulpprogramma's

Wanneer includeSensitiveInformation deze instelling is ingesteld false, worden de volgende gevoelige headers automatisch door de invoegtoepassing bewerkt:

• 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

De plugin vervangt ook de waarden van alle aanvraag- en antwoordcookies (request.cookies en response.cookies) door REDACTED, terwijl de cookienamen behouden blijven.

Daarnaast voert de invoegtoepassing de waarden van de volgende gevoelige queryparameters (hoofdlettergevoelig) in zowel de aanvraag-URL () als de querytekenreeks (request.urlrequest.queryString) op. Andere queryparameters behouden hun oorspronkelijke waarden.

• access_token
• api_key
• api-key
• apikey
• auth
• client_secret
• code
• id_token
• key
• password
• refresh_token
• secret
• sig
• signature
• token
• x-amz-credential
• x-amz-security-token
• x-amz-signature
• x-goog-credential
• x-goog-signature

De aanvraag-URL https://api.contoso.com/users?access_token=abc123&page=2 wordt bijvoorbeeld vastgelegd als https://api.contoso.com/users?access_token=REDACTED&page=2.

Het gegenereerde HAR-bestand bevat:

• HTTP-aanvraagdetails (methode, URL, headers, queryparameters, cookies)
• HTTP-antwoorddetails (status, headers, cookies)
• Hoofdtekstgegevens van aanvragen en antwoorden (indien van toepassing)
• Inhoudstypen en -grootten
• HTTP-versiegegevens

De invoegtoepassing maakt een HAR-bestand met de naam devproxy-{timestamp}.har in de huidige map nadat de opname is gestopt.