適用於 Python 的 AWS Encryption SDK - AWS Encryption SDK
先決條件安裝

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

適用於 Python 的 AWS Encryption SDK

本主題說明如何安裝及使用 適用於 Python 的 AWS Encryption SDK。如需使用 進行程式設計的詳細資訊 適用於 Python 的 AWS Encryption SDK，請參閱 GitHub 上的 aws-encryption-sdk-python 儲存庫。如需 API 文件，請參閱閱讀相關文件。

主題

先決條件

安裝 之前 適用於 Python 的 AWS Encryption SDK，請確定您有下列先決條件。

支援的 Python 版本

3.2.0 版和更新 適用於 Python 的 AWS Encryption SDK 版本需要 Python 3.8 或更新版本。

注意

AWS 密碼編譯材料提供者程式庫 (MPL) 是 4.x 版中 適用於 Python 的 AWS Encryption SDK 引入之 的選用相依性。如果您想要安裝 MPL，則必須使用 Python 3.11 或更新版本。

舊版 AWS Encryption SDK 支援 Python 2.7 和 Python 3.4 及更新版本，但建議您使用最新版本的 AWS Encryption SDK。

若要下載 Python，請參閱 Python 下載。

適用於 Python 的 pip 安裝工具

pip 包含在 Python 3.6 和更新版本中，但您可能想要升級。如需升級或安裝 的詳細資訊pip，請參閱 pip 文件中的安裝。

安裝

安裝最新版本的 適用於 Python 的 AWS Encryption SDK。

注意

所有 適用於 Python 的 AWS Encryption SDK 早於 3.0.0 的 版本都處於end-of-support階段。

您可以從 2.0.x 版和更新版本安全地更新至最新版本的 ， AWS Encryption SDK 而不需要變更任何程式碼或資料。不過，2.0.x 版中引進的新安全功能無法回溯相容。若要從 1.7.x 之前的版本更新至 2.0.x 及更新版本，您必須先更新至最新的 1 AWS Encryption SDK.x 版本。如需詳細資訊，請參閱遷移您的 AWS Encryption SDK。

pip 使用 安裝 適用於 Python 的 AWS Encryption SDK，如下列範例所示。

若要安裝最新版本
pip install "aws-encryption-sdk[MPL]"

[MPL] 尾碼會安裝AWS 密碼編譯物料提供者程式庫 (MPL)。MPL 包含用於加密和解密資料的建構。MPL 是 4.x 版中 適用於 Python 的 AWS Encryption SDK 引入之 的選用相依性。我們強烈建議您安裝 MPL。不過，如果您不打算使用 MPL，您可以省略[MPL]尾碼。

如需使用 pip 來安裝及升級套件的詳細資訊，請參閱安裝套件。

在所有平台上 適用於 Python 的 AWS Encryption SDK 都需要密碼編譯程式庫 (pyca/cryptography)。所有版本的 pip會自動在 Windows 上安裝和建置程式cryptography庫。 pip 8.1 和更新版本會自動在 Linux cryptography上安裝和建置 。如果您使用的是舊版 ，pip而且您的 Linux 環境沒有建置程式cryptography庫所需的工具，則需要安裝它們。如需詳細資訊，請參閱在 Linux 上建置密碼編譯。

密碼編譯相依性介於 2.5.0 和 3.3.2 之間的 適用於 Python 的 AWS Encryption SDK PIN 版本 1.10.0 和 2.5.0。其他版本的 適用於 Python 的 AWS Encryption SDK 安裝最新版本的密碼編譯。如果您需要 3.3.2 之後的加密版本，建議您使用最新的 主要版本 適用於 Python 的 AWS Encryption SDK。

如需 的最新開發版本 適用於 Python 的 AWS Encryption SDK，請前往 GitHub 中的 aws-encryption-sdk-python 儲存庫。

安裝 之後 適用於 Python 的 AWS Encryption SDK，請先查看本指南中的 Python 範例程式碼。