Instalación de la interfaz de línea de AWS Encryption SDK comandos

En este tema se explica cómo instalar la CLI de AWS cifrado. Para obtener información detallada, consulte el aws-encryption-sdk-clirepositorio en GitHub y lea los documentos.

Instalación de los requisitos previos

La CLI de AWS cifrado se basa en SDK de cifrado de AWS para Python. Para instalar la CLI de AWS cifrado, necesita Python y pip la herramienta de administración de paquetes de Python. Python y pip están disponibles en todas las plataformas con soporte.

Instale los siguientes requisitos previos antes de instalar la CLI de AWS cifrado:

Python

Las versiones 4.2.0 y posteriores de la CLI de AWS cifrado requieren Python 3.8 o posterior.

Las versiones anteriores de la CLI de AWS cifrado admiten Python 2.7 y 3.4 y versiones posteriores, pero le recomendamos que utilice la versión más reciente de la CLI de AWS cifrado.

Python está incluido en la mayoría de las instalaciones de Linux y macOS, pero es necesario actualizar a la versión Python 3.6 o posterior. Le recomendamos que utilice la última versión de Python. Tendrá que instalar Python en Windows, si todavía no está de forma predeterminada. Para descargar e instalar Python, visite el sitio de descargas de Python.

Para determinar si Python está instalado, escriba lo siguiente en la línea de comandos:

python

Para comprobar la versión de Python, utilice el parámetro -V (V mayúscula).

python -V

En Windows, después de instalar Python, añada la ruta al archivo del Python.exe al valor de la variable de entorno Path.

De forma predeterminada, Python se instala en el directorio de todos los usuarios o en un directorio de perfil de usuario ($home o %userprofile%) en el subdirectorio AppData\Local\Programs\Python. Para encontrar la ubicación del archivo Python.exe en el sistema, consulte una de las siguientes claves del registro. Puede utilizarla PowerShell para buscar en el registro.

PS C:\> dir HKLM:\Software\Python\PythonCore\version\InstallPath
# -or-
PS C:\> dir HKCU:\Software\Python\PythonCore\version\InstallPath

pip

pip es el administrador de paquetes de Python. Para instalar la CLI de AWS cifrado y sus dependencias, necesita la pip versión 8.1 o una versión posterior. Para obtener ayuda con la instalación o actualización de pip, consulte la sección de instalación en la documentación de pip.

En las instalaciones de Linux, las versiones pip anteriores a la 8.1 no pueden crear la biblioteca de criptografía que requiere la CLI de AWS cifrado. Si decide no actualizar su versión de pip, puede instalar las herramientas de compilación por separado. Para obtener más información, consulte Building cryptography on Linux.

AWS Command Line Interface

El AWS Command Line Interface (AWS CLI) solo es necesario si utiliza AWS KMS keys in AWS Key Management Service (AWS KMS) con la CLI de AWS cifrado. Si utiliza un proveedor de claves maestras diferente, no AWS CLI es obligatorio.

Para utilizarla AWS KMS keys con la CLI de AWS cifrado, debe instalar y configurar la AWS CLI. La configuración hace que las credenciales que se utilizan para autenticarse AWS KMS estén disponibles para la CLI de AWS cifrado.

Instalación y actualización de la CLI AWS de cifrado

Instale la última versión de la CLI de AWS cifrado. Cuando se instala la CLI de AWS cifrado, se instalan automáticamente las bibliotecas que la CLI necesita, incluidas la SDK de cifrado de AWS para Pythonbiblioteca de criptografía de Python y la. pip AWS SDK for Python (Boto3)

nota

Las versiones de la CLI de AWS cifrado anteriores a la 4.0.0 están en end-of-supportfase.

Puede actualizar de forma segura desde la versión 2.1.x y versiones posteriores a la última versión de la CLI de cifrado de AWS sin cambios en el código ni en los datos. Sin embargo, se introdujeron nuevas características de seguridad en la versión 2.1.x que no son compatibles con versiones anteriores. Para actualizar desde la versión 1.7. x o anterior, primero debe actualizar a la última versión 1. versión x de la CLI AWS de cifrado. Para obtener más detalles, consulte Migrar su AWS Encryption SDK.

Las nuevas funciones de seguridad se publicaron originalmente en las versiones 1.7 de AWS Encryption CLI. x y 2.0. x. Sin embargo, AWS Encryption CLI versión 1.8. x reemplaza a la versión 1.7. x y CLI de AWS cifrado 2.1. x reemplaza a 2.0. x. Para obtener más información, consulte el aviso de seguridad correspondiente en el aws-encryption-sdk-clirepositorio de GitHub.

Para instalar la versión más reciente de la CLI de AWS cifrado

pip install aws-encryption-sdk-cli

Para actualizar a la última versión de la CLI de AWS cifrado

pip install --upgrade aws-encryption-sdk-cli

Para encontrar los números de versión de su CLI de AWS cifrado y AWS Encryption SDK

aws-encryption-cli --version

El resultado muestra los números de versión de ambas bibliotecas.

aws-encryption-sdk-cli/2.1.0 aws-encryption-sdk/2.0.0

Para actualizar a la última versión de la CLI de AWS cifrado

pip install --upgrade aws-encryption-sdk-cli

Al instalar la CLI de AWS cifrado, también se instala la versión más reciente de AWS SDK for Python (Boto3), si aún no está instalada. Si Boto3 está instalado, el instalador verifica la versión de Boto3 y la actualiza si es necesario.

Para encontrar la versión de Boto3 que tiene instalada

pip show boto3

Para actualizar a la versión más reciente de Boto3

pip install --upgrade boto3

Para instalar la versión de la CLI de AWS cifrado actualmente en desarrollo, consulte el aws-encryption-sdk-clirepositorio en GitHub.

Para obtener más información acerca de cómo utilizar pip para instalar y actualizar paquetes de Python, consulte la documentación de pip.