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á.
# Instalar o AWS Encryption SDK Interface da linha de comando
Este tópico explica como instalar a CLI AWS de criptografia. Para obter informações detalhadas, consulte o repositório [https://github.com/aws/aws-encryption-sdk-cli/](https://github.com/aws/aws-encryption-sdk-cli/) aws-encryption-sdk-cli em e leia a documentação. GitHub [https://aws-encryption-sdk-cli.readthedocs.io/en/latest/](https://aws-encryption-sdk-cli.readthedocs.io/en/latest/)
**Topics**
+ [Instalar os pré-requisitos](#crypto-cli-prerequisites)
+ [Instalar a CLI do](#install-sdk-cli)
## Instalar os pré-requisitos
A CLI de AWS criptografia é baseada no AWS Encryption SDK for Python. Para instalar o AWS Encryption CLI, você precisa do Python e da ferramenta de `pip` gerenciamento de pacotes Python. O Python e o `pip` estão disponíveis em todas as plataformas compatíveis.
Instale os seguintes pré-requisitos antes de instalar a CLI de AWS criptografia,
**Python**
O Python 3.8 ou posterior é exigido pelas versões 4.2.0 e posteriores do AWS Encryption CLI.
As versões anteriores da CLI de AWS criptografia oferecem suporte ao Python 2.7 e 3.4 e versões posteriores, mas recomendamos que você use a versão mais recente da CLI de criptografia. AWS
O Python está incluído na maioria das instalações do Linux e do macOS, mas é necessário atualizar para o Python 3.6 ou versões posteriores. É recomendável usar a versão mais recente do Python. No Windows, você precisa instalar o Python: ele não é instalado por padrão. Para fazer download do Python, consulte [Downloads do Python](https://www.python.org/downloads/).
Para determinar se o Python está instalado, na linha de comando, digite:
```
python
```
Para verificar a versão do Python, use o parâmetro `-V` (V maiúsculo).
```
python -V
```
No Windows, depois de instalar o Python, adicione o caminho para o arquivo `Python.exe` ao valor da variável de ambiente **Path**.
Por padrão, o Python é instalado em todos os diretórios de usuário ou em um diretório de perfil de usuário (`$home` ou `%userprofile%`) no subdiretório `AppData\Local\Programs\Python`. Para encontrar o local do arquivo `Python.exe` no sistema, verifique uma das seguintes chaves de registro. Você pode usar PowerShell para pesquisar no registro.
```
PS C:\> dir HKLM:\Software\Python\PythonCore\{{version}}\InstallPath
# -or-
PS C:\> dir HKCU:\Software\Python\PythonCore\{{version}}\InstallPath
```
**pip**
`pip` é o gerenciador de pacotes do Python. Para instalar a CLI de AWS criptografia e suas dependências, você precisa da `pip` versão 8.1 ou posterior. Para obter ajuda para instalar ou atualizar o `pip`, consulte [Instalação](https://pip.pypa.io/en/latest/installing/) na documentação do `pip`.
Em instalações Linux, as versões `pip` anteriores à 8.1 não podem criar a ** biblioteca de ** criptografia exigida pela CLI de AWS criptografia. Se você optar por não atualizar sua versão do `pip`, poderá instalar as ferramentas de compilação separadamente. Para obter mais informações, consulte [Criação de criptografia no Linux](https://cryptography.io/en/latest/installation.html#building-cryptography-on-linux).
**AWS Command Line Interface**
O AWS Command Line Interface (AWS CLI) é necessário somente se você estiver usando AWS KMS keys in AWS Key Management Service (AWS KMS) com a CLI de AWS criptografia. Se você estiver usando um provedor de chave [ mestra diferente](concepts.md#master-key-provider), AWS CLI isso não é necessário.
Para usar AWS KMS keys com a CLI de AWS criptografia, você precisa [ instalar ](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) e [ configurar ](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-quick-configuration) o. AWS CLI A configuração disponibiliza as credenciais que você usa para se autenticar na AWS KMS CLI de AWS criptografia.
## Instalando e atualizando o AWS CLI de criptografia
Instale a versão mais recente da CLI AWS de criptografia. Quando você usa `pip` para instalar a CLI de AWS criptografia, ela instala automaticamente as bibliotecas de que a CLI precisa, incluindo a [AWS Encryption SDK for Python](python.md) biblioteca de [ criptografia Python e a. ](https://cryptography.io/en/latest/) [AWS SDK para Python (Boto3)](https://docs.aws.amazon.com/boto3/latest/index.html)
**nota**
As versões do AWS Encryption CLI anteriores à 4.0.0 estão na fase de fim do [ suporte. ](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.1.*x* e posteriores até a versão mais recente da CLI de criptografia da AWS 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.1.*x* não são compatíveis com versões anteriores. Para atualizar a partir da versão 1.7. *x * ou anterior, você deve primeiro atualizar para o 1 mais recente. **versão x da CLI AWS de criptografia. Para obter detalhes, consulte [Migrando seu AWS Encryption SDK](migration.md).
Novos recursos de segurança foram lançados originalmente nas versões 1.7 do AWS Encryption CLI. *x * e 2.0. **x. No entanto, a versão 1.8 do AWS Encryption CLI. *x * substitui a versão 1.7. *x * e AWS Encryption CLI 2.1. *x * substitui 2.0. **x. Para obter detalhes, consulte o comunicado de [ segurança relevante ](https://github.com/aws/aws-encryption-sdk-cli/security/advisories/GHSA-2xwp-m7mq-7q3r) no repositório [https://github.com/aws/aws-encryption-sdk-cli/](https://github.com/aws/aws-encryption-sdk-cli/) aws-encryption-sdk-cli em. GitHub
**Para instalar a versão mais recente da CLI AWS de criptografia**
```
pip install aws-encryption-sdk-cli
```
**Para atualizar para a versão mais recente da CLI de AWS criptografia**
```
pip install --upgrade aws-encryption-sdk-cli
```
**Para encontrar os números de versão da sua CLI de AWS criptografia e AWS Encryption SDK**
```
aws-encryption-cli --version
```
A saída lista os números de versão de ambas as bibliotecas.
```
aws-encryption-sdk-cli/2.1.0 aws-encryption-sdk/2.0.0
```
**Para atualizar para a versão mais recente da CLI de AWS criptografia**
```
pip install --upgrade aws-encryption-sdk-cli
```
A instalação do AWS Encryption CLI também instala a versão mais recente do AWS SDK para Python (Boto3), se ainda não estiver instalada. Se o Boto3 estiver instalado, o instalador verifica a versão do Boto3 e a atualiza, se necessário.
**Para encontrar sua versão instalada do Boto3**
```
pip show boto3
```
**Para atualizar para a versão mais recente do Boto3**
```
pip install --upgrade boto3
```
Para instalar a versão do AWS Encryption CLI atualmente em desenvolvimento, consulte o repositório [https://github.com/aws/aws-encryption-sdk-cli/](https://github.com/aws/aws-encryption-sdk-cli/) aws-encryption-sdk-cli em. GitHub
Para obter mais detalhes sobre o uso do `pip` para instalar e atualizar pacotes do Python, consulte a [documentação do pip](https://pip.pypa.io/en/stable/quickstart/).