AWS Encryption SDK コマンドラインインターフェイスのインストール

このトピックでは AWS Encryption CLI をインストールする方法について説明します。詳細については、「」を参照してください。aws-encryption-sdk-clirepository on GitHub そしてDocs を読む。

前提条件のインストール

AWS Encryption CLI は、AWS Encryption SDK for Python をベースにして構築されています。AWS Encryption CLI をインストールするには、Python と Python のパッケージ管理ツールである pip が必要です。Python と pip は、サポートされているすべてのプラットフォームで使用できます。

AWS Encryption CLI をインストールする前に、次の前提条件をインストールします。

Python

AWS Encryption CLI バージョン 4.1.0 以降には、Python 3.6 以降が必要です。

AWS Encryption CLI の以前のバージョンでは Python 2.7 および Python 3.4 以降がサポートされていますが、最新バージョンの AWS Encryption CLI を使用することをお勧めします。

Python は、ほとんどの Linux と macOS のインストールに含まれていますが、Python 3.6 以降にアップグレードする必要があります。最新バージョンの Python の使用をお勧めします。Windows では Python をインストールする必要があります。デフォルトではインストールされていません。Python をダウンロードしてインストールするには、「Python のダウンロード」を参照してください。

Python がインストールされているかどうかを確認するには、コマンドラインで次のように入力します。

python

Python のバージョンを確認するには -V (大文字 V) パラメータを使用します。

python -V

Windows では、Python をインストールしたら、Python.exe ファイルのパスを Path 環境変数の値に追加します。

デフォルトでは、$home サブディレクトリの Python がインストールされているすべてのユーザーまたはユーザープロファイルディレクトリ内 (%userprofile% または AppData\Local\Programs\Python) にあります。システム内の Python.exe ファイルの場所を確認するには、次のいずれかのレジストリキーを確認します。以下を使用できます PowerShell レジストリを検索する。

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

pip

pip は Python パッケージマネージャーです。AWS Encryption CLI とその依存関係をインストールするには、pip 8.1 以降が必要です。pip のインストールまたはアップグレードのヘルプについては、pip ドキュメントの「インストール」を参照してください。

Linux インストールでは、pip の 8.1 より前のバージョンにより、AWS Encryption CLI で必要となる cryptography ライブラリを構築できません。pip バージョンを更新しないことを選択した場合は、ビルドツールを個別にインストールできます。詳細については、「Building cryptography on Linux」を参照してください。

AWS Command Line Interface

AWS Command Line Interface (AWS CLI) は、AWS Encryption CLI を含む AWS Key Management Service (AWS KMS) で AWS KMS keys を使用する場合にのみ必要です。別のマスターキープロバイダーを使用している場合、AWS CLI は必要ありません。

AWS Encryption CLI で AWS KMS keys を使用するには、AWS CLI のインストールと構成が必要です。この設定により AWS KMS への認証に使用する認証情報が作成されます。AWS Encryption CLI で使用できます。

のインストールと更新AWSEncryption CLI

最新バージョンのをインストールするAWSEncryption CLI。pip を使用して AWS Encryption CLI をインストールすると、AWS Encryption SDK for Python、Python cryptography ライブラリ、AWS SDK for Python (Boto3) など、CLI で必要となるライブラリが自動的にインストールされます。

注記

のバージョンAWSEncryption CLI が 4.0.0 より前である場合はend-of-support段階。

バージョン 2.1 から安全に更新できます。xそして後で最新バージョンにAWSコードやデータの変更なしの暗号化 CLI。ただし、新しいセキュリティ機能バージョン 2.1 で導入されました。x下位互換性はありません。をバージョン 1.7 から更新する。x以前である場合は、まず最新の 1 に更新する必要があります。xのバージョンAWSEncryption CLI。詳細については、「移行するAWS Encryption SDK」を参照してください。

新しいセキュリティ機能は、AWS Encryption CLI バージョン 1.7.x および 2.0.x で最初にリリースされました。ただし、AWS Encryption CLI バージョン 1.7.x はバージョン 1.8.x に、AWS Encryption CLI 2.0.x は 2.1.x に置き換わります。詳細については、関連の「」を参照してください。セキュリティ勧告()aws-encryption-sdk-clirepository on GitHub。

AWS Encryption CLI の最新バージョンをインストールするには

pip install aws-encryption-sdk-cli

AWS Encryption CLI の最新バージョンにアップグレードするには

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

AWS Encryption CLI と AWS Encryption SDK のバージョン番号を確認するには

aws-encryption-cli --version

出力には、両方のライブラリのバージョン番号が表示されます。

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

AWS Encryption CLI の最新バージョンにアップグレードするには

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

AWS Encryption CLI をインストールすると、AWS SDK for Python (Boto3) の最新バージョンがまだインストールされていない場合、それもインストールされます。Boto3 がインストールされている場合、インストーラは Boto3 のバージョンを確認し、必要に応じて更新します。

インストールされている Boto3 のバージョンを確認するには

pip show boto3

Boto3 の最新バージョンに更新するには

pip install --upgrade boto3

のバージョンをインストールするAWS暗号化 CLI は現在開発中です。を参照してください。aws-encryption-sdk-clirepository on GitHub。

pip を使用した Python パッケージのインストールおよびアップグレードの詳細については、pip のドキュメントを参照してください。