Paramètres du proxy

Le proxy de développement est fourni avec plusieurs paramètres que vous pouvez utiliser pour contrôler la façon dont le proxy doit s’exécuter.

Vous pouvez configurer ces paramètres en les définissant dans le fichier devproxyrc.json , situé dans le dossier d’installation du proxy ou en les définissant au moment de l’exécution via les options de ligne de commande.

Le tableau suivant décrit les paramètres.

Setting Description Option de ligne de commande Valeurs autorisées Valeur par défaut
apiAllowedOrigins Origines exactes du navigateur qui peuvent appeler l’API proxy de développement. Toutes les requêtes nécessitent toujours le jeton du porteur d’instance. n/a Tableau d’origines HTTP ou HTTPS sans chemins, caractères génériques ou barres obliques de fin, par exemple, ["http://127.0.0.1:3000"] []
apiIpAddress Adresse IP de l’API proxy de développement à lier. Ce paramètre est indépendant de ipAddress. Utilisez une adresse non-bouclage uniquement sur les réseaux approuvés, car les jetons du porteur sont envoyés via HTTP. --api-ip-address <apiIpAddress> Adresse IPv4 ou IPv6 127.0.0.1
apiPort Port de l’API proxy de développement authentifiée à écouter. Définissez cette option pour 0 permettre au système d’exploitation d’affecter un port disponible aléatoire. --api-port <apiPort> entier 8897
asSystemProxy Indique s’il faut inscrire le proxy de développement en tant que proxy système au démarrage. Lorsque la valeur doit true être définieinstallCert, définissez la valeur surtrue --as-system-proxy true, false true
env Variables d’environnement à définir pour le processus de proxy de développement. Le proxy de développement les définit après le chargement du fichier de configuration et avant le chargement des plug-ins, de sorte que les plug-ins qui lisent les variables d’environnement utilisent ces valeurs. Le proxy de développement les utilise également pour remplacer {name} les espaces réservés dans les fichiers de spécifications d’API utilisés par les plug-ins MinimalPermissions. Valeurs transmises par --env des valeurs de remplacement du fichier de configuration. Les modifications apportées à HTTP_PROXY, HTTPS_PROXYou NO_PROXYALL_PROXY(y compris les variantes minuscules) nécessitent l’arrêt et le démarrage du proxy de développement, car le rechargement à chaud ne peut pas actualiser les paramètres de proxy HTTP mis en cache. -e, --env <env> Objet avec des valeurs de chaîne, par exemple , {"CI": "1"}; sur la ligne de commande, une ou plusieurs paires séparées par name=value espace n/a
filterByHeaders Intercepter uniquement les requêtes avec des en-têtes spécifiques n/a {"filterByHeaders": [ { "name": "value" } ] }. La valeur peut être vide pour inclure des requêtes avec l’en-tête spécifié, quelle que soit sa valeur. n/a
installCert Indique s’il faut installer le certificat racine --install-cert true, false true
ipAddress Adresse IP du proxy à lier à --ip-address <ipAddress> Adresse IPv4 127.0.0.1
languageModel Paramètres du modèle de langage n/a Pour plus d’informations, consultez la section du modèle de langage. n/a
logLevel Niveau de messages à journaliser --log-level <loglevel> trace, debug, information, warning, error information
newVersionNotification Indique s’il faut notifier les nouvelles versions n/a none, stable, beta stable
noColor Désactiver la sortie colorée --no-color n/a n/a
noFirstRun Ignorez la première expérience d’exécution (n’approuvez pas le certificat sur macOS) --no-first-run n/a n/a
noWatch Désactiver le redémarrage automatique du proxy lorsque le fichier de configuration change --no-watch n/a n/a
output Format de sortie pour la journalisation structurée --output <format> text, json text
port Port sur lequel écouter le serveur proxy. Définissez cette option pour 0 permettre au système d’exploitation d’affecter un port disponible aléatoire. -p, --port <port> entier 8000
record Utilisez cette option pour enregistrer tous les journaux de requête --record n/a n/a
showSkipMessages Indique s’il faut afficher les messages de journal lorsque le proxy de développement ignore l’exécution d’un plug-in. n/a true, false true
showTimestamps Indique s’il faut afficher les horodatages des demandes dans la sortie du journal interactif. Les fichiers journaux détachés incluent toujours des horodatages complets. Vous pouvez donc les filtrer par date et heure. n/a true, false true
timeoutSeconds Durée en secondes après laquelle le proxy de développement quitte. Réinitialise quand le proxy de développement intercepte une requête. -t, --timeout <seconds> entier positif n/a
urlsToWatch Liste des URL que le proxy doit intercepter -u, --urls-to-watch <urlsToWatch> URL absolue (peut contenir des caractères génériques) par exemple, "https://api.contoso.com/*" Voir le fichier devproxyrc
validateSchemas Indique s’il faut valider la configuration par rapport au schéma spécifié. S’applique uniquement aux fichiers de configuration JSON. n/a true, false true
watchPids ID des processus à surveiller pour les demandes --watch-pids <pids> tableau d’entiers ; sur la ligne de commande, un ou plusieurs entiers séparés par espace n/a
watchProcessNames Noms des processus à surveiller pour les demandes --watch-process-names <processNames> tableau de chaînes ; sur la ligne de commande, un ou plusieurs noms séparés par espace n/a
watchProcessTree Indique s’il faut également surveiller les descendants (processus enfants) des processus sélectionnés par watchPids ou watchProcessNames --watch-process-tree true, false false

Remarque

Le taux d’échec n’est pas un paramètre proxy. Pour le configurer, définissez la rate propriété dans la section de configuration de GenericRandomErrorPlugin ou GraphRandomErrorPlugin, ou utilisez l’option -f, --failure-rate de ligne de commande lorsque l’un de ces plug-ins est chargé.

  • Dernière mise à jour :