Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# AWS Encryption SDK for Java
Topik ini menjelaskan cara menginstal dan menggunakan AWS Encryption SDK for Java. Untuk detail tentang pemrograman dengan AWS Encryption SDK for Java, lihat [aws-encryption-sdk-java](https://github.com/aws/aws-encryption-sdk-java/)repositori di. GitHub Untuk dokumentasi API, lihat [Javadoc](https://aws.github.io/aws-encryption-sdk-java/) untuk dokumen. AWS Encryption SDK for Java
**Topics**
+ [Prasyarat](#java-prerequisites)
+ [Penginstalan](#java-installation)
+ [Contoh](java-example-code.md)
## Prasyarat
Sebelum Anda menginstal AWS Encryption SDK for Java, pastikan Anda memiliki prasyarat berikut.
**Lingkungan pengembangan Java**
Anda akan membutuhkan Java 8 atau yang lebih baru. Di situs web Oracle, buka [Unduhan Java SE](https://www.oracle.com/java/technologies/downloads/), kemudian unduh dan instal Java SE Development Kit (JDK).
Jika Anda menggunakan Oracle JDK, Anda juga harus mengunduh dan menginstal [File Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy](http://www.oracle.com/java/technologies/javase-jce8-downloads.html).
**Kastil Goyang**
AWS Encryption SDK for Java Membutuhkan Kastil [Bouncy.](https://www.bouncycastle.org/download/bouncy-castle-java/)
+ AWS Encryption SDK for Java versi 1.6.1 dan yang lebih baru menggunakan Bouncy Castle untuk membuat serial dan deserialisasi objek kriptografi. Anda dapat menggunakan Bouncy Castle atau [Bouncy Castle FIPS](https://www.bouncycastle.org/about/bouncy-castle-fips-faq/) untuk memenuhi persyaratan ini. **Untuk bantuan menginstal dan mengonfigurasi FIPS Bouncy Castle, lihat [Dokumentasi BC FIPS](https://www.bouncycastle.org/documentation/), terutama **Panduan Pengguna** dan Kebijakan Keamanan.** PDFs
+ Versi sebelumnya AWS Encryption SDK for Java menggunakan API kriptografi Bouncy Castle untuk Java. Persyaratan ini hanya dipenuhi oleh Kastil Bouncy non-FIPS.
Jika Anda tidak memiliki Bouncy Castle, buka [Unduh Bouncy Castle for Java untuk](https://bouncycastle.org/download/bouncy-castle-java/) mengunduh file penyedia yang sesuai dengan JDK Anda. [Anda juga dapat menggunakan [Apache Maven](https://maven.apache.org/) untuk mendapatkan artefak untuk penyedia Bouncy Castle standar ([bcprov-ext-jdk15on](https://mvnrepository.com/artifact/org.bouncycastle/bcprov-ext-jdk15on)) atau artefak untuk Bouncy Castle FIPS (bc-fips).](https://mvnrepository.com/artifact/org.bouncycastle/bc-fips)
**AWS SDK untuk Java**
Versi 3. *x* dari AWS Encryption SDK for Java membutuhkan AWS SDK for Java 2.x, bahkan jika Anda tidak menggunakan AWS KMS gantungan kunci.
Versi 2. *x* atau sebelumnya AWS Encryption SDK for Java tidak memerlukan AWS SDK untuk Java. Namun, AWS SDK untuk Java diperlukan untuk menggunakan [AWS Key Management Service](https://aws.amazon.com/kms/)(AWS KMS) sebagai penyedia kunci utama. Dimulai pada AWS Encryption SDK for Java versi 2.4.0, AWS Encryption SDK for Java mendukung versi 1.x dan 2.x dari versi. AWS SDK untuk Java AWS Encryption SDK kode untuk AWS SDK untuk Java 1.x dan 2.x dapat dioperasikan. Misalnya, Anda dapat mengenkripsi data dengan AWS Encryption SDK kode yang mendukung AWS SDK untuk Java 1.x dan mendekripsi menggunakan kode yang mendukung AWS SDK for Java 2.x (atau sebaliknya). Versi yang AWS Encryption SDK for Java lebih awal dari 2.4.0 hanya mendukung AWS SDK untuk Java 1.x. Untuk informasi tentang memperbarui versi Anda AWS Encryption SDK, lihat[Migrasi Anda AWS Encryption SDK](migration.md).
Saat memperbarui AWS Encryption SDK for Java kode Anda dari AWS SDK untuk Java 1.x ke AWS SDK for Java 2.x, ganti referensi ke [`AWSKMS`antarmuka](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/services/kms/package-summary.html) di AWS SDK untuk Java 1.x dengan referensi ke [`KmsClient`antarmuka](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/kms/package-summary.html) di. AWS SDK for Java 2.x AWS Encryption SDK for Java Tidak mendukung [`KmsAsyncClient`antarmuka](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/kms/KmsAsyncClient.html). Juga, perbarui kode Anda untuk menggunakan objek AWS KMS-related di `kmssdkv2` namespace, bukan namespace. `kms`
Untuk menginstal AWS SDK untuk Java, gunakan Apache Maven.
+ Untuk [mengimpor keseluruhan AWS SDK untuk Java](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/setup-project-maven.html#build-the-entire-sdk-into-your-project) sebagai dependensi, deklarasikan dalam file Anda. `pom.xml`
+ Untuk membuat dependensi hanya untuk AWS KMS modul di AWS SDK untuk Java 1.x, ikuti instruksi untuk [menentukan modul tertentu](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/setup-project-maven.html#modules-dependencies), dan atur ke. `artifactId` `aws-java-sdk-kms`
+ Untuk membuat dependensi hanya untuk AWS KMS modul di AWS SDK untuk Java 2.x, ikuti instruksi untuk [menentukan](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/setup-project-maven.html#modules-dependencies) modul tertentu. Atur `groupId` ke `software.amazon.awssdk` dan `artifactId` ke`kms`.
Untuk perubahan lainnya, lihat [Apa yang berbeda antara AWS SDK untuk Java 1.x dan 2.x di Panduan](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/migration-whats-different.html) AWS SDK for Java 2.x Pengembang.
Contoh Java dalam Panduan AWS Encryption SDK Pengembang menggunakan file AWS SDK for Java 2.x.
## Penginstalan
Instal versi terbaru dari file AWS Encryption SDK for Java.
**catatan**
[Semua versi yang AWS Encryption SDK for Java lebih awal dari 2.0.0 sedang dalam fase. end-of-support](https://docs.aws.amazon.com/sdkref/latest/guide/maint-policy.html#version-life-cycle)
Anda dapat memperbarui dengan aman dari versi 2.0. *x* dan yang lebih baru ke versi terbaru AWS Encryption SDK for Java tanpa kode atau perubahan data. Namun, [fitur keamanan baru](about-versions.md#version-2) diperkenalkan di versi 2.0. *x* tidak kompatibel ke belakang. Untuk memperbarui dari versi lebih awal dari 1.7. *x* ke versi 2.0. *x* dan yang lebih baru, Anda harus terlebih dahulu memperbarui ke yang terbaru 1. *x* versi AWS Encryption SDK. Lihat perinciannya di [Migrasi Anda AWS Encryption SDK](migration.md).
Anda dapat menginstal dengan cara berikut. AWS Encryption SDK for Java
**Secara manual**
Untuk menginstal AWS Encryption SDK for Java, kloning atau unduh [aws-encryption-sdk-java](https://github.com/aws/aws-encryption-sdk-java/) GitHubrepositori.
**Menggunakan Apache Maven**
AWS Encryption SDK for Java Ini tersedia melalui [Apache Maven dengan definisi ketergantungan](https://maven.apache.org/) berikut.
```
com.amazonaws
aws-encryption-sdk-java
3.0.0
```
Setelah Anda menginstal SDK, mulailah dengan melihat [contoh kode Java](java-example-code.md) dalam panduan ini dan [Javadoc](https://aws.github.io/aws-encryption-sdk-java/) aktif. GitHub