

# Uso de um proxy HTTP para a AWS CLI
<a name="cli-configure-proxy"></a>

Para acessar a AWS por meio de servidores de proxy, é possível configurar as variáveis de ambiente `HTTP_PROXY` e `HTTPS_PROXY` com os nomes de domínio DNS ou endereços IP e números de porta usados pelos servidores de proxy.

**Topics**
+ [

## Como usar os exemplos da
](#cli-configure-proxy-using)
+ [

## Autenticar para um proxy
](#cli-configure-proxy-auth)
+ [

## Uso de proxy em instâncias do Amazon EC2
](#cli-configure-proxy-ec2)
+ [

## Solução de problemas
](#cli-configure-proxy-tshoot)

## Como usar os exemplos da
<a name="cli-configure-proxy-using"></a>

**nota**  
Os exemplos a seguir mostram o nome da variável de ambiente com todas as letras maiúsculas. No entanto, se você especificar uma variável duas vezes usando letras maiúsculas e minúsculas, as minúsculas terão precedência. Recomendamos que você defina cada variável somente uma vez para evitar confusão e comportamento inesperado do sistema.

Os exemplos a seguir mostram como você pode usar o endereço IP explícito do proxy ou um nome de DNS que seja resolvido para o endereço IP do proxy. Também pode ser seguido por uma vírgula e o número da porta para a qual as consultas devem ser enviadas.

------
#### [ Linux or macOS ]

```
$ export HTTP_PROXY=http://10.15.20.25:1234
$ export HTTP_PROXY=http://proxy.example.com:1234
$ export HTTPS_PROXY=http://10.15.20.25:5678
$ export HTTPS_PROXY=http://proxy.example.com:5678
```

------
#### [ Windows Command Prompt ]

**Como definir para todas as sessões**

```
C:\> setx HTTP_PROXY http://10.15.20.25:1234
C:\> setx HTTP_PROXY http://proxy.example.com:1234
C:\> setx HTTPS_PROXY http://10.15.20.25:5678
C:\> setx HTTPS_PROXY http://proxy.example.com:5678
```

O uso de [https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/setx](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/setx) para definir uma variável de ambiente altera o valor usado na sessão de prompt de comando atual e todas as sessões de prompt de comando que você criar após a execução do comando. ***Não*** afeta outros shells de comando que já estejam em execução no momento em que você executar o comando.

**Como definir somente para a sessão atual**

O uso de `[set](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/set_1)` para definir uma variável de ambiente altera o valor usado até o final da sessão de prompt de comando atual ou até que você defina a variável como um valor diferente. 

```
C:\> set HTTP_PROXY=http://10.15.20.25:1234
C:\> set HTTP_PROXY=http://proxy.example.com:1234
C:\> set HTTPS_PROXY=http://10.15.20.25:5678
C:\> set HTTPS_PROXY=http://proxy.example.com:5678
```

------

## Autenticar para um proxy
<a name="cli-configure-proxy-auth"></a>

**nota**  
A AWS CLI não é compatível com proxies NTLM. Se você usa um proxy de protocolo NTLM ou Kerberos, talvez seja possível se conectar por meio de um proxy de autenticação, como [Cntlm](http://cntlm.sourceforge.net).

O AWS CLI é compatível com a autenticação básica HTTP. Especifique o nome do usuário e uma senha no URL de proxy da forma a seguir. 

------
#### [ Linux or macOS ]

```
$ export HTTP_PROXY=http://username:password@proxy.example.com:1234
$ export HTTPS_PROXY=http://username:password@proxy.example.com:5678
```

------
#### [ Windows Command Prompt ]

**Como definir para todas as sessões**

```
C:\> setx HTTP_PROXY http://username:password@proxy.example.com:1234
C:\> setx HTTPS_PROXY http://username:password@proxy.example.com:5678
```

**Como definir somente para a sessão atual**

```
C:\> set HTTP_PROXY=http://username:password@proxy.example.com:1234
C:\> set HTTPS_PROXY=http://username:password@proxy.example.com:5678
```

------

## Uso de proxy em instâncias do Amazon EC2
<a name="cli-configure-proxy-ec2"></a>

Se você configurar um proxy em uma instância do Amazon EC2 iniciada com uma função do IAM anexada, certifique-se de isentar o endereço usado do acesso aos [metadados da instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html). Para fazer isso, defina a variável de ambiente `NO_PROXY` como o endereço IP do serviço de metadados da instância 169.254.169.254. Esse endereço não varia.

------
#### [ Linux or macOS ]

```
$ export NO_PROXY=169.254.169.254
```

------
#### [ Windows Command Prompt ]

**Como definir para todas as sessões**

```
C:\> setx NO_PROXY 169.254.169.254
```

**Como definir somente para a sessão atual**

```
C:\> set NO_PROXY=169.254.169.254
```

------

## Solução de problemas
<a name="cli-configure-proxy-tshoot"></a>

Se você encontrar problemas com a AWS CLI, consulte [Solução de problemas da AWS CLI](cli-chap-troubleshooting.md) para obter as etapas de solução de problemas. Para obter as etapas mais relevantes de solução de problemas, consulte [Erros de certificado SSL](cli-chap-troubleshooting.md#tshoot-certificate-verify-failed).