Uso de un proxy HTTP para la AWS CLI - AWS Command Line Interface

Uso de un proxy HTTP para la AWS CLI

Para acceder a AWS a través de servidores proxy, puede configurar las variables de entorno HTTP_PROXY y HTTPS_PROXY con los nombres de dominio de DNS o con las direcciones IP y los números de puerto que utilizan los servidores proxy.

Uso de los ejemplos de la

nota

En los ejemplos siguientes, se muestra el nombre de la variable de entorno con todas las letras en mayúscula. Sin embargo, si especifica una variable dos veces utilizando mayúsculas y minúsculas diferentes, prevalecen las letras minúsculas. Recomendamos que defina cada variable solo una vez para evitar la confusión de sistema y un comportamiento inesperado.

Los siguientes ejemplos muestran cómo puede utilizar la dirección IP explícita de su proxy o un nombre de DNS que se resuelve en la dirección IP de su proxy. Cualquiera puede ir seguido de dos puntos y el número de puerto al que se deben enviar las consultas.

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

Para configurar todas las sesiones

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

El uso de setx para establecer una variable de entorno cambia el valor usado en la sesión de símbolo del sistema actual y en todas las sesiones de símbolo del sistema que cree después de ejecutar el comando. La operación no afecta a otros comandos del shell que ya se están ejecutando en el momento de ejecutar el comando.

Para configurar solo para la sesión actual

El uso de set para configurar una variable de entorno cambia el valor usado hasta que finalice la sesión de símbolo de sistema actual o hasta que otorgue a la variable un 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

Autenticación en un proxy

nota

La AWS CLI no admite servidores proxy NTLM. Si utiliza un proxy del protocolo NTLM o Kerberos, es posible que pueda conectarse a través de un proxy de autenticación como Cntlm.

La AWS CLI admite la autenticación básica de HTTP. Especifique el nombre de usuario y la contraseña en la URL del proxy como se indica a continuación.

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

Para configurar todas las sesiones

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

Para configurar solo la sesión actual

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

Uso de un proxy en instancias Amazon EC2

Si configura un proxy en una instancia de Amazon EC2 que se ha lanzado con un rol de IAM asociado, asegúrese de excluir la dirección utilizada para obtener acceso a los metadatos de la instancia. Para ello, establezca la variable de entorno NO_PROXY en la dirección IP del servicio de metadatos de la instancia, 169.254.169.254. Esta dirección no varía.

Linux or macOS
$ export NO_PROXY=169.254.169.254
Windows Command Prompt

Para configurar todas las sesiones

C:\> setx NO_PROXY 169.254.169.254

Para configurar solo la sesión actual

C:\> set NO_PROXY=169.254.169.254

Resolución de problemas

Si encuentra problemas con la AWS CLI, consulte Solución de errores para la AWS CLI para los pasos de resolución de problemas. Para conocer los pasos más relevantes de la resolución de problemas, consulte Errores de certificado SSL.