Installazione dell'interfaccia AWS Encryption SDK a riga di comando

Questo argomento spiega come installare la CLI di AWS crittografia. Per informazioni dettagliate, consulta il aws-encryption-sdk-clirepository su GitHub e Leggi i documenti.

Installazione dei prerequisiti

La CLI di AWS crittografia è basata su. SDK di crittografia AWS per Python Per installare l' AWS Encryption CLI, sono necessari Python e lo strumento di gestione pip dei pacchetti Python. Python e pip sono disponibili su tutte le piattaforme supportate.

Installa i seguenti prerequisiti prima di installare la CLI di AWS crittografia,

Python

Python 3.8 o versioni successive è richiesto dalle versioni 4.2.0 e successive della AWS CLI di crittografia.

Le versioni precedenti di AWS Encryption CLI supportano Python 2.7 e 3.4 e versioni successive, ma consigliamo di utilizzare la versione più recente di Encryption CLI. AWS

Python è incluso nella maggior parte delle installazioni Linux e macOS, ma è necessario eseguire l'aggiornamento a Python 3.6 o versione successiva. Ti consigliamo di usare la versione più recente di Python. Su Windows, devi installare Python; non è installato di default. Per scaricare e installare Python, vedi Python downloads.

Per stabilire se Python è installato, nella riga di comando, digita quanto segue.

python

Per verificare la versione di Python, utilizza il parametro -V (V maiuscola).

python -V

In Windows, dopo aver installato Python, aggiungi il percorso del Python.exe file al valore della variabile di ambiente Path.

Per impostazione predefinita, Python è installato nella directory di tutti gli utenti o in una directory profilo utente ($home o %userprofile%) nella sottodirectory AppData\Local\Programs\Python. Per trovare la posizione del file Python.exe nel sistema, verifica una delle seguenti chiavi di registro. Puoi usare PowerShell per cercare nel registro.

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

pip

pip è il programma di gestione del pacchetto Python. Per installare la CLI di AWS crittografia e le relative dipendenze, è necessario pip 8.1 o versione successiva. Per semplificare l'installazione o l'aggiornamento di pip, consulta Installazione nella documentazione di pip.

Nelle installazioni Linux, le versioni pip precedenti alla 8.1 non possono creare la libreria di crittografia richiesta dall' AWS Encryption CLI. Se scegli di non aggiornare la tua pip versione, puoi installare gli strumenti di compilazione separatamente. Per ulteriori informazioni, consulta la sezione relativa alla creazione di una crittografia in Linux.

AWS Command Line Interface

Il AWS Command Line Interface (AWS CLI) è necessario solo se si utilizza AWS KMS keys in AWS Key Management Service (AWS KMS) con la CLI di AWS crittografia. Se si utilizza un fornitore di chiavi master diverso, non AWS CLI è obbligatorio.

Per utilizzarlo AWS KMS keys con l' AWS Encryption CLI, è necessario installare e configurare. AWS CLI La configurazione rende AWS KMS disponibili le credenziali utilizzate per l'autenticazione alla AWS CLI di crittografia.

Installazione e aggiornamento della CLI di AWS crittografia

Installa la versione più recente della CLI di AWS crittografia. Quando si utilizza pip per installare l' AWS Encryption CLI, installa automaticamente le librerie necessarie alla CLI, inclusa la libreria di crittografia Python e SDK di crittografia AWS per Pythonla. AWS SDK for Python (Boto3)

Nota

Le versioni dell' AWS Encryption CLI precedenti alla 4.0.0 sono in fase di sviluppo. end-of-support

È possibile eseguire l'aggiornamento dalla versione 2.1 in tutta sicurezza. x e versioni successive alla versione più recente di AWS Encryption CLI senza modifiche al codice o ai dati. Tuttavia, nella versione 2.1 sono state introdotte nuove funzionalità di sicurezza. x non sono retrocompatibili. Per eseguire l'aggiornamento dalla versione 1.7. x o precedente, devi prima eseguire l'aggiornamento alla versione 1 più recente. versione x della CLI di AWS crittografia. Per informazioni dettagliate, vedi Migrazione della tuaAWS Encryption SDK.

Le nuove funzionalità di sicurezza sono state originariamente rilasciate nelle versioni 1.7 di AWS Encryption CLI. x e 2.0. x. Tuttavia, AWS Encryption CLI versione 1.8. x sostituisce la versione 1.7. x e AWS Encryption CLI 2.1. x sostituisce 2.0. x. Per i dettagli, consulta l'avviso di sicurezza pertinente nel aws-encryption-sdk-clirepository su. GitHub

Per installare la versione più recente della CLI di AWS crittografia

pip install aws-encryption-sdk-cli

Per eseguire l'aggiornamento alla versione più recente della CLI di AWS crittografia

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

Per trovare i numeri di versione della tua CLI di AWS crittografia e AWS Encryption SDK

aws-encryption-cli --version

L'output elenca i numeri di versione di entrambe le librerie.

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

Per eseguire l'aggiornamento alla versione più recente della CLI di AWS crittografia

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

L'installazione della CLI di AWS crittografia installa anche la versione più recente di AWS SDK for Python (Boto3), se non è già installata. Se Boto3 è installato, il programma di installazione verifica la versione di Boto3 e la aggiorna se necessario.

Per trovare la versione installata di Boto3

pip show boto3

Per eseguire l'aggiornamento alla versione più recente di Boto3

pip install --upgrade boto3

Per installare la versione della CLI di AWS crittografia attualmente in fase di sviluppo, consulta il aws-encryption-sdk-clirepository su. GitHub

Per ulteriori dettagli sull'utilizzo di pip per installare e aggiornare i pacchetti Python, consulta la documentazione relativa a pip.