Utilisation d’un proxy HTTP pour l’AWS CLI

Pour accéder à AWS via des serveurs proxy, vous pouvez configurer les variables d’environnement HTTP_PROXY et HTTPS_PROXY avec les noms de domaine DNS ou les adresses IP et les numéros de port utilisés par vos serveurs proxy.

Utilisation des exemples

Note

Les exemples suivants montrent le nom de la variable d’environnement en majuscules. Toutefois, si vous spécifiez une variable deux fois en utilisant des casses différentes, les lettres minuscules ont la priorité. Nous vous recommandons de ne définir chaque variable qu’une seule fois pour éviter toute confusion système et tout comportement inattendu.

Les exemples suivants illustrent comment vous pouvez utiliser l’adresse IP explicite de votre proxy ou un nom DNS qui est résolu sur l’adresse IP de votre proxy. Chacun peut être suivi d’un signe deux-points et du numéro de port auquel les requêtes doivent être envoyées.

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

Définition pour toutes les sessions

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 

L’utilisation de setx pour définir une variable d’environnement modifie la valeur utilisée dans la session d’invite de commande en cours et toutes les sessions d’invite de commande que vous créez après l’exécution de la commande. Cela n’affecte pas les autres shells de commande qui sont déjà en cours d’exécution lorsque vous exécutez la commande.

Définition pour la session en cours uniquement

L’utilisation de set pour définir une variable d’environnement modifie la valeur utilisée jusqu’à la fin de la session d’invite de commande en cours, ou jusqu’à ce que vous définissiez la variable sur une autre valeur.

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 

Authentification auprès d’un proxy

Note

L’AWS CLI ne prend pas en charge les proxys NTLM. Si vous utilisez un proxy de protocole NTLM ou Kerberos, vous pouvez vous connecter via un proxy d’authentification tel que Cntlm.

L’AWS CLI prend en charge l’authentification de base HTTP. Spécifiez le nom d’utilisateur et le mot de passe dans l’URL de proxy comme suit.

Linux or macOS

$ export HTTP_PROXY=http://username:[e-mail]:1234
$ export HTTPS_PROXY=http://username:[e-mail]:5678

Windows Command Prompt

Définition pour toutes les sessions

C:\> setx HTTP_PROXY http://username:[e-mail]:1234
C:\> setx HTTPS_PROXY http://username:[e-mail]:5678

Définition pour la session en cours uniquement

C:\> set HTTP_PROXY=http://username:[e-mail]:1234
C:\> set HTTPS_PROXY=http://username:[e-mail]:5678

Utilisation d’un proxy sur les instances Amazon EC2

Si vous configurez un proxy sur une instance Amazon EC2 lancée avec un rôle IAM attaché, veillez à exclure l’adresse utilisée pour accéder aux métadonnées de l’instance. Pour ce faire, définissez la variable d’environnement NO_PROXY sur l’adresse IP du service de métadonnées de l’instance, 169.254.169.254. Cette adresse ne varie pas.

Linux or macOS

$ export NO_PROXY=169.254.169.254

Windows Command Prompt

Définition pour toutes les sessions

C:\> setx NO_PROXY 169.254.169.254

Définition pour la session en cours uniquement

C:\> set NO_PROXY=169.254.169.254

Résolution des problèmes

Si vous rencontrez des problèmes avec l’AWS CLI, consultez Résolution des erreurs liées à l’AWS CLI pour les étapes de dépannage. Pour connaître les étapes de résolution de problèmes les plus pertinentes, consultez Erreurs liées à un certificat SSL.