Configurer le proxy de développement

Le proxy de développement est un outil en ligne de commande qui vous permet de simuler des comportements et des erreurs d’API cloud pour vous aider à créer des applications résilientes.

Dans ce tutoriel, vous allez apprendre à installer et exécuter le proxy de développement.

Installer le proxy de développement

Le moyen le plus simple d’installer le proxy de développement consiste à utiliser winget. Vous pouvez également installer manuellement le proxy de développement.

Automatisé

Pour installer Dev Proxy à l’aide de winget, exécutez la commande suivante :

winget install Microsoft.DevProxy --silent

Important

Le programme d’installation du proxy de développement ajoute une nouvelle entrée à PATH. Pour utiliser le proxy de développement après l’installation, vous devez redémarrer l’invite de commandes pour actualiser la variable d’environnement PATH.

Manuel

Téléchargez la dernière version et extrayez les fichiers dans un dossier. Pour ce tutoriel, nous partons du principe que vous extrayez les fichiers dans un dossier nommé devproxy situé dans votre répertoire de base.

Pour démarrer le proxy de développement à partir de n’importe quel répertoire, ajoutez son emplacement de dossier d’installation à votre chemin d’accès.

1. Ouvrez le menu Start.
2. Entrez Edit environment variables for your account dans la zone de recherche. Sélectionnez le résultat dans la liste pour ouvrir la boîte de dialogue Environment Variables.
3. Dans la section User variables for <username>, sélectionnez la ligne avec le nom de variable de Path et sélectionnez le bouton Edit....
4. Dans la boîte de dialogue Edit environment variable, sélectionnez le bouton New.
5. Entrez %USERPROFILE%\devproxy dans la nouvelle ligne, puis sélectionnez OK.
6. Pour confirmer les modifications, sélectionnez OK.

Remarque

Pour essayer les dernières fonctionnalités en préversion, installez la version bêta du proxy de développement.

Automatisé

Pour installer Dev Proxy à l’aide de winget, exécutez la commande suivante :

winget install Microsoft.DevProxy.Beta --silent

Manuel

Téléchargez la dernière version bêta et extrayez les fichiers dans un dossier. Suivez les étapes de configuration manuelles décrites précédemment.

Pour exécuter la version bêta du proxy de développement, utilisez devproxy-beta

Le moyen le plus simple d’installer le proxy de développement consiste à utiliser Homebrew. Vous pouvez également installer manuellement le proxy de développement.

Automatisé

Pour installer le proxy de développement à l’aide de Homebrew, exécutez les commandes suivantes :

brew tap dotnet/dev-proxy
brew install dev-proxy

Manuel

Téléchargez la dernière version et extrayez les fichiers dans un dossier. Pour ce tutoriel, nous partons du principe que vous extrayez les fichiers dans un dossier nommé devproxy situé dans votre répertoire de base.

Pour démarrer le proxy de développement à partir de n’importe quel répertoire, ajoutez son emplacement de dossier d’installation à votre chemin d’accès.

Les étapes ci-dessous montrent comment ajouter le proxy à PATH avec l’interpréteur de commandes zsh. Selon l’interpréteur de commandes que vous utilisez, votre fichier de profil peut différer.

1. Ouvrez votre profil shell dans un éditeur de texte >~/.zshrc.
2. Mettez à jour la variable d’environnement PATH avec l’emplacement du proxy >export PATH=".:$PATH:$HOME/devproxy".
3. Rechargez votre profil >source ~/.zshrc.

Remarque

Pour essayer les dernières fonctionnalités en préversion, installez la version bêta du proxy de développement.

Automatisé

Pour installer le proxy de développement à l’aide de Homebrew, exécutez les commandes suivantes :

brew tap dotnet/dev-proxy
brew install dev-proxy-beta

Manuel

Téléchargez la dernière version bêta et extrayez les fichiers dans un dossier. Suivez les étapes de configuration manuelles décrites précédemment.

Pour exécuter la version bêta du proxy de développement, utilisez devproxy-beta

Le moyen le plus simple d’installer le proxy de développement consiste à utiliser le script d’installation. Vous pouvez également installer manuellement le proxy de développement.

Automatisé

Pour installer le proxy de développement à l’aide du script d’installation, exécutez les commandes suivantes :

bash -c "$(curl -sL https://aka.ms/devproxy/setup.sh)"

Si vous utilisez PowerShell, exécutez la commande suivante :

(Invoke-WebRequest https://aka.ms/devproxy/setup.ps1).Content | Invoke-Expression

Manuel

Téléchargez la dernière version et extrayez les fichiers dans un dossier. Pour ce tutoriel, nous partons du principe que vous extrayez les fichiers dans un dossier nommé devproxy situé dans votre répertoire de base.

Pour démarrer le proxy de développement à partir de n’importe quel répertoire, ajoutez son emplacement de dossier d’installation à votre chemin d’accès.

Les étapes ci-dessous montrent comment ajouter le proxy à PATH lors de l’utilisation de l’interpréteur de commandes Bash. Selon l’interpréteur de commandes que vous utilisez, votre fichier de profil peut différer.

1. Ouvrez votre profil shell dans un éditeur de texte >~/.bashrc.
2. Mettez à jour la variable d’environnement PATH avec l’emplacement du proxy >export PATH=".:$PATH:$HOME/devproxy".
3. Rechargez votre profil >source ~/.bashrc.

Remarque

Pour essayer les dernières fonctionnalités en préversion, installez la version bêta du proxy de développement.

Automatisé

Pour installer le proxy de développement à l’aide du script d’installation, exécutez les commandes suivantes :

bash -c "$(curl -sL https://aka.ms/devproxy/setup-beta.sh)"

Si vous utilisez PowerShell, exécutez la commande suivante :

(Invoke-WebRequest https://aka.ms/devproxy/setup-beta.ps1).Content | Invoke-Expression

Manuel

Téléchargez la dernière version bêta et extrayez les fichiers dans un dossier. Suivez les étapes de configuration manuelles décrites précédemment.

Pour exécuter la version bêta du proxy de développement, utilisez devproxy-beta

Démarrer le proxy de développement pour la première fois

La première fois que vous démarrez le proxy de développement sur votre ordinateur, vous devez suivre quelques étapes pour vous assurer que le proxy de développement peut intercepter les requêtes de votre ordinateur et répondre correctement. Vous n’aurez pas à répéter ces étapes après la première exécution.

1. Démarrez le proxy de développement. Ouvrez une session d’invite de commandes. Entrez devproxy, puis appuyez sur Entrée.
2. Approuvez le certificat. Le proxy de développement installe un certificat nommé Dev Proxy CA. Un avertissement s’affiche. Sélectionnez Yes pour confirmer que vous souhaitez installer le certificat. Le proxy de développement utilise ce certificat pour déchiffrer le trafic HTTPS envoyé à partir de votre ordinateur.
3. Autoriser l’accès au pare-feu. Le Pare-feu Windows bloque le proxy. Un avertissement s’affiche. Sélectionnez Allow access bouton pour autoriser le trafic via le pare-feu.

1. Démarrez le proxy de développement. Ouvrez une session d’invite de commandes. Entrez devproxy, puis appuyez sur Entrée.
2. Approuvez le certificat. Le proxy de développement installe un certificat nommé Dev Proxy CA, qu’il utilise pour déchiffrer le trafic HTTPS envoyé à partir de votre machine. Un avertissement s’affiche. Appuyez sur y pour confirmer que vous souhaitez approuver le certificat.
3. Acceptez les connexions entrantes. Un avertissement s’affiche. Sélectionnez Allow pour confirmer.

1. Démarrer le proxy de développement. Ouvrez une session d’invite de commandes. Entrez devproxy et appuyez sur . Entrez.

2. Approuvez le certificat. Le proxy de développement utilise un certificat SSL personnalisé pour déchiffrer le trafic HTTPS envoyé à partir de votre ordinateur.

   Important

   Les instructions suivantes concernent Ubuntu. Pour les autres distributions Linux, les étapes peuvent différer.

   Pour installer et approuver le certificat, dans une nouvelle invite de commandes, exécutez les commandes suivantes :

   # Export Dev Proxy root certificate
   openssl pkcs12 -in ~/.config/dev-proxy/rootCert.pfx -clcerts -nokeys -out dev-proxy-ca.crt -passin pass:""
   # Install the certificate
   sudo cp dev-proxy-ca.crt /usr/local/share/ca-certificates/
   # Update certificates
   sudo update-ca-certificates
   

L’invite de commandes affiche la sortie suivante :

 info    8 error responses loaded from devproxy-errors.json
 info    Dev Proxy API listening on http://localhost:8897...
 info    Dev Proxy Listening on 127.0.0.1:8000...

Hotkeys: issue (w)eb request, (r)ecord, (s)top recording, (c)lear screen
Press CTRL+C to stop Dev Proxy

Par défaut, le proxy de développement est configuré pour :

• Intercepter les requêtes adressées à n’importe quel endpoint de l'API JSON Placeholder
• Simuler des réponses d’erreur d’API et une limitation d’API avec un taux d’échec de 50 %

Vérifiez que le proxy de développement fonctionne correctement

Le proxy de développement intercepte les demandes que les applications sur votre ordinateur effectuent aux URL que vous inscrivez auprès du proxy de développement. Lorsque le proxy de développement détecte une requête, il le transmet à l’API (sans action) ou retourne une réponse. Confirmons que le proxy de développement fonctionne comme prévu.

Dans PowerShell, utilisez l’applet de commande Invoke-WebRequest pour envoyer une requête GET à l’API d’espace réservé JSON.

Invoke-WebRequest -Uri https://jsonplaceholder.typicode.com/posts

Si vous utilisez curl, envoyez une requête GET à l’API d’espace réservé JSON à l’aide de la commande suivante.

curl -ikx http://localhost:8000 https://jsonplaceholder.typicode.com/posts

Vous pouvez également utiliser un client d’API comme Postman pour envoyer une requête GET à https://jsonplaceholder.typicode.com/posts.

Dans la ligne de commande où le proxy de développement est en cours d’exécution, vous voyez les informations sur la requête et l’action effectuée par le proxy de développement. Par défaut, le proxy de développement simule une réponse d’erreur avec une probabilité de 50 %. Si votre requête ne retourne pas d’erreur, le proxy de développement la transmet.

 req   ╭ GET https://jsonplaceholder.typicode.com/posts
 time  │ 1/31/2025 12:12:14 PM +00:00
 skip  │ RetryAfterPlugin: Request not throttled
 skip  │ GenericRandomErrorPlugin: Pass through
 api   ╰ Passed through

Si le proxy de développement retourne une réponse d’erreur, vous voyez le message d’erreur dans la sortie.

 req   ╭ GET https://jsonplaceholder.typicode.com/posts
 time  │ 1/31/2025 12:12:37 PM +00:00
 skip  │ RetryAfterPlugin: Request not throttled
 oops  ╰ 403 Forbidden

Important

Si vous ne voyez aucune sortie dans le terminal, il est probable que Dev Proxy n'intercepte pas les requêtes. Consultez la section problèmes courants pour obtenir de l’aide.

Arrêter le proxy de développement en toute sécurité

Lorsque vous n’avez plus besoin que le proxy de développement soit en cours d’exécution, vous devez toujours l’arrêter en toute sécurité.

• Appuyez sur Ctrl + C pour arrêter le proxy de développement en toute sécurité.

Si vous arrêtez la session d’invite de commandes, le proxy de développement n’annule pas l’inscription correctement en tant que proxy système et vous risquez de rencontrer des problèmes courants.

Étape suivante

Découvrez comment configurer le proxy de développement en fonction de vos besoins. Le proxy de développement est hautement flexible et prend en charge de nombreux scénarios différents. Apprenez-en davantage sur la configuration de celui-ci dans votre scénario spécifique.

Configurer le proxy de développement