Condividi tramite

Configurare il proxy di sviluppo

  • Articolo

Dev Proxy è uno strumento da riga di comando che consente di simulare comportamenti ed errori delle API cloud per creare app resilienti.

In questa esercitazione si apprenderà come installare ed eseguire Dev Proxy.

Installare Dev Proxy

Il modo più semplice per installare Dev Proxy consiste nell'usare winget. In alternativa, è possibile installare manualmente Dev Proxy.

Per installare Dev Proxy usando winget, eseguire il comando seguente:

winget install Microsoft.DevProxy --silent

Importante

Il programma di installazione di Dev Proxy aggiunge una nuova voce a PATH. Per usare Dev Proxy dopo l'installazione, è necessario riavviare il prompt dei comandi per aggiornare la variabile di ambiente PATH.

Nota

Per provare le funzionalità di anteprima più recenti, installare la versione beta di Dev Proxy.

Per installare Dev Proxy usando winget, eseguire il comando seguente:

winget install Microsoft.DevProxy.Beta --silent

Per eseguire la versione beta di Dev Proxy, usare devproxy-beta

Il modo più semplice per installare Dev Proxy consiste nell'usare Homebrew. In alternativa, è possibile installare manualmente Dev Proxy.

Per installare Dev Proxy con Homebrew, eseguire i comandi seguenti:

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

Nota

Per provare le funzionalità di anteprima più recenti, installare la versione beta di Dev Proxy.

Per installare Dev Proxy con Homebrew, eseguire i comandi seguenti:

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

Per eseguire la versione beta di Dev Proxy, usare devproxy-beta

Il modo più semplice per installare Dev Proxy consiste nell'usare lo script di installazione. In alternativa, è possibile installare manualmente Dev Proxy.

Per installare Dev Proxy usando lo script di installazione, eseguire i comandi seguenti:

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

Se si usa PowerShell, eseguire il comando seguente:

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

Nota

Per provare le funzionalità di anteprima più recenti, installare la versione beta di Dev Proxy.

Per installare Dev Proxy usando lo script di installazione, eseguire i comandi seguenti:

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

Se si usa PowerShell, eseguire il comando seguente:

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

Per eseguire la versione beta di Dev Proxy, usare devproxy-beta

Avviare il proxy di sviluppo per la prima volta

La prima volta che si avvia Dev Proxy nel computer, è necessario eseguire alcuni passaggi per assicurarsi che Dev Proxy possa intercettare le richieste dal computer e rispondere correttamente. Non sarà necessario ripetere questi passaggi dopo la prima esecuzione.

  1. Avvia il proxy di sviluppo. Aprire una sessione del prompt dei comandi. Immettere devproxy e premere INVIO.
  2. certificato di attendibilità. Dev Proxy installa un certificato denominato Dev Proxy CA. Viene visualizzato un avviso. Selezionare Yes per confermare che si vuole installare il certificato. Dev Proxy usa questo certificato per decrittografare il traffico HTTPS inviato dal computer.
  3. Consentire l'accesso al firewall. Windows Firewall blocca il proxy. Viene visualizzato un avviso. Selezionare il pulsante Allow access per consentire il traffico attraverso il firewall.
  1. Avvia il proxy di sviluppo. Aprire una sessione del prompt dei comandi. Immettere devproxy e premere Immettere.
  2. certificato di attendibilità. Dev Proxy installa un certificato denominato Dev Proxy CA, che usa per decrittografare il traffico HTTPS inviato dal computer. Viene visualizzato un avviso. Premere y per confermare che si vuole considerare attendibile il certificato.
  3. Accetta connessioni in ingresso. Viene visualizzato un avviso. Selezionare Allow per confermare.

  1. Avvia il proxy di sviluppo. Aprire una sessione del prompt dei comandi. Immettere devproxy e premere , quindi immettere.

  2. certificato di attendibilità. Dev Proxy usa un certificato SSL personalizzato per decrittografare il traffico HTTPS inviato dal computer.

    Importante

    Le istruzioni seguenti sono per Ubuntu. Per altre distribuzioni linux, i passaggi potrebbero essere diversi.

    Per installare e considerare attendibile il certificato, eseguire i comandi seguenti in un nuovo prompt dei comandi:

    # 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

Il prompt dei comandi visualizza l'output seguente:

 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

Per impostazione predefinita, Dev Proxy è configurato per:

  • Intercettare le richieste effettuate a qualsiasi endpoint 'API segnaposto JSON
  • Simulare le risposte di errore dell'API e la limitazione della larghezza di banda API con un tasso di errore pari al 50%%

Verificare che Dev Proxy funzioni correttamente

Dev Proxy intercetta le richieste eseguite dalle applicazioni nel computer agli URL registrati con Dev Proxy. Quando Dev Proxy rileva una richiesta, la passa all'API (non eseguire alcuna azione) o restituisce una risposta. Verificare che Dev Proxy funzioni come previsto.

In PowerShell usare il cmdlet Invoke-WebRequest per inviare una richiesta GET all'API segnaposto JSON.

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

Se si usa curl, inviare una richiesta GET all'API segnaposto JSON usando il comando seguente.

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

È anche possibile usare un client API come Postman per inviare una richiesta GET a https://jsonplaceholder.typicode.com/posts.

Nella riga di comando in cui è in esecuzione Dev Proxy vengono visualizzate le informazioni sulla richiesta e l'azione eseguita da Dev Proxy. Per impostazione predefinita, Dev Proxy simula una risposta di errore con una probabilità di 50%. Se la richiesta non restituisce un errore, Dev Proxy lo passa attraverso.

 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

Se Dev Proxy restituisce una risposta di errore, viene visualizzato il messaggio di errore nell'output.

 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

Importante

Se non viene visualizzato alcun output nel prompt dei comandi, è probabile che Dev Proxy non intercetta le richieste. Per assistenza, vedere la sezione problemi comuni.

Fermare il proxy di sviluppo in modo sicuro

Quando non è più necessario che Dev Proxy sia in esecuzione, è consigliabile arrestarlo sempre in modo sicuro.

  • Premere ctrl + C per arrestare in modo sicuro Dev Proxy.

Se si chiude la sessione del prompt dei comandi, Dev Proxy non si deregistra correttamente come proxy di sistema e potrebbero verificarsi alcuni problemi comuni .

Passaggio successivo

Informazioni su come configurare Dev Proxy in base alle proprie esigenze. Dev Proxy è altamente flessibile e supporta molti scenari diversi. Altre informazioni su come configurarla per uno scenario specifico.

Configurare il proxy di sviluppo