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

AWS SDK for Java 1.x telah memasuki mode pemeliharaan pada 31 Juli 2024, dan akan mencapai end-of-supportpada 31 Desember 2025. Kami menyarankan Anda bermigrasi ke AWS SDK for Java 2.xuntuk terus menerima fitur baru, peningkatan ketersediaan, dan pembaruan keamanan.

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 menggunakan AWS SDK for Java, kondisi berikut diperlukan:

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

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

  • Lingkungan pengembangan dengan elemen-elemen berikut:

penting

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

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

Kemampuan masuk ke portal AWS akses

Portal AWS akses adalah lokasi web tempat Anda masuk secara manual ke Pusat IAM Identitas. 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 Pusat IAM Identitas di Panduan Referensi AWS SDKs dan Alat. Jangan ikuti Langkah 2 karena AWS SDK for Java 1.x tidak mendukung penyegaran token otomatis dan pengambilan otomatis kredenal sementara untuk Langkah 2 SDK yang dijelaskan.

Siapkan file konfigurasi bersama

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

Siapkan config file bersama

Contoh berikut menunjukkan konten config file bersama.

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

Untuk tujuan pengembangan, gunakan yang Wilayah AWS terdekat dengan 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 IAM peran Akun AWS dan melalui portal AWS akses, konfigurasikan lingkungan pengembangan Anda dengan kredensi sementara untuk diakses. SDK

Langkah-langkah untuk mengatur credentials file lokal dengan kredensi sementara

  1. Buat credentials file bersama.

  2. Dalam credentials file, rekatkan teks placeholder berikut hingga Anda menempelkan kredensi 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 di sistem pengembangan lokal Anda. File ini berisi profil [default] yang digunakan SDK untuk Java jika profil bernama tertentu tidak ditentukan.

  4. Masuk ke portal AWS akses.

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

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

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

  6. Rekatkan kredensi yang disalin ke credentials file lokal Anda dan hapus nama profil apa pun yang ditempelkan. File Anda harus menyerupai yang berikut ini:

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

  7. Simpan credentials file

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

Setelah kredensi sementara kedaluwarsa, ulangi langkah 4 hingga 7.

Instal Lingkungan Pengembangan Java

AWS SDK for Java V1 membutuhkan Java 7 JDK atau yang lebih baru. Jika Anda menggunakan versi 1.12.767 atau sebelumnyaSDK, Anda dapat menggunakan Java 7, tetapi jika Anda menggunakan versi 1.12.768 atau yang lebih baru, Java 8 diperlukan. SDK Repositori pusat Maven mencantumkan versi terbaru untuk Java. SDK

Ini AWS SDK for Java bekerja dengan Oracle Java SE Development Kit dan dengan distribusi Open Java Development Kit (OpenJDK) seperti Amazon Corretto, Red Hat Open, dan Adoptium. JDK