Pengaturan dasar untuk bekerja dengan Layanan AWS - AWS SDK for Java 1.x
Gambaran UmumKemampuan masuk ke portal akses AWSMenyiapkan file konfigurasi bersamaInstal Lingkungan Pengembangan Java

Kami mengumumkan yang akan datang end-of-support untuk AWS SDK for Java (v1). Kami menyarankan Anda bermigrasi ke AWS SDK for Java v2. Untuk tanggal, detail tambahan, dan informasi tentang cara bermigrasi, silakan merujuk ke pengumuman tertaut.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pengaturan dasar untuk bekerja dengan Layanan AWS

Gambaran Umum

Untuk berhasil mengembangkan aplikasi yang mengakses Layanan AWS menggunakanAWS SDK for Java, kondisi berikut diperlukan:

  • Anda harus dapat masuk ke portal AWS akses yang tersedia diAWS IAM Identity Center.

  • Izin peran IAM yang dikonfigurasi untuk SDK harus mengizinkan akses ke Layanan AWS yang diperlukan aplikasi Anda. Izin yang terkait dengan kebijakan yang PowerUserAccessAWSdikelola cukup untuk sebagian besar kebutuhan pengembangan.

  • Lingkungan pengembangan dengan elemen berikut:

penting

Petunjuk di bagian penyiapan ini mengasumsikan bahwa Anda atau organisasi menggunakan IAM Identity Center. Jika organisasi Anda menggunakan penyedia identitas eksternal yang bekerja secara independen dari IAM Identity Center, cari tahu bagaimana Anda bisa mendapatkan kredensi sementara untuk SDK for Java untuk digunakan. Ikuti petunjuk berikut untuk menambahkan kredensi sementara ke file. ~/.aws/credentials

Jika penyedia identitas Anda menambahkan kredensi sementara secara otomatis ke ~/.aws/credentials file, pastikan nama profil tersebut [default] agar Anda tidak perlu memberikan nama profil ke SDK atau. AWS CLI

Kemampuan masuk ke portal akses AWS

Portal AWS akses adalah lokasi web tempat Anda masuk secara manual ke IAM Identity Center. Format URL adalah d-xxxxxxxxxx.awsapps.com/start atauyour_subdomain.awsapps.com/start.

Jika Anda tidak terbiasa dengan portal AWS akses, ikuti panduan untuk akses akun di Langkah 1 topik otentikasi IAM Identity Center di Panduan Referensi AWS SDK dan Alat. Jangan ikuti Langkah 2 karena AWS SDK for Java 1.x tidak mendukung penyegaran token otomatis dan pengambilan otomatis kredensil sementara untuk SDK yang dijelaskan oleh Langkah 2.

Menyiapkan file konfigurasi bersama

File konfigurasi bersama berada di workstation pengembangan Anda dan berisi pengaturan dasar yang digunakan oleh semua AWS SDK dan AWS Command Line Interface (CLI). File konfigurasi bersama dapat berisi sejumlah pengaturan, tetapi instruksi ini mengatur elemen dasar yang diperlukan untuk bekerja dengan SDK.

Atur config file bersama

Contoh berikut menunjukkan isi dari config file bersama.

[default]
region=us-east-1
output=json

Untuk tujuan pengembangan, gunakan yang Wilayah AWS terdekat ke tempat Anda berencana untuk menjalankan kode Anda. Untuk daftar kode wilayah yang akan digunakan dalam config file, lihat Referensi Umum Amazon Web panduan. jsonPengaturan untuk format output adalah salah satu dari beberapa nilai yang mungkin.

Ikuti panduan di bagian ini untuk membuat config file.

Menyiapkan kredensi sementara untuk SDK

Setelah Anda memiliki akses ke peran Akun AWS dan IAM melalui portal AWS akses, konfigurasikan lingkungan pengembangan Anda dengan kredensi sementara agar SDK dapat diakses.

Langkah-langkah untuk menyiapkan credentials file lokal dengan kredensi sementara

  1. Buat credentials file bersama.

  2. Dalam credentials file, tempelkan teks placeholder berikut sampai Anda menempelkan kredenial sementara yang berfungsi.

    [default]
aws_access_key_id=<value from AWS access portal>
aws_secret_access_key=<value from AWS access portal>
aws_session_token=<value from AWS access portal>

  3. Simpan file tersebut. File sekarang ~/.aws/credentials harus ada pada sistem pengembangan lokal Anda. File ini berisi profil [default] yang digunakan SDK for Java jika profil bernama tertentu tidak ditentukan.

  4. Masuk ke portal AWS akses.

  5. Ikuti petunjuk ini di bawah judul Penyegaran kredensi manual untuk menyalin kredensi peran IAM dari portal akses. AWS

    1. Untuk langkah 4 dalam petunjuk tertaut, pilih nama peran IAM yang memberikan akses untuk kebutuhan pengembangan Anda. Peran ini biasanya memiliki nama seperti PowerUserAccessatau Pengembang.

    2. Untuk langkah 7, pilih Tambahkan profil secara manual ke file AWS kredenial Anda opsi dan salin isinya.

  6. Tempel kredensi yang disalin ke credentials file lokal Anda dan hapus nama profil apa pun yang disisipkan. File Anda akan menyerupai berikut ini:

    [default]
aws_access_key_id=AKIAIOSFODNN7EXAMPLE
aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
aws_session_token=IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE

  7. Simpan credentials file

SDK for Java akan mengakses kredensil sementara ini ketika membuat klien layanan dan menggunakannya untuk setiap permintaan. Pengaturan untuk peran IAM yang dipilih pada langkah 5a menentukan berapa lama kredensil sementara valid. Durasi maksimum adalah dua belas jam.

Setelah kredensi sementara berakhir, ulangi langkah 4 hingga 7.

Instal Lingkungan Pengembangan Java

AWS SDK for Javamemerlukan J2SE Development Kit 6.0 atau yang lebih baru. Anda dapat mengunduh perangkat lunak Java terbaru dari http://www.oracle.com/technetwork/java/javase/downloads/.

penting

Versi Java 1.6 (JS2E 6.0) tidak memiliki dukungan bawaan untuk sertifikat SSL yang ditandatangani SHA256, yang diperlukan untuk semua koneksi HTTPS setelah 30 September 2015. AWS

Versi Java 1.7 atau yang lebih baru dikemas dengan sertifikat yang diperbarui dan tidak terpengaruh oleh masalah ini.

Memilih JVM

Untuk kinerja terbaik dari aplikasi berbasis server Anda denganAWS SDK for Java, kami sarankan Anda menggunakan versi 64-bit dari Java Virtual Machine (JVM). JVM ini hanya berjalan dalam mode server, bahkan jika Anda menentukan -Client opsi pada waktu berjalan.

Menggunakan versi 32-bit dari JVM dengan -Server opsi pada waktu berjalan harus memberikan kinerja yang sebanding dengan JVM 64-bit.