AWS Encryption SDK for Python

このトピックでは、 AWS Encryption SDK for Pythonをインストールして使用する方法について説明します。を使用したプログラミングの詳細については AWS Encryption SDK for Python、GitHub の aws-encryption-sdk-python リポジトリを参照してください。API のドキュメントについては、Read the Docs を参照してください。

トピック

• 前提条件

• インストール

• 例

前提条件

をインストールする前に AWS Encryption SDK for Python、次の前提条件を満たしていることを確認してください。

Python のサポートされているバージョン

AWS Encryption SDK for Python バージョン 3.2.0 以降では、Python 3.8 以降が必要です。

注記

AWS 暗号化マテリアルプロバイダーライブラリ (MPL) は、バージョン 4.x で AWS Encryption SDK for Python 導入された のオプション依存関係です。MPL をインストールする場合は、Python 3.11 以降を使用する必要があります。

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

Python をダウンロードするには、「Python のダウンロード」を参照してください。

Python 用 pip インストールツール

pip は、Python 3.6 以降のバージョンには含まれていますが、アップグレードすることをお勧めします。pip のアップグレードまたはインストールの詳細については、「pip ドキュメント」の「インストール」を参照してください。

インストール

AWS Encryption SDK for Pythonの最新バージョンをインストールします。

注記

3.0.0 より AWS Encryption SDK for Python 前の のすべてのバージョンはend-of-supportフェーズにあります。

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

次の例に示すように AWS Encryption SDK for Python、 pipを使用して をインストールします。

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

pip install "aws-encryption-sdk[MPL]"

[MPL] サフィックスは AWS Cryptographic Material Providers Library (MPL) をインストールします。MPL には、データを暗号化および復号するためのコンストラクトが含まれています。MPL は、バージョン 4.x で AWS Encryption SDK for Python 導入された のオプション依存関係です。MPL のインストールを強くお勧めします。ただし、MPL を使用しない場合は、[MPL]サフィックスを省略できます。

pip を使用してパッケージをインストールおよびアップグレードする方法の詳細については、「パッケージのインストール」を参照してください。

では、すべてのプラットフォームで暗号化ライブラリ (pyca/cryptography) AWS Encryption SDK for Python が必要です。pip のすべてのバージョンでは、Windows に cryptography ライブラリがインストールされて構築されます。pip 8.1 以降では、Linux に cryptography が自動的にインストールされて構築されます。以前のバージョンの pip を使用していて、Linux 環境に、cryptography ライブラリを構築するために必要なツールがない場合は、それらをインストールする必要があります。詳細については、「Building cryptography on Linux」を参照してください。

バージョン 1.10.0 および 2.5.0 は、2.5.0 と 3.3.2 の間の暗号化の依存関係 AWS Encryption SDK for Python を固定します。の他のバージョンでは、最新バージョンの暗号化 AWS Encryption SDK for Python がインストールされます。3.3.2 以降の暗号化のバージョンが必要な場合は、 AWS Encryption SDK for Pythonの最新のメジャーバージョンを使用することを推奨します。

の最新バージョンについては AWS Encryption SDK for Python、GitHub の aws-encryption-sdk-python リポジトリを参照してください。

をインストールしたら AWS Encryption SDK for Python、このガイドの Python サンプルコードを確認して開始します。