

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Installazione dell'interfaccia AWS Encryption SDK a riga di comando
<a name="crypto-cli-install"></a>

Questo argomento spiega come installare la CLI di AWS crittografia. Per informazioni dettagliate, consulta il [aws-encryption-sdk-cli](https://github.com/aws/aws-encryption-sdk-cli/)repository su GitHub e [Leggi i documenti](https://aws-encryption-sdk-cli.readthedocs.io/en/latest/).

**Topics**
+ [Installazione dei prerequisiti](#crypto-cli-prerequisites)
+ [Installazione dell'interfaccia a riga di comando](#install-sdk-cli)

## Installazione dei prerequisiti
<a name="crypto-cli-prerequisites"></a>

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.](https://www.python.org/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](https://pip.pypa.io/en/latest/installing/) 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](https://cryptography.io/en/latest/installation.html#building-cryptography-on-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](concepts.md#master-key-provider) diverso, non AWS CLI è obbligatorio.  
Per utilizzarlo AWS KMS keys con l' AWS Encryption CLI, è necessario [installare](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) e [configurare](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-quick-configuration). 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
<a name="install-sdk-cli"></a>

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 Python](python.md)la. [AWS SDK per Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)](https://cryptography.io/en/latest/)

**Nota**  
[Le versioni dell' AWS Encryption CLI precedenti alla 4.0.0 sono in fase di sviluppo. end-of-support](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html#version-life-cycle)  
È 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](about-versions.md#version-2). *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 del tuo AWS Encryption SDK](migration.md).  
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](https://github.com/aws/aws-encryption-sdk-cli/security/advisories/GHSA-2xwp-m7mq-7q3r) pertinente nel [aws-encryption-sdk-cli](https://github.com/aws/aws-encryption-sdk-cli/)repository 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 per 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-cli](https://github.com/aws/aws-encryption-sdk-cli/)repository su. GitHub

Per ulteriori dettagli sull'utilizzo di `pip` per installare e aggiornare i pacchetti Python, consulta la [documentazione relativa a pip](https://pip.pypa.io/en/stable/quickstart/).