Compartilhar via

Configurar o Proxy de Desenvolvimento

  • Artigo

O Proxy de Desenvolvimento é uma ferramenta de linha de comando que ajuda você a simular comportamentos e erros de APIs de nuvem para ajudá-lo a criar aplicativos resilientes.

Neste tutorial, você aprenderá a instalar e executar o Proxy de Desenvolvimento.

Instalar o Proxy de Desenvolvimento

A maneira mais fácil de instalar o Proxy de Desenvolvimento é usando winget. Como alternativa, você pode instalar o Proxy de Desenvolvimento manualmente.

Para instalar o Proxy de Desenvolvimento usando winget, execute o seguinte comando:

winget install Microsoft.DevProxy --silent

Importante

O instalador de Proxy de Desenvolvimento adiciona uma nova entrada ao PATH. Para usar o Proxy de Desenvolvimento após a instalação, reinicie o prompt de comando para atualizar a variável de ambiente PATH.

Nota

Para experimentar os recursos de visualização mais recentes, instale a versão beta do Proxy de Desenvolvimento.

Para instalar o Proxy de Desenvolvimento usando winget, execute o seguinte comando:

winget install Microsoft.DevProxy.Beta --silent

Para executar a versão beta do Proxy de Desenvolvimento, use devproxy-beta

A maneira mais fácil de instalar o Proxy de Desenvolvimento é usando o Homebrew. Como alternativa, você pode instalar o Proxy de Desenvolvimento manualmente.

Para instalar o Proxy de Desenvolvimento usando o Homebrew, execute os seguintes comandos:

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

Nota

Para experimentar os recursos de visualização mais recentes, instale a versão beta do Proxy de Desenvolvimento.

Para instalar o Proxy de Desenvolvimento usando o Homebrew, execute os seguintes comandos:

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

Para executar a versão beta do Proxy de Desenvolvimento, use devproxy-beta

A maneira mais fácil de instalar o Proxy de Desenvolvimento é usando o script de configuração. Como alternativa, você pode instalar o Proxy de Desenvolvimento manualmente.

Para instalar o Proxy de Desenvolvimento usando o script de instalação, execute os seguintes comandos:

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

Se você usar o PowerShell, execute o seguinte comando:

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

Nota

Para experimentar os recursos de visualização mais recentes, instale a versão beta do Proxy de Desenvolvimento.

Para instalar o Proxy de Desenvolvimento usando o script de instalação, execute os seguintes comandos:

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

Se você usar o PowerShell, execute o seguinte comando:

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

Para executar a versão beta do Proxy de Desenvolvimento, use devproxy-beta

Iniciar o Proxy de Desenvolvimento pela primeira vez

Na primeira vez que você iniciar o Proxy de Desenvolvimento em seu computador, há algumas etapas a seguir para garantir que o Proxy de Desenvolvimento possa interceptar solicitações do computador e responder com êxito. Você não precisará repetir essas etapas após a primeira execução.

  1. Inicie o Proxy de Desenvolvimento. Abra uma sessão de prompt de comando. Insira devproxy e pressione Enter.
  2. Certificado de confiança. O Proxy de Desenvolvimento instala um certificado chamado Dev Proxy CA. Um aviso é exibido. Selecione Yes para confirmar se deseja instalar o certificado. O Proxy de Desenvolvimento usa esse certificado para descriptografar o tráfego HTTPS enviado do computador.
  3. Permitir acesso ao firewall. O Firewall do Windows bloqueia o proxy. Um aviso é exibido. Selecione Allow access botão para permitir o tráfego por meio do firewall.
  1. Inicie o Proxy de Desenvolvimento. Abra uma sessão de prompt de comando. Insira devproxy e pressione , depois insira.
  2. Certificado de confiança. O Proxy de Desenvolvimento instala um certificado chamado Dev Proxy CA, que ele usa para descriptografar o tráfego HTTPS enviado do computador. Um aviso é exibido. Pressione y para confirmar se deseja confiar no certificado.
  3. Aceite conexões de entrada. Um aviso é exibido. Selecione Allow para confirmar.

  1. Inicie o Proxy de Desenvolvimento. Abra uma sessão de prompt de comando. Insira devproxy, pressione e em seguida.

  2. Certificado de confiança. O Proxy de Desenvolvimento usa um certificado SSL personalizado para descriptografar o tráfego HTTPS enviado do computador.

    Importante

    As instruções a seguir são para o Ubuntu. Para outras distribuições do Linux, as etapas podem ser diferentes.

    Para instalar e confiar no certificado, em um novo prompt de comando, execute os seguintes comandos:

    # 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

O prompt de comando exibe a seguinte saída:

 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

Por padrão, o Proxy de Desenvolvimento está configurado para:

  • Interceptar solicitações feitas a qualquer ponto de extremidade da API do Espaço Reservado JSON
  • Simular respostas de erro de API e limitação de API com uma taxa de falha de 50%

Confirme se o Proxy de Desenvolvimento está funcionando corretamente

O Proxy de Desenvolvimento intercepta as solicitações que os aplicativos em seu computador fazem para URLs que você registra no Proxy de Desenvolvimento. Quando o Proxy de Desenvolvimento detecta uma solicitação, ele a passa para a API (não executar nenhuma ação) ou retorna uma resposta. Vamos confirmar se o Proxy de Desenvolvimento está funcionando conforme o esperado.

No PowerShell, use o cmdlet Invoke-WebRequest para enviar uma solicitação GET para a API de Espaço Reservado JSON.

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

Se você usar curl, envie uma solicitação GET para a API de Espaço Reservado JSON usando o comando a seguir.

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

Você também pode usar um cliente de API como postman para enviar uma solicitação GET para https://jsonplaceholder.typicode.com/posts.

Na linha de comando em que o Proxy de Desenvolvimento está sendo executado, você verá as informações sobre a solicitação e a ação executada pelo Proxy de Desenvolvimento. Por padrão, o Proxy de Desenvolvimento simula uma resposta de erro com 50% de chance. Se sua solicitação não retornar um erro, o Proxy de Desenvolvimento o passará.

 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 o Proxy de Desenvolvimento retornar uma resposta de erro, você verá a mensagem de erro na saída.

 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 você não vir nenhuma saída no prompt de comando, é provável que o Proxy de Desenvolvimento não esteja interceptando solicitações. Verifique a seção problemas comuns para obter ajuda.

Interromper o Proxy de Desenvolvimento com segurança

Quando você não precisar mais que o Proxy de Desenvolvimento esteja em execução, você sempre deve pará-lo com segurança.

  • Pressione Ctrl + C para interromper com segurança o Proxy de Desenvolvimento.

Se você encerrar a sessão do prompt de comando, o Proxy de Desenvolvimento não cancelará o registro corretamente como proxy do sistema, e você poderá ter alguns problemas comuns.

Próxima etapa

Saiba como configurar o Proxy de Desenvolvimento de acordo com suas necessidades. O Proxy de Desenvolvimento é altamente flexível e dá suporte a muitos cenários diferentes. Saiba mais sobre como configurá-lo para seu cenário específico.

Configurar o Proxy de Desenvolvimento