Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Cette rubrique explique comment configurer rapidement les paramètres de base avec lesquels le AWS Command Line Interface (AWS CLI) interagit AWS. Il s'agit notamment de vos informations de sécurité, du format de sortie par défaut et de la AWS région par défaut.
Rubriques
Rassemblez vos informations d'identification pour un accès programmatique
Vous aurez besoin d'un accès programmatique si vous souhaitez interagir avec AWS l'extérieur du AWS Management Console. Pour les instructions d'authentification et d'identification, choisissez l'une des options suivantes :
| Type d’authentification | Objectif | Instructions |
|---|---|---|
|
Identifiants à court terme des utilisateurs du personnel d'IAM Identity Center |
(Recommandé) Utilisez des informations d'identification à court terme pour un utilisateur du personnel d'IAM Identity Center. La meilleure pratique en matière de sécurité consiste AWS Organizations à utiliser IAM Identity Center. Il combine des informations d'identification à court terme avec un annuaire d'utilisateurs, tel que le répertoire intégré IAM Identity Center ou Active Directory. |
Configuration de l'authentification IAM Identity Center à l'aide du AWS CLI |
| Informations d'identification à court terme de l'utilisateur IAM | Utilisez les informations d'identification à court terme des utilisateurs IAM, qui sont plus sécurisées que les informations d'identification à long terme. Si vos informations d'identification sont compromises, elles peuvent être utilisées pendant une durée limitée avant leur expiration. | Authentification à l'aide d'informations d'identification à court terme pour AWS CLI |
| Utilisateurs d'IAM ou IAM Identity Center sur une instance Amazon EC2 . | Utilisez les métadonnées de l' EC2 instance Amazon pour demander des informations d'identification temporaires à l'aide du rôle attribué à l' EC2 instance Amazon. | Utilisation des métadonnées de l' EC2 instance Amazon comme informations d'identification dans AWS CLI |
| Assumer des rôles pour les autorisations | Associez une autre méthode d'identification et assumez un rôle pour un accès temporaire auquel Services AWS votre utilisateur n'a peut-être pas accès. | Utilisation d'un rôle IAM dans AWS CLI |
| Informations d'identification à long terme de l'utilisateur IAM | (Non recommandé) Utilisez des informations d'identification à long terme, qui n'ont pas d'expiration. | Authentification à l'aide des informations d'identification utilisateur IAM pour AWS CLI |
| Stockage externe des utilisateurs du personnel d'IAM ou d'IAM Identity Center | (Non recommandé) Associez une autre méthode d'identification mais stockez les valeurs d'identification dans un emplacement extérieur à. AWS CLI La sécurité de cette méthode dépend de l'emplacement externe dans lequel les informations d'identification sont stockées. | Obtenir des informations d'identification par le biais d'un processus externe dans le AWS CLI |
Configuration d'une nouvelle configuration et de nouvelles informations d'identification
AWS CLI Stocke vos informations de configuration et d'identification dans un profil (un ensemble de paramètres) dans les config fichiers credentials et.
Il existe principalement deux méthodes pour effectuer une configuration rapide :
Les exemples suivants utilisent des exemples de valeurs pour chacune des méthodes d'authentification. Remplacez les valeurs d'échantillon par les vôtres.
Configuration à l'aide de AWS CLI commandes
Pour une utilisation générale, les aws configure sso commandes aws configure ou de votre terminal préféré constituent le moyen le plus rapide de configurer votre AWS CLI
installation. En fonction de la méthode d'identification que vous préférez, vous êtes AWS CLI invité à saisir les informations pertinentes. Par défaut, les informations de ce profil sont utilisées lorsque vous exécutez une AWS CLI commande qui ne spécifie pas explicitement le profil à utiliser.
Pour plus d'informations sur les config fichiers credentials et, consultezParamètres des fichiers de configuration et d'identification dans le AWS CLI.
Cet exemple concerne AWS IAM Identity Center l'utilisation de l'aws configure ssoassistant. Pour de plus amples informations, veuillez consulter Configuration de l'authentification IAM Identity Center à l'aide du AWS CLI.
$ aws configure sso
SSO session name (Recommended): my-ssoSSO start URL [None]: https://my-sso-portal.awsapps.com/startSSO region [None]:us-east-1Attempting to automatically open the SSO authorization page in your default browser.
There are 2 AWS accounts available to you.
> DeveloperAccount, developer-account-admin@example.com (111122223333)
ProductionAccount, production-account-admin@example.com (444455556666)
Using the account ID 111122223333
There are 2 roles available to you.
> ReadOnly
FullAccess
Using the role name "ReadOnly"
CLI default client Region [None]: us-west-2CLI default output format [None]: jsonCLI profile name [123456789011_ReadOnly]: user1Pour des informations plus détaillées sur les méthodes d'authentification et d'identification, voirAuthentification et informations d'accès pour AWS CLI.
Modification manuelle des informations d'identification et des fichiers de configuration
Lorsque vous copiez et collez des informations, nous vous suggérons de modifier manuellement le credentials fichier config et. En fonction de la méthode d'identification que vous préférez, les fichiers sont configurés différemment.
Les fichiers sont stockés dans votre répertoire personnel, sous le .aws dossier. L'emplacement du répertoire de base varie selon le système d'exploitation, mais il est référencé à l'aide de variables d'environnement %UserProfile% sous Windows et $HOME ou ~ (tilde) sur les systèmes Unix. Pour plus d'informations sur l'emplacement de stockage de ces paramètres, consultezOù les paramètres de configuration sont-ils stockés ?.
Les exemples suivants montrent un default profil et un profil nommés user1 et utilisent des exemples de valeurs. Remplacez les valeurs d'échantillon par les vôtres. Pour plus d'informations sur les config fichiers credentials et, consultezParamètres des fichiers de configuration et d'identification dans le AWS CLI.
Cet exemple est pour AWS IAM Identity Center. Pour de plus amples informations, veuillez consulter Configuration de l'authentification IAM Identity Center à l'aide du AWS CLI.
Fichier d'informations d'identification
Le credentials fichier n'est pas utilisé pour cette méthode d'authentification.
Fichier de configuration
[default] sso_session =my-ssosso_account_id =111122223333sso_role_name =readOnlyregion =us-west-2output =text[profile user1] sso_session =my-ssosso_account_id =444455556666sso_role_name =readOnlyregion =us-east-1output =json[sso-sessionmy-sso] sso_region =us-east-1sso_start_url =https://my-sso-portal.awsapps.com/startsso_registration_scopes =sso:account:access
Pour des informations plus détaillées sur les méthodes d'authentification et d'identification, voirAuthentification et informations d'accès pour AWS CLI.
Utilisation des fichiers de configuration et d'identification existants
Si vous disposez de fichiers de configuration et d'informations d'identification existants, ceux-ci peuvent être utilisés pour le AWS CLI.
Pour utiliser les credentials fichiers config et, déplacez-les vers le dossier nommé .aws dans votre répertoire personnel. L'emplacement du répertoire de base varie selon le système d'exploitation, mais il est référencé à l'aide de variables d'environnement %UserProfile% sous Windows et $HOME ou ~ (tilde) sur les systèmes Unix.
Vous pouvez spécifier un emplacement autre que celui par défaut pour les credentials fichiers config et en définissant les variables d'AWS_SHARED_CREDENTIALS_FILEenvironnement AWS_CONFIG_FILE et sur un autre chemin local. Consultez Configuration des variables d'environnement pour AWS CLI pour plus de détails.
Pour des informations plus détaillées sur les fichiers de configuration et d'identification, consultezParamètres des fichiers de configuration et d'identification dans le AWS CLI.
