Partager via


HarGeneratorPlugin

Génère des fichiers d’archive HTTP (HAR) à partir des requêtes et réponses interceptées.

Définition de l’instance de plug-in

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

Exemple de configuration

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

Propriétés de configuration

Propriété Descriptif Par défaut
includeSensitiveInformation Détermine s’il faut inclure des informations sensibles (en-têtes d’autorisation, cookies, etc.) dans le fichier HAR généré. Lorsque la valeur est définie false, les en-têtes sensibles sont supprimés avec la valeur REDACTED false
includeResponse Détermine s’il faut inclure le contenu du corps de la réponse dans le fichier HAR généré false

Options de ligne de commande

Aucun

Remarques

Le format HAR (Archive HTTP) est un format JSON pour la journalisation des transactions HTTP. Divers outils le prennent largement en charge et l’ont utilisé pour :

  • Analyser le trafic réseau et les performances
  • Interactions de l’API de débogage
  • Partager des données de session HTTP
  • Importer dans les outils de développement du navigateur et d’autres outils d’analyse

Quand includeSensitiveInformation la valeur est définie false, le plug-in réacte automatiquement les en-têtes sensibles suivants :

  • 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

Le fichier HAR généré inclut les éléments suivants :

  • Détails de la requête HTTP (méthode, URL, en-têtes, paramètres de requête, cookies)
  • Détails de la réponse HTTP (état, en-têtes, cookies)
  • Données du corps de la demande et de la réponse (le cas échéant)
  • Types de contenu et tailles
  • Informations sur la version HTTP

Le plug-in crée un fichier HAR nommé devproxy-{timestamp}.har dans le répertoire actif après l’arrêt de l’enregistrement.