Instalando a interface de linha de AWS Encryption SDK comando

Este tópico explica como instalar a CLI AWS de criptografia. Para obter informações detalhadas, consulte o aws-encryption-sdk-clirepositório GitHub e leia os documentos.

Instalar os pré-requisitos

A CLI de AWS criptografia é baseada no. AWS Encryption SDK for Python Para instalar a CLI do AWS Encryption, você precisa do Python e da ferramenta de gerenciamento de pacotes pip do 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 criptografia AWS ,

Python

O Python 3.8 ou posterior é exigido pelas versões 4.2.0 e posteriores do Encryption AWS 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 o 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.

Nas instalações do 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 é obrigató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 autenticar para a AWS KMS AWS CLI de criptografia.

Instalando e atualizando a CLI AWS 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 biblioteca de criptografia Python e a. AWS Encryption SDK for PythonAWS SDK for Python (Boto3)

nota

Versões da CLI de AWS criptografia anteriores à 4.0.0 estão em fase. end-of-support

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 a última 1. versão x da CLI AWS de criptografia. Para obter detalhes, consulte Como migrar 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 AWS 1.8 do Encryption CLI. x substitui a versão 1.7. x e CLI de AWS criptografia 2.1. x substitui 2.0. x. Para obter detalhes, consulte a consultoria de segurança relevante no aws-encryption-sdk-clirepositório 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 da CLI de AWS criptografia também instala a versão mais recente do AWS SDK for 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 da CLI de AWS criptografia atualmente em desenvolvimento, consulte o aws-encryption-sdk-clirepositório em. GitHub

Para obter mais detalhes sobre o uso do pip para instalar e atualizar pacotes do Python, consulte a documentação do pip.