As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# 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-python](https://github.com/aws/aws-encryption-sdk-python/)repositório em GitHub. Para obter a documentação da API, consulte [Ler os documentos](https://aws-encryption-sdk-python.readthedocs.io/en/latest/).
**Topics**
+ [Pré-requisitos](#python-prerequisites)
+ [Instalação](#python-installation)
+ [Exemplos](python-example-code.md)
## 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.
A [Biblioteca de Provedores de Material AWS Criptográfico](https://github.com/aws/aws-cryptographic-material-providers-library) (MPL) é uma dependência opcional para a AWS Encryption SDK for Python introduzida na versão 4. *x.* Se você pretende instalar o MPL, você deve usar o Python 3.11 ou posterior.
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](https://www.python.org/downloads/).
**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](https://pip.pypa.io/en/latest/installation/) 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](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html#version-life-cycle).
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](about-versions.md#version-2) 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 [Migrando seu AWS Encryption SDK](migration.md).
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[MPL]"
```
O `[MPL]` sufixo instala a [Biblioteca de Provedores de Material AWS Criptográfico](https://github.com/aws/aws-cryptographic-material-providers-library) (MPL). O MPL contém construções para criptografar e descriptografar seus dados. O MPL é uma dependência opcional para o AWS Encryption SDK for Python introduzido na versão 4. *x.* É altamente recomendável instalar o MPL. No entanto, se você não pretende usar o MPL, pode omitir o `[MPL]` sufixo.
Para obter mais detalhes sobre o uso do pip para instalar e atualizar pacotes, consulte [Instalação de pacotes](https://packaging.python.org/tutorials/installing-packages/).
AWS Encryption SDK for Python Isso requer a [biblioteca de criptografia (pyca/cryptography](https://cryptography.io/en/latest/)) 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](https://cryptography.io/en/latest/installation.html#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](https://cryptography.io/en/latest/) 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-python](https://github.com/aws/aws-encryption-sdk-python/)repositório em GitHub.
Depois de instalar o AWS Encryption SDK for Python, comece examinando o [código de exemplo do Python](python-example-code.md) neste guia.