Configurações de proxy

O Dev Proxy vem com várias configurações que você pode usar para controlar como o proxy deve ser executado.

Você pode definir essas configurações definindo-as no arquivo devproxyrc.json , localizado na pasta de instalação do proxy, ou definindo-as em tempo de execução por meio de opções de linha de comando.

A tabela a seguir descreve as configurações.

Configuração	Descrição	Opção de linha de comando	Valores permitidos	Valor padrão
apiAllowedOrigins	Origens exatas do navegador que podem chamar a API de Proxy de Desenvolvimento. Todas as solicitações ainda exigem o token de portador da instância.	N/D	Matriz de origens HTTP ou HTTPS sem caminhos, curingas ou barras à direita, por exemplo, ["http://127.0.0.1:3000"]	[]
apiIpAddress	O endereço IP para a API de Proxy de Desenvolvimento a ser associada. Essa configuração é independente de ipAddress. Use um endereço não loopback somente em redes confiáveis porque os tokens de portador são enviados por HTTP.	--api-ip-address <apiIpAddress>	Endereço IPv4 ou IPv6	127.0.0.1
apiPort	A porta para a API de Proxy de Desenvolvimento autenticada a ser escutada. Defina para 0 permitir que o sistema operacional atribua uma porta disponível aleatória.	--api-port <apiPort>	inteiro	8897
asSystemProxy	Se o Proxy de Desenvolvimento deve ser registrado como o proxy do sistema na inicialização. Quando definido como true requer ser installCert , defina como true	--as-system-proxy	true, false	true
env	Variáveis de ambiente a serem definidas para o processo de Proxy de Desenvolvimento. O Proxy de Desenvolvimento os define depois de carregar o arquivo de configuração e antes de carregar plug-ins, para que os plug-ins que leem variáveis de ambiente usem esses valores. O Proxy de Desenvolvimento também os usa para substituir {name} espaços reservados em arquivos de especificação de API usados pelos plug-ins MinimalPermissions. Valores passados com --env valores de substituição do arquivo de configuração. As alterações em HTTP_PROXY, HTTPS_PROXYou ALL_PROXYNO_PROXY (incluindo variantes minúsculas) exigem parar e iniciar o Proxy de Desenvolvimento porque o recarregamento dinâmico não pode atualizar as configurações de proxy HTTP armazenadas em cache.	-e, --env <env>	Objeto com valores de cadeia de caracteres, por exemplo; {"CI": "1"}na linha de comando, um ou mais pares separados por name=value espaço	N/D
filterByHeaders	Intercepte apenas solicitações com cabeçalhos específicos	N/D	{"filterByHeaders": [ { "name": "value" } ] }. O valor pode estar vazio para incluir solicitações com o cabeçalho especificado, independentemente do valor.	N/D
installCert	Se o certificado raiz deve ser instalado	--install-cert	true, false	true
ipAddress	O endereço IP ao qual o proxy se associa	--ip-address <ipAddress>	Endereço IPv4	127.0.0.1
languageModel	Configurações para o modelo de linguagem	N/D	Consulte a seção de modelo de linguagem para obter mais informações.	N/D
logLevel	Nível de mensagens a serem registradas	--log-level <loglevel>	trace, debug, information, warning, error	information
newVersionNotification	Se deve notificar sobre novas versões	N/D	none, stable, beta	stable
noColor	Desabilitar saída colorida	--no-color	N/D	N/D
noFirstRun	Ignorar a experiência de primeira execução (não confiar no certificado no macOS)	--no-first-run	N/D	N/D
noWatch	Desabilitar a reinicialização automática do proxy quando o arquivo de configuração for alterado	--no-watch	N/D	N/D
output	Formato de saída para registro em log estruturado	--output <format>	text, json	text
port	A porta para o servidor proxy escutar. Defina para 0 permitir que o sistema operacional atribua uma porta disponível aleatória.	-p, --port <port>	inteiro	8000
record	Use essa opção para registrar todos os logs de solicitação	--record	N/D	N/D
showSkipMessages	Se as mensagens de log devem ser exibidas quando o Dev Proxy ignora a execução de um plug-in.	N/D	true, false	true
showTimestamps	Se os carimbos de data/hora de solicitação devem ser mostrados na saída de log interativa. Os arquivos de log desanexados sempre incluem carimbos de data/hora completos, para que você possa filtrá-los por data e hora.	N/D	true, false	true
timeoutSeconds	Tempo em segundos após o qual o Proxy de Desenvolvimento é encerrado. Redefine quando o Proxy de Desenvolvimento intercepta uma solicitação.	-t, --timeout <seconds>	inteiro positivo	N/D
urlsToWatch	Lista de URLs que o proxy deve interceptar	-u, --urls-to-watch <urlsToWatch>	URL absoluta (pode conter curingas), por exemplo, "https://api.contoso.com/*"	Veja o arquivo devproxyrc
validateSchemas	Se deve validar a configuração em relação ao esquema especificado. Aplica-se somente a arquivos de configuração JSON.	N/D	true, false	true
watchPids	As IDs dos processos a serem observados para solicitações	--watch-pids <pids>	matriz de inteiros; na linha de comando, um ou mais inteiros separados por espaço	N/D
watchProcessNames	Os nomes dos processos a serem observados para solicitações	--watch-process-names <processNames>	matriz de cadeias de caracteres; na linha de comando, um ou mais nomes separados por espaço	N/D
watchProcessTree	Se também observar descendentes (processos filho) de processos selecionados por watchPids ou watchProcessNames	--watch-process-tree	true, false	false

Observação

A taxa de falha não é uma configuração de proxy. Para configurá-la, defina a rate propriedade na seção de configuração do GenericRandomErrorPlugin ou GraphRandomErrorPlugin ou use a opção -f, --failure-rate de linha de comando quando um desses plug-ins for carregado.