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à.
# SDK di crittografia AWS per Java
In questo argomento viene descritto come installare e utilizzare SDK di crittografia AWS per Java. Per dettagli sulla programmazione con SDK di crittografia AWS per Java, consulta il [aws-encryption-sdk-java](https://github.com/aws/aws-encryption-sdk-java/)repository su GitHub. Per la documentazione sulle API, consulta [Javadoc](https://aws.github.io/aws-encryption-sdk-java/) per il SDK di crittografia AWS per Java.
**Topics**
+ [Prerequisiti](#java-prerequisites)
+ [Installazione](#java-installation)
+ [Esempi](java-example-code.md)
## Prerequisiti
Prima di installare il SDK di crittografia AWS per Java, assicuratevi di avere i seguenti prerequisiti.
**Un ambiente di sviluppo Java**
È necessario Java 8 o versioni successive. Nel sito Web di Oracle, accedi alla pagina [Java SE Download](https://www.oracle.com/java/technologies/downloads/), quindi scarica e installa Java SE Development Kit (JDK).
Se utilizzi Oracle JDK, devi scaricare e installare anche [Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy Files](http://www.oracle.com/java/technologies/javase-jce8-downloads.html).
**Bouncy Castle**
SDK di crittografia AWS per Java Richiede [Bouncy](https://www.bouncycastle.org/download/bouncy-castle-java/) Castle.
+ SDK di crittografia AWS per Java le versioni 1.6.1 e successive utilizzano Bouncy Castle per serializzare e deserializzare oggetti crittografici. Puoi usare Bouncy Castle o [Bouncy Castle FIPS](https://www.bouncycastle.org/about/bouncy-castle-fips-faq/) per soddisfare questo requisito. [https://www.bouncycastle.org/documentation/](https://www.bouncycastle.org/documentation/) PDFs
+ Le versioni precedenti SDK di crittografia AWS per Java utilizzano l'API di crittografia di Bouncy Castle per Java. Questo requisito è soddisfatto solo da Bouncy Castle non FIPS.
Se non hai Bouncy Castle, vai a [Scarica Bouncy Castle per Java per scaricare il file del provider che corrisponde](https://bouncycastle.org/download/bouncy-castle-java/) al tuo JDK. [https://mvnrepository.com/artifact/org.bouncycastle/bcprov-ext-jdk15on](https://mvnrepository.com/artifact/org.bouncycastle/bcprov-ext-jdk15on)
**AWS SDK per Java**
Versione 3. *x* of the SDK di crittografia AWS per Java richiede AWS SDK for Java 2.x, anche se non si utilizzano AWS KMS portachiavi.
Versione 2. *x* o precedente di SDK di crittografia AWS per Java non richiede AWS SDK per Java. Tuttavia, AWS SDK per Java è necessario utilizzare [AWS Key Management Service](https://aws.amazon.com/kms/)(AWS KMS) come fornitore di chiavi principali. A partire dalla SDK di crittografia AWS per Java versione 2.4.0, SDK di crittografia AWS per Java supporta sia la versione 1.x che la 2.x di. AWS SDK per Java AWS Encryption SDK il codice per AWS SDK per Java 1.x e 2.x è interoperabile. Ad esempio, è possibile crittografare i dati con AWS Encryption SDK codice che supporta AWS SDK per Java 1.x e decrittografarli utilizzando codice che supporta (o viceversa). AWS SDK for Java 2.x Le versioni precedenti alla 2.4.0 supportano SDK di crittografia AWS per Java solo la versione 1.x. AWS SDK per Java Per informazioni sull'aggiornamento della versione di in uso AWS Encryption SDK, vedere. [Migrazione del tuo AWS Encryption SDK](migration.md)
Quando aggiorni il SDK di crittografia AWS per Java codice dalla versione AWS SDK per Java 1.x alla versione 1.x AWS SDK for Java 2.x, sostituisci i riferimenti all'[`AWSKMS`interfaccia](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kms/package-summary.html) nella versione AWS SDK per Java 1.x con i riferimenti all'[`KmsClient`interfaccia](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/kms/package-summary.html) in. AWS SDK for Java 2.x[Non SDK di crittografia AWS per Java supporta l'interfaccia. `KmsAsyncClient`](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/kms/KmsAsyncClient.html) Inoltre, aggiorna il codice per utilizzare gli oggetti AWS KMS correlati allo spazio dei `kmssdkv2` nomi nel namespace, anziché nel namespace. `kms`
Per installare, usa Apache Maven AWS SDK per Java.
+ Per [importare l'intero AWS SDK per Java](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/setup-project-maven.html#build-the-entire-sdk-into-your-project) come dipendenza, dichiaralo nel file `pom.xml`.
+ Per creare una dipendenza solo per il AWS KMS modulo in AWS SDK per Java 1.x, segui le istruzioni per [specificare moduli particolari](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/setup-project-maven.html#modules-dependencies) e imposta il valore su. `artifactId` `aws-java-sdk-kms`
+ [Per creare una dipendenza solo per il AWS KMS modulo in AWS SDK per Java 2.x, segui le istruzioni per specificare moduli particolari.](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/setup-project-maven.html#modules-dependencies) Imposta il `groupId` to `software.amazon.awssdk` e il to. `artifactId` `kms`
Per ulteriori modifiche, consulta [Cosa c'è di diverso tra AWS SDK per Java 1.x e 2.x nella Guida](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/migration-whats-different.html) per gli AWS SDK for Java 2.x sviluppatori.
Gli esempi di Java nella AWS Encryption SDK Developer Guide utilizzano il. AWS SDK for Java 2.x
## Installazione
Installazione della versione più recente della SDK di crittografia AWS per Java.
**Nota**
[Tutte le versioni SDK di crittografia AWS per Java precedenti alla 2.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 in tutta sicurezza dalla versione 2.0. *x* e versioni successive alla versione più recente di SDK di crittografia AWS per Java senza modifiche al codice o ai dati. Tuttavia, nella versione 2.0 sono state introdotte [nuove funzionalità di sicurezza](about-versions.md#version-2). *x* non sono retrocompatibili. Per eseguire l'aggiornamento da versioni precedenti alla 1.7. *x* alla versione 2.0. *x* e versioni successive, è necessario prima eseguire l'aggiornamento alla versione più recente 1. versione *x* di AWS Encryption SDK. Per informazioni dettagliate, vedi [Migrazione del tuo AWS Encryption SDK](migration.md).
È possibile installarlo SDK di crittografia AWS per Java nei seguenti modi.
**Manualmente**
Per installare SDK di crittografia AWS per Java, clona o scarica il [aws-encryption-sdk-java](https://github.com/aws/aws-encryption-sdk-java/) GitHubrepository.
**Utilizzo di Apache Maven**
SDK di crittografia AWS per Java è disponibile tramite [Apache Maven](https://maven.apache.org/) con la seguente definizione di dipendenza.
```
com.amazonaws
aws-encryption-sdk-java
3.0.0
```
[Dopo aver installato l'SDK, inizia a guardare il [codice Java di esempio](java-example-code.md) in questa guida e Javadoc attivo. GitHub](https://aws.github.io/aws-encryption-sdk-java/)