Installation de l'interface AWS Encryption SDK de ligne de commande - AWS Encryption SDK
Installation des éléments prérequisInstallation de l’interface de ligne de commande (CLI)

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.

Installation de l'interface AWS Encryption SDK de ligne de commande

Cette rubrique explique comment installer la CLI AWS de chiffrement. Pour des informations détaillées, consultez le aws-encryption-sdk-cliréférentiel sur GitHub et lisez les documents.

Installation des éléments prérequis

La CLI de AWS chiffrement est basée sur le Kit SDK de chiffrement AWS pour Python. Pour installer la CLI de AWS chiffrement, vous avez besoin de Python et pip de l'outil de gestion de paquets Python. Python et pip sont disponibles sur toutes les plateformes prises en charge.

Installez les prérequis suivants avant d'installer la CLI de AWS chiffrement :

Python

Python 3.8 ou version ultérieure est requis par les versions 4.2.0 et ultérieures de la CLI de AWS chiffrement.

Les versions antérieures de la CLI de AWS chiffrement prennent en charge Python 2.7, 3.4 et versions ultérieures, mais nous vous recommandons d'utiliser la dernière version de la CLI de AWS chiffrement.

Python est inclus dans la plupart des installations Linux et macOS, mais vous devez passer à Python 3.6 ou version ultérieure. Nous vous recommandons d'utiliser la dernière version de Python. Sous Windows, vous devez installer Python ; il n'est pas installé par défaut. Pour télécharger et installer Python, consultez la section Téléchargements de 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 du Python.exe fichier à la valeur de la variable d'environnement Path.

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 l'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 installer la CLI de AWS chiffrement et ses dépendances, vous devez disposer de la pip version 8.1 ou 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 pip antérieures à 8.1 ne peuvent pas créer la bibliothèque de cryptographie requise par la CLI de AWS chiffrement. Si vous choisissez de ne pas mettre à jour votre pip version, vous pouvez installer les outils de compilation séparément. Pour plus d'informations, consultez Création du chiffrement sous Linux.

AWS Command Line Interface

Le AWS Command Line Interface (AWS CLI) n'est obligatoire que si vous utilisez AWS KMS keys in AWS Key Management Service (AWS KMS) avec la CLI de AWS chiffrement. Si vous utilisez un autre fournisseur de clé principale, ce n' AWS CLI est pas obligatoire.

Pour l'utiliser AWS KMS keys avec la CLI de AWS chiffrement, vous devez installer et configurer le AWS CLI. La configuration met les informations d'identification que vous utilisez pour vous authentifier à la AWS KMS disposition de la CLI de AWS chiffrement.

Installation et mise à jour de la CLI AWS de chiffrement

Installez la dernière version de la CLI de AWS chiffrement. Lorsque vous installez pip la CLI de AWS chiffrement, elle installe automatiquement les bibliothèques dont elle a besoin, notamment la Kit SDK de chiffrement AWS pour Pythonbibliothèque de cryptographie Python et le. AWS SDK for Python (Boto3)

Note

Les versions de la CLI de AWS chiffrement antérieures à la version 4.0.0 sont en end-of-supportcours de phase.

Vous pouvez effectuer la mise à jour en toute sécurité à partir de la version 2.1. x et versions ultérieures vers la dernière version de la CLI de AWS chiffrement sans aucune modification du code ou des données. Cependant, de nouvelles fonctionnalités de sécurité ont été introduites dans la version 2.1. x ne sont pas rétrocompatibles. Pour effectuer une mise à jour à partir de la version 1.7. x ou version antérieure, vous devez d'abord effectuer la mise à jour vers la dernière version 1. version x de la CLI AWS de chiffrement. Pour plus de détails, consultez Migrer votreAWS Encryption SDK.

Les nouvelles fonctionnalités de sécurité ont été initialement publiées dans les versions 1.7 de la CLI de AWS chiffrement. x et 2.0. x. Cependant, AWS Encryption CLI version 1.8. x remplace la version 1.7. x et CLI de AWS chiffrement 2.1. x remplace 2.0. x. Pour plus de détails, consultez l'avis de sécurité correspondant dans le aws-encryption-sdk-cliréférentiel sur GitHub.

Pour installer la dernière version de la CLI de AWS chiffrement
pip install aws-encryption-sdk-cli
Pour effectuer une mise à niveau vers la dernière version de la CLI de AWS chiffrement
pip install --upgrade aws-encryption-sdk-cli
Pour trouver les numéros de version de votre CLI de AWS chiffrement et AWS Encryption SDK
aws-encryption-cli --version

Le résultat 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 la CLI de AWS chiffrement
pip install --upgrade aws-encryption-sdk-cli

L'installation de la CLI de AWS chiffrement installe également la dernière version de AWS SDK for Python (Boto3), si elle n'est pas déjà installée. 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 la mise à jour vers la dernière version de Boto3
pip install --upgrade boto3

Pour installer la version de la CLI de AWS chiffrement actuellement en cours de développement, consultez le aws-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.