Installation de l'interface de ligne de commande (CLI) AWS Encryption SDK

Cette rubrique explique comment installer le pluginAWSCLI de chiffrement. Pour plus d'informations, consultez le pluginaws-encryption-sdk-cliréférentiel sur GitHub etLire la documentation.

Installation des éléments prérequis

Dans laAWSLa CLI de chiffrement repose sur le pluginKit SDK de chiffrement AWS pour Python. Pour installerAWSCLI de chiffrement, vous avez besoin de Python etpip, l'outil de gestion de paquets Python. Python et pip sont disponibles sur toutes les plateformes prises en charge.

Installez les conditions préalables suivantes avant d'installer le pluginAWSCLI de chiffrement,

Python

Python 3.6 ou version ultérieure est requis par le pluginAWSVersions de l'interface de commande 4.1.0 et ultérieures ultérieures.

Versions antérieures de laAWSL'interface de ligne de commande Encryption prend en charge Python 2.7 et 3.4 et versions ultérieures, mais nous vous recommandons d'utiliser la dernière version deAWSCLI de chiffrement.

Python est inclus dans la plupart des installations Linux et macOS, mais vous devez effectuer une mise à niveau vers Python 3.6 ou version ultérieure. Nous vous recommandons d'utiliser la dernière version de Python. Sur Windows, vous devez installer Python ; il n'est pas installé par défaut. Pour télécharger et installer Python, consultezTéléchargements Python.

Pour déterminer si Python est installé, dans la ligne de commande, tapez les informations suivantes.

python

Pour vérifier la version de Python, utilisez le paramètre -V (V majuscule).

python -V

Sous Windows, après avoir installé Python, ajoutez le chemin d'accès auPython.exefichier à la valeur deChemin d'accèsvariable d'environnement.

Par défaut, Python est installé dans le répertoire de tous les utilisateurs ou dans un répertoire de profil utilisateur ($home ou %userprofile%) dans le sous-répertoire AppData\Local\Programs\Python. Pour trouver l'emplacement du fichier Python.exe sur votre système, consultez l'une des clés de registre suivante. Vous pouvez utiliser PowerShell pour effectuer une recherche dans le registre.

PS C:\> dir HKLM:\Software\Python\PythonCore\version\InstallPath
# -or-
PS C:\> dir HKCU:\Software\Python\PythonCore\version\InstallPath

pip

pip est le gestionnaire de packages Python. Pour installerAWSLa CLI de chiffrement et ses dépendances, vous avez besoinpip8.1 ou version ultérieure. Pour obtenir de l'aide pour installer ou mettre à niveau pip, veuillez consulter Installation dans la documentation de pip.

Sur les installations Linux, les versions depipune version antérieure à 8.1 ne peut pas construire lecryptographiebibliothèque que leAWSLa CLI de chiffrement nécessite. Si vous choisissez de ne pas mettre à jour votrepipversion, vous pouvez installer les outils de construction séparément. Pour plus d'informations, consultez Création du chiffrement sous Linux.

AWS Command Line Interface

Dans laAWS Command Line Interface(AWS CLI) n'est obligatoire que si vous utilisezAWS KMS keysdansAWS Key Management Service(AWS KMS) avecAWSCLI de chiffrement. Si vous utilisez un autre fournisseur de clés principales, l'AWS CLI n'est pas requise.

À utiliserAWS KMS keysavec leAWSEncryption CLI, vous devezinstalleretconfigurerleAWS CLI. La configuration définit les informations d'identification que vous utilisez pour vous authentifierAWS KMSdisponible pour leAWSCLI de chiffrement.

Installation et mise à jour duAWSCLI de chiffrement

Installez la dernière version de l'AWSCLI de chiffrement. Lorsque vous utilisezpippour installerAWSEncryption CLI, il installe automatiquement les bibliothèques dont l'interface de ligne de commande a besoin, y comprisKit SDK de chiffrement AWS pour Python, le Pythonbibliothèque de cryptographie, et leAWS SDK for Python (Boto3).

Note

Versions duAWSLes CLI de chiffrement antérieures à 4.0.0 se trouvent dans le pluginend-of-supportphase.

Vous pouvez effectuer une mise à niveau à partir de la version 2.1xet plus tard vers la dernière version duAWSCryptage CLI sans aucune modification du code ou des données. Cependant,nouvelles fonctions de sécuritéintroduit dans la version 2.1.xne sont pas rétrocompatibles. Pour effectuer une mise à niveau depuis la version 1.7xou une version antérieure, vous devez d'abord la mettre à jour vers la dernière version 1.xversion duAWSCLI de chiffrement. Pour plus d'informations, consultez.Migrer votreAWS Encryption SDK

Les nouvelles fonctionnalités de sécurité ont été initialement publiées enAWSVersions de chiffrement 1.7.xet 2.0.x. Cependant,AWSVersion 1.8 de la CLI de chiffrementxremplace la version 1.7.xetAWSChiffrement CLI 2.1.xremplace 2.0.x. Pour plus d'informations, consultez la page pertinenteavis de sécuritédans leaws-encryption-sdk-cliréférentiel sur GitHub.

Pour installer la dernière version de l'AWSCLI de chiffrement

pip install aws-encryption-sdk-cli

Pour effectuer une mise à niveau vers la dernière version de l'AWSCLI de chiffrement

pip install --upgrade aws-encryption-sdk-cli

Pour trouver les numéros de version de votreAWSCLI de chiffrement etAWS Encryption SDK

aws-encryption-cli --version

La sortie répertorie les numéros de version des deux bibliothèques.

aws-encryption-sdk-cli/2.1.0 aws-encryption-sdk/2.0.0

Pour effectuer une mise à niveau vers la dernière version de l'AWSCLI de chiffrement

pip install --upgrade aws-encryption-sdk-cli

Installation deAWSEncryption CLI installe également la dernière version de la dernière version de l'AWS SDK for Python (Boto3), si ce n'est pas déjà fait. Si Boto3 est installé, le programme d'installation vérifie la version de Boto3 et la met à jour si nécessaire.

Pour trouver la version de Boto3 que vous avez installée

pip show boto3

Pour effectuer une mise à niveau vers la dernière version de Boto3

pip install --upgrade boto3

Pour installer la version deAWSEncryption CLI en cours de développement, voir leaws-encryption-sdk-cliréférentiel sur GitHub.

Pour de plus amples informations sur l'utilisation de pip pour installer et mettre à niveau les packages Python, veuillez consulter la documentation pip.