Installation der AWS Encryption SDK Befehlszeilenschnittstelle

In diesem Thema wird erklärt, wie die AWS Encryption CLI installiert wird. Ausführliche Informationen finden Sie im aws-encryption-sdk-cliRepository unter GitHub und in der Dokumentation.

Installieren der Voraussetzungen

Die AWS Encryption CLI basiert auf dem AWS-Verschlüsselungs-SDK for Python. Um die AWS Encryption CLI zu installieren, benötigen Sie Python und pip das Python-Paketverwaltungstool. Python und pip stehen auf allen unterstützten Plattformen zur Verfügung.

Installieren Sie die folgenden Voraussetzungen, bevor Sie die AWS Encryption CLI installieren:

Python

Python 3.8 oder höher ist für die AWS Encryption CLI Versionen 4.2.0 und höher erforderlich.

Frühere Versionen der AWS Encryption CLI unterstützen Python 2.7 und 3.4 und höher, wir empfehlen jedoch, die neueste Version der AWS Encryption CLI zu verwenden.

Python ist in den meisten Linux- und macOS-Installationen enthalten, Sie müssen jedoch auf Python 3.6 oder höher aktualisieren. Wir empfehlen Ihnen, die neueste Version von Python zu verwenden. Unter Windows müssen Sie Python installieren; es ist standardmäßig nicht installiert. Informationen zum Herunterladen und Installieren von Python finden Sie unter Python-Downloads.

Um festzustellen, ob Python installiert ist, geben Sie in der Befehlszeile Folgendes ein.

python

Um die Python-Version zu überprüfen, verwenden Sie den Parameter -V (Großbuchstabe V).

python -V

Unter Windows fügen Sie nach der Installation von Python den Pfad zur Python.exe Datei zum Wert der Umgebungsvariablen Path hinzu.

Standardmäßig ist Python im Verzeichnis All Users oder in einem Benutzerprofilverzeichnis ($home oder %userprofile%) im Unterverzeichnis AppData\Local\Programs\Python installiert. Um den Speicherort der Datei Python.exe auf Ihrem System zu finden, überprüfen Sie einen der folgenden Registrierungsschlüssel. Sie können es verwenden PowerShell , um die Registrierung zu durchsuchen.

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

pip

pip ist der Python-Paketmanager. Um die AWS Encryption CLI und ihre Abhängigkeiten zu installieren, benötigen Sie pip 8.1 oder höher. Informationen zum Installieren und Aktualisieren von pip finden Sie unter Installation in der pip-Dokumentation.

Bei Linux-Installationen können pip Versionen vor 8.1 die Kryptografiebibliothek, die die AWS Encryption CLI benötigt, nicht erstellen. Wenn Sie Ihre pip Version nicht aktualisieren möchten, können Sie die Build-Tools separat installieren. Weitere Informationen finden Sie unter Kryptographie unter Linux.

AWS Command Line Interface

Das AWS Command Line Interface (AWS CLI) ist nur erforderlich, wenn Sie AWS KMS keys in AWS Key Management Service (AWS KMS) mit der AWS Encryption CLI verwenden. Wenn Sie einen anderen Hauptschlüsselanbieter verwenden, AWS CLI ist der nicht erforderlich.

Für die Verwendung AWS KMS keys mit der AWS Encryption CLI müssen Sie den installieren und konfigurieren AWS CLI. Die Konfiguration stellt die Anmeldeinformationen, die Sie zur Authentifizierung verwenden, für die AWS Encryption CLI zur AWS KMS Verfügung.

Installation und Aktualisierung der AWS Encryption CLI

Installieren Sie die neueste Version der AWS Encryption CLI. Wenn Sie die AWS Encryption CLI pip zur Installation verwenden, werden automatisch die Bibliotheken installiert, die die CLI benötigt, einschließlich der AWS-Verschlüsselungs-SDK for PythonPython-Kryptografiebibliothek und der AWS SDK for Python (Boto3).

Anmerkung

Versionen der AWS Encryption CLI vor 4.0.0 befinden sich in der end-of-supportPhase.

Sie können problemlos von Version 2.1 aus aktualisieren. x und höher auf die neueste Version der AWS Encryption CLI ohne Code- oder Datenänderungen. In Version 2.1 wurden jedoch neue Sicherheitsfunktionen eingeführt. x sind nicht abwärtskompatibel. Um von Version 1.7 zu aktualisieren. x oder früher, Sie müssen zuerst auf die neueste Version 1 aktualisieren. x-Version der AWS Encryption CLI. Details hierzu finden Sie unter Migrieren Sie IhreAWS Encryption SDK.

Neue Sicherheitsfunktionen wurden ursprünglich in den AWS Encryption CLI Versionen 1.7 veröffentlicht. x und 2.0. x. Allerdings AWS Encryption CLI Version 1.8. x ersetzt Version 1.7. x und AWS Encryption CLI 2.1. x ersetzt 2.0. x. Einzelheiten finden Sie in der entsprechenden Sicherheitsempfehlung im aws-encryption-sdk-cliRepository unter GitHub.

Um die neueste Version der AWS Encryption CLI zu installieren

pip install aws-encryption-sdk-cli

Um auf die neueste Version der AWS Encryption CLI zu aktualisieren

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

Um die Versionsnummern Ihrer AWS Encryption CLI zu finden und AWS Encryption SDK

aws-encryption-cli --version

In der Ausgabe werden die Versionsnummern beider Bibliotheken aufgeführt.

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

Um auf die neueste Version der AWS Encryption CLI zu aktualisieren

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

Durch die Installation der AWS Encryption CLI wird auch die neueste Version von installiert AWS SDK for Python (Boto3), sofern sie nicht bereits installiert ist. Wenn Boto3 installiert ist, überprüft das Installationsprogramm die Boto3-Version und aktualisiert sie bei Bedarf.

Um Ihre installierte Version von Boto3 zu finden

pip show boto3

Um auf die neueste Version von Boto3 zu aktualisieren

pip install --upgrade boto3

Informationen zur Installation der Version der AWS Encryption CLI, die sich derzeit in der Entwicklung befindet, finden Sie im aws-encryption-sdk-cliRepository unter GitHub.

Weitere Informationen zur Verwendung von pip für die Installation und die Aktualisierung von Python-Paketen finden Sie in der pip-Dokumentation.