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

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

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

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

前提条件のインストール

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

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

Python

AWS Encryption CLI バージョン 4.2.0 以降では、Python 3.8 以降が必要です。

以前のバージョンの AWS Encryption CLI は Python 2.7 および 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 とその依存関係をインストールするには、8.1 pip 以降が必要です。pip のインストールまたはアップグレードのヘルプについては、pip ドキュメントの「インストール」を参照してください。

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

AWS Command Line Interface

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

AWS Encryption CLI AWS KMS keys で を使用するには、 をインストールして設定する必要があります AWS CLI。この設定により、認証に使用する認証情報が AWS Encryption CLI AWS KMS で使用できるようになります。

AWS Encryption CLI のインストールと更新

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

注記

4.0.0 より前のバージョンの AWS Encryption CLI はend-of-support、 フェーズにあります。

バージョン 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.8.x はバージョン 1.7.x を置き換え、 AWS Encryption CLI 2.1.x は 2.0.x を置き換えます。詳細については、 のaws-encryption-sdk-cliリポジトリにある関連するセキュリティアドバイザリを参照してください 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 Encryption CLI のバージョンをインストールするには、 のaws-encryption-sdk-cliリポジトリを参照してください GitHub。

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