Siapkan AWS SDK for Java 2.x

Bagian ini memberikan informasi tentang cara mengatur lingkungan pengembangan dan proyek Anda untuk menggunakan AWS SDK for Java 2.x.

Gambaran umum pengaturan

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 peran IAM 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:

  • File konfigurasi bersama yang diatur setidaknya dalam salah satu cara berikut:

    • configFile ini berisi pengaturan masuk tunggal Pusat Identitas IAM sehingga SDK bisa mendapatkan kredensi. AWS

    • credentialsFile tersebut berisi kredensi sementara.

  • Instalasi Java 8 atau yang lebih baru.

  • Alat otomatisasi build seperti Maven atau Gradle.

  • Editor teks untuk bekerja dengan kode.

  • (Opsional, tetapi disarankan) IDE (lingkungan pengembangan terintegrasi) seperti IntelliJ IDEA, Eclipse, atau. NetBeans

    Saat Anda menggunakan IDE, Anda juga dapat mengintegrasikan AWS Toolkit s agar lebih mudah digunakan Layanan AWS. AWS Toolkit for EclipseIni adalah dua toolkit yang dapat Anda gunakan untuk pengembangan Java. AWS Toolkit for IntelliJ

• Sesi portal AWS akses aktif saat Anda siap menjalankan aplikasi Anda. Anda menggunakan AWS Command Line Interface untuk memulai proses masuk ke portal akses IAM Identity Center. AWS

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 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 SDK atau. AWS CLI

Kemampuan masuk ke portal AWS akses

Portal AWS akses adalah lokasi web tempat Anda masuk secara manual ke Pusat Identitas IAM. 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 dalam topik autentikasi Pusat Identitas IAM di AWS SDK dan Panduan Referensi Alat.

Menyiapkan akses masuk tunggal untuk SDK

Setelah Anda menyelesaikan Langkah 2 di bagian akses terprogram agar SDK menggunakan autentikasi IAM Identity Center, sistem Anda harus berisi elemen-elemen berikut.

• Itu AWS CLI, yang Anda gunakan untuk memulai sesi portal AWS akses sebelum Anda menjalankan aplikasi Anda.

• ~/.aws/configFile yang berisi profil default. SDK for Java menggunakan konfigurasi penyedia token SSO profil untuk memperoleh kredensional sebelum mengirim permintaan ke. AWSsso_role_nameNilai, yang merupakan peran IAM yang terhubung ke set izin Pusat Identitas IAM, harus memungkinkan akses ke yang Layanan AWS digunakan dalam aplikasi Anda.

  configFile contoh berikut menunjukkan profil default yang diatur dengan konfigurasi penyedia token SSO. sso_sessionPengaturan profil mengacu pada sso-session bagian bernama. sso-sessionBagian ini berisi pengaturan untuk memulai sesi portal AWS akses.

  [default]
  sso_session = my-sso
  sso_account_id = 111122223333
  sso_role_name = SampleRole
  region = us-east-1
  output = json
  
  [sso-session my-sso]
  sso_region = us-east-1
  sso_start_url = https://provided-domain.awsapps.com/start
  sso_registration_scopes = sso:account:access

Untuk detail selengkapnya tentang pengaturan yang digunakan dalam konfigurasi penyedia token SSO, lihat konfigurasi penyedia token SSO di AWS SDK dan Panduan Referensi Alat.

Jika lingkungan pengembangan Anda tidak disiapkan untuk akses terprogram seperti yang ditunjukkan sebelumnya, ikuti Langkah 2 di Panduan Referensi SDK.

Masuk menggunakan AWS CLI

Sebelum menjalankan aplikasi yang mengakses Layanan AWS, Anda memerlukan sesi portal AWS akses aktif agar SDK dapat menggunakan autentikasi IAM Identity Center untuk menyelesaikan kredensialnya. Jalankan perintah berikut di AWS CLI untuk masuk ke portal AWS akses.

aws sso login

Karena Anda memiliki pengaturan profil default, Anda tidak perlu memanggil perintah dengan --profile opsi. Jika konfigurasi penyedia token SSO Anda menggunakan profil bernama, perintahnya adalahaws sso login --profile named-profile.

Untuk menguji apakah Anda sudah memiliki sesi aktif, jalankan AWS CLI perintah berikut.

aws sts get-caller-identity

Respons terhadap perintah ini harus melaporkan akun IAM Identity Center dan set izin yang dikonfigurasi dalam config file bersama.

catatan

Jika Anda sudah memiliki sesi portal AWS akses aktif dan menjalankannyaaws sso login, Anda tidak akan diminta untuk memberikan kredensi.

Namun, Anda akan melihat dialog yang meminta izin botocore untuk mengakses informasi Anda. botocoreadalah fondasi untuk AWS CLI .

Pilih Izinkan untuk mengotorisasi akses ke informasi Anda untuk AWS CLI dan SDK for Java.

Instal Java dan alat build

Lingkungan pengembangan Anda membutuhkan yang berikut:

• Java 8 atau yang lebih baru. Ini AWS SDK for Java bekerja dengan Oracle Java SE Development Kit dan dengan distribusi Open Java Development Kit (OpenJDK) seperti, Red Hat OpenJDK, Amazon Correttodan Adoptium.

• Alat build atau IDE yang mendukung Maven Central seperti Apache Maven, Gradle, atau IntelliJ.

  • Untuk informasi tentang cara menginstal dan menggunakan Maven, lihat https://maven.apache.org/.

  • Untuk informasi tentang cara menginstal dan menggunakan Gradle, lihat https://gradle.org/.

  • Untuk informasi tentang cara menginstal dan menggunakan IntelliJ IDEA, lihat https://www.jetbrains.com/idea/.

Opsi otentikasi tambahan

Untuk opsi lainnya tentang otentikasi SDK, seperti penggunaan profil dan variabel lingkungan, lihat bagian konfigurasi di Panduan Referensi AWS SDK dan Alat.