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

En este tema se explica cómo instalar la CLI de cifrado del AWS. Para obtener más información, consulte el repositorio de aws-encryption-sdk-cli en GitHub y Read the Docs.

Instalación de los requisitos previos

La CLI de cifrado del AWS se basa en el SDK de cifrado de AWS para Python. Para utilizar la CLI de cifrado del AWS 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 cifrado del AWS:

Python

Las versiones 4.1.0 y posteriores de la CLI de cifrado del AWS requieren Python 3.6 o posterior.

Las versiones anteriores de la CLI de cifrado del AWS 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 cifrado del AWS.

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 utilizar 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 cifrado del AWS y sus dependencias, necesita la versión 8.1 o posterior de pip. 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 cifrado del AWS. 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 se necesita si usa AWS KMS keys en AWS Key Management Service (AWS KMS) con la AWS CLI de cifrado. Si se utiliza otro proveedor de claves maestras, la AWS CLI no es necesaria.

Para usar AWS KMS keys con la CLI de cifrado del AWS, es preciso instalar y configurar el AWS CLI. La configuración hace que las credenciales que se utilizan para autenticarse en AWS KMS estén disponibles para la CLI de cifrado del AWS.

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

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

nota

Las versiones de la CLI de cifrado del AWS anteriores a la 4.0.0 se encuentran en la fase de fin de soporte.

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 del AWS sin cambios en el código ni en los datos. Sin embargo, se introdujeron nuevas funciones 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.x de la CLI de cifrado del AWS. Para obtener más información, consulte Migrar su AWS Encryption SDK.

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

Para instalar la última versión de la CLI de cifrado del AWS

pip install aws-encryption-sdk-cli

Para subir de categoría a la última versión de la CLI de cifrado del AWS

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

Para buscar el número de versión de la CLI de cifrado del AWS y el 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 subir de categoría a la última versión de la CLI de cifrado del AWS

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

Al instalar la CLI de cifrado del AWS, también se instala la versión más reciente del 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 cifrado del AWS actualmente en desarrollo, consulte el repositorio de aws-encryption-sdk-cli 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.