AWS Encryption SDK for Python

Este tópico explica como instalar e usar o AWS Encryption SDK for Python. Para obter detalhes sobre a programação com o AWS Encryption SDK for Python, consulte o aws-encryption-sdk-pythonrepositório em GitHub. Para obter a documentação da API, consulte Ler os documentos.

Tópicos

• Pré-requisitos
• Instalação
• Exemplos

Pré-requisitos

Antes de instalar o AWS Encryption SDK for Python, verifique se você tem os seguintes pré-requisitos.

Uma versão compatível do Python

O Python 3.8 ou posterior é exigido pelas AWS Encryption SDK for Python versões 3.2.0 e posteriores.

As versões anteriores do AWS Encryption SDK oferecem suporte ao Python 2.7 e ao Python 3.4 e posteriores, mas recomendamos que você use a versão mais recente do. AWS Encryption SDK

Para fazer download do Python, consulte Downloads do Python.

A ferramenta de instalação do pip para Python

O Python 3.6 e versões posteriores incluem pip, embora você possa querer atualizá-lo. Para obter mais informações sobre a atualização ou a instalação do pip consulte Instalação na documentação do pip.

Instalação

Instalar a versão mais recente do AWS Encryption SDK for Python.

nota

Todas as versões AWS Encryption SDK for Python anteriores à 3.0.0 estão em end-of-supportfase.

Você pode atualizar com segurança a partir da versão 2.0.x e posteriores até a versão mais recente do AWS Encryption SDK sem realizar alterações no código ou nos dados. No entanto, os novos atributos de segurança introduzidos na versão 2.0.x não são compatíveis com versões anteriores. Para atualizar a partir de versões anteriores à 1.7.x até a versão 2.0. x e posteriores, primeiro será necessário atualizar para a versão 1.x mais recente do AWS Encryption SDK. Para obter detalhes, consulte Como migrar seu AWS Encryption SDK.

Use pip para instalar o AWS Encryption SDK for Python, conforme mostrado nos exemplos a seguir.

Para instalar a versão mais recente

pip install aws-encryption-sdk

Para obter mais detalhes sobre o uso do pip para instalar e atualizar pacotes, consulte Instalação de pacotes.

AWS Encryption SDK for Python Isso requer a biblioteca de criptografia (pyca/cryptography) em todas as plataformas. Todas as versões do pip instalam e criam automaticamente a biblioteca cryptography no Windows. O pip 8.1 e versões posteriores instala e compila cryptography automaticamente no Linux. Se você usar uma versão anterior do pip e seu ambiente Linux não tiver as ferramentas necessárias para criar a biblioteca cryptography, será necessário instalá-las. Para obter mais informações, consulte Building Cryptography on Linux.

As versões 1.10.0 e 2.5.0 do AWS Encryption SDK for Python fixam a dependência criptográfica entre 2.5.0 e 3.3.2. Outras versões do AWS Encryption SDK for Python instalam a versão mais recente da criptografia. Se você precisar de uma versão do cryptography posterior à 3.3.2, recomendamos que use a versão principal mais recente do AWS Encryption SDK for Python.

Para obter a versão de desenvolvimento mais recente do AWS Encryption SDK for Python, acesse o aws-encryption-sdk-pythonrepositório em GitHub.

Depois de instalar o AWS Encryption SDK for Python, comece examinando o código de exemplo do Python neste guia.