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

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

このトピックでは AWS Encryption CLI をインストールする方法について説明します。詳細については、GitHub の aws-encryption-sdk-cli リポジトリおよび「ドキュメントを読む」を参照してください。

前提条件のインストール

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 で使用できます。

AWS Encryption CLI のインストールとアップデート

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

注記

4.0.0 より前のバージョンの AWS 暗号化 CLI は「サポート終了段階」にあります。

バージョン 2.1.x 以降から、コードやデータを変更せずに最新バージョンの AWS Encryption CLI に安全に更新できます。ただし、バージョン 2.1.x で導入された 新しいセキュリティ機能 には下位互換性がありません。バージョン 1.7.x、またはそれ以前からアップデートする場合は、まず AWS Encryption CLI の最新の 1.x バージョンに更新する必要があります。詳細については、「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 に置き換わります。詳細については、GitHub の aws-encryption-sdk-cli リポジトリで関連するセキュリティアドバイザリを参照してください。

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 Encryption CLI の現在のバージョンをインストールするには、GitHub の aws-encryption-sdk-cli リポジトリを参照してください。

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