View a markdown version of this page

Instalar o   AWS Encryption SDK Interface da linha de comando - AWS Encryption SDK
Instalar os pré-requisitosInstalar a CLI do

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/ aws-encryption-sdk-cli em e leia a documentação. GitHub https://aws-encryption-sdk-cli.readthedocs.io/en/latest/

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.

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 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.

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, AWS CLI isso não é necessário.

Para usar AWS KMS keys com a CLI de AWS criptografia, você precisa instalar e configurar 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 biblioteca de criptografia Python e a. AWS SDK para Python (Boto3)

nota

As versões do AWS Encryption CLI anteriores à 4.0.0 estão na fase de fim do suporte.

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 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.

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 no repositório 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/ 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.