Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Buat penyedia identitas OpenID Connect (OIDC) di IAM
IAMOIDCPenyedia identitas adalah entitas IAM yang menggambarkan layanan penyedia identitas eksternal (IdP) yang mendukung standar OpenID Connect
Anda dapat membuat dan mengelola penyedia IAM OIDC identitas menggunakan AWS Management Console, AWS Command Line Interface, Alat untuk Windows PowerShell, atau IAMAPI.
Setelah membuat penyedia IAM OIDC identitas, Anda harus membuat satu atau lebih IAM peran. Peran adalah identitas AWS yang tidak memiliki kredensialnya sendiri (seperti yang pengguna lakukan). Namun dalam konteks ini, peran ditetapkan secara dinamis ke pengguna gabungan yang diautentikasi oleh IdP organisasi Anda. Peran mengizinkan IdP organisasi Anda meminta kredensial keamanan sementara untuk akses ke AWS. Kebijakan yang ditetapkan untuk peran menentukan hal yang boleh dilakukan pengguna gabungan. AWS Untuk membuat peran bagi penyedia identitas pihak ketiga, lihat Buat peran untuk penyedia identitas pihak ketiga (federasi).
penting
Saat Anda mengonfigurasi kebijakan berbasis identitas untuk tindakan yang mendukung oidc-provider
sumber daya, IAM evaluasi penyedia OIDC identitas lengkapURL, termasuk jalur yang ditentukan. Jika penyedia OIDC identitas Anda URL memiliki jalur, Anda harus menyertakan jalur itu dalam nilai oidc-provider
ARN sebagai Resource
elemen. Anda juga memiliki opsi untuk menambahkan garis miring ke depan dan wildcard (/*
) ke URL domain atau menggunakan karakter wildcard (*
dan?
) di titik mana pun di jalur. URL Jika penyedia OIDC identitas URL dalam permintaan tidak cocok dengan nilai yang ditetapkan dalam Resource
elemen kebijakan, permintaan gagal.
Untuk memecahkan masalah umum dengan IAM OIDC federasi, lihat Menyelesaikan kesalahan yang terkait dengan OIDC pada AWS re:Post
Topik
Prasyarat: Validasi konfigurasi penyedia identitas Anda
Sebelum Anda dapat membuat penyedia IAM OIDC identitas, Anda harus memiliki informasi berikut dari IDP Anda. Untuk informasi lebih lanjut tentang mendapatkan Informasi konfigurasi OIDC penyedia, lihat dokumentasi untuk IdP.
-
Tentukan penyedia OIDC identitas Anda yang tersedia URL untuk umum. URLHarus dimulai dengan https://. Per the OIDC standard, path com ponent diperbolehkan tetapi parameter kueri tidak. Biasanya, hanya URL terdiri dari nama host, seperti https://server.example.org or https://example.com. URLSeharusnya tidak berisi nomor port.
-
Tambahkan /.well-known/openid-configuration ke akhir penyedia OIDC identitas Anda untuk melihat dokumen konfigurasi dan metadata penyedia yang tersedia URL untuk umum. Anda harus memiliki dokumen penemuan dalam JSON format dengan dokumen konfigurasi penyedia dan metadata yang dapat diambil dari titik akhir penemuan penyedia OpenID Connect
. URL -
Konfirmasikan bahwa nilai berikut disertakan dalam informasi konfigurasi penyedia Anda. Jika konfigurasi terbuka Anda tidak memiliki salah satu bidang ini, Anda harus memperbarui dokumen penemuan Anda. Proses ini dapat bervariasi berdasarkan penyedia identitas Anda, jadi ikuti dokumentasi IDP Anda untuk menyelesaikan tugas ini.
-
penerbit: URL Untuk domain Anda.
-
jwks_uri: Titik akhir JSON Web Key Set (JWKS) tempat IAM mendapatkan kunci publik Anda. Penyedia identitas Anda harus menyertakan titik akhir JSON Web Key Set (JWKS) dalam konfigurasi openid. Ini URI menentukan di mana mendapatkan kunci publik Anda yang digunakan untuk memverifikasi token yang ditandatangani dari penyedia identitas Anda.
-
claims_supported: Informasi tentang pengguna yang membantu Anda memastikan respons OIDC autentikasi dari IdP berisi atribut wajib yang AWS digunakan dalam IAM kebijakan untuk memeriksa izin bagi pengguna gabungan. Untuk daftar kunci IAM kondisi yang dapat digunakan untuk klaim, lihatKunci yang tersedia untuk AWS OIDC federasi.
-
aud: Anda harus menentukan nilai klaim audiens masalah IDP Anda di JSON Web Tokens ()JWTs. Klaim audiens (aud) adalah aplikasi khusus dan mengidentifikasi penerima token yang dituju. Saat Anda mendaftarkan aplikasi seluler atau web dengan penyedia OpenID Connect, mereka membuat ID klien yang mengidentifikasi aplikasi. ID klien adalah pengenal unik untuk aplikasi Anda yang diteruskan dalam klaim aud untuk autentikasi. Klaim aud harus sesuai dengan nilai Audiens saat membuat penyedia IAM OIDC identitas Anda.
-
iat: Klaim harus menyertakan nilai untuk
iat
yang mewakili waktu token ID dikeluarkan. -
iss: URL Penyedia identitas. URLHarus dimulai dengan https:// and should correspond to the Provider URL provided to IAM. Per the OIDC standard, path com ponent diperbolehkan tetapi parameter kueri tidak. Biasanya, hanya URL terdiri dari nama host, seperti https://server.example.org or https://example.com. URLSeharusnya tidak berisi nomor port.
-
-
response_types_supported: id_token
-
subject_types_supported: publik
-
id_token_signing_alg_values_supported:,,,,, RS256 RS384 RS512 ES256 ES384 ES512
catatan
Anda dapat menyertakan klaim tambahan seperti
my_custom_claim
pada contoh di bawah ini; namun, AWS STS akan mengabaikan klaim tersebut.{ "issuer": "https://example-domain.com", "jwks_uri": "https://example-domain.com/jwks/keys", "claims_supported": [ "aud", "iat", "iss", "name", "sub", "my_custom_claim" ], "response_types_supported": [ "id_token" ], "id_token_signing_alg_values_supported": [ "RS256", "RS384", "RS512", "ES256", "ES384", "ES512" ], "subject_types_supported": [ "public" ] }
-
Membuat dan mengelola OIDC penyedia (konsol)
Ikuti petunjuk ini untuk membuat dan mengelola penyedia IAM OIDC identitas di AWS Management Console.
penting
Jika Anda menggunakan penyedia OIDC identitas dari Google, Facebook, atau Amazon Cognito, jangan buat penyedia IAM identitas terpisah menggunakan prosedur ini. Penyedia OIDC identitas ini sudah terpasang di AWS dan tersedia untuk Anda gunakan. Alih-alih, ikuti langkah-langkah untuk membuat peran baru bagi penyedia identitas Anda, lihat Buat peran untuk federasi OpenID Connect (konsol).
Untuk membuat penyedia IAM OIDC identitas (konsol)
-
Sebelum membuat penyedia IAM OIDC identitas, Anda harus mendaftarkan aplikasi dengan IdP untuk menerima ID klien. ID klien (juga dikenal sebagai audiens) adalah pengenal unik untuk aplikasi yang diberikan kepada Anda saat mendaftarkan aplikasi dengan IdP. Untuk informasi lebih lanjut tentang mendapatkan ID klien, lihat dokumentasi untuk IdP.
catatan
AWS mengamankan komunikasi dengan penyedia OIDC identitas (IdPs) menggunakan pustaka otoritas sertifikat root tepercaya (CAs) kami untuk memverifikasi sertifikat titik akhir JSON Web Key Set (JWKS). TLS Jika OIDC IDP Anda bergantung pada sertifikat yang tidak ditandatangani oleh salah satu dari tepercaya iniCAs, maka kami mengamankan komunikasi menggunakan cap jempol yang diatur dalam konfigurasi iDP. AWS akan kembali ke verifikasi sidik jari jika kami tidak dapat mengambil TLS sertifikat atau jika TLS v1.3 diperlukan.
Buka IAM konsol di https://console.aws.amazon.com/iam/
. -
Di panel navigasi, pilih Penyedia identitas, lalu pilih Tambahkan penyedia.
-
Untuk Konfigurasi penyedia, pilih OpenID Connect.
-
Untuk Provider URL, URL ketik IDP. URLHarus mematuhi pembatasan ini:
-
URLIni peka terhadap huruf besar-kecil.
-
URLHarus dimulai dengan
https://
. -
URLSeharusnya tidak berisi nomor port.
-
Di dalam Anda Akun AWS, setiap penyedia IAM OIDC identitas harus menggunakan yang unikURL. Jika Anda mencoba mengirimkan URL yang telah digunakan untuk penyedia OpenID Connect di Akun AWS, Anda akan mendapatkan kesalahan.
-
-
Untuk Audiens, ketik ID klien dari aplikasi yang Anda daftarkan dengan IdP dan diterima dalamTahapĀ 1, dan itu membuat permintaan ke. AWS Jika memiliki klien tambahan IDs (juga dikenal sebagai audiens) untuk IdP ini, Anda dapat menambahkannya nanti di halaman detail penyedia.
catatan
Jika JWT token IDP Anda menyertakan
azp
klaim, masukkan nilai ini sebagai nilai Audiens.Jika penyedia OIDC identitas Anda menetapkan keduanya
aud
danazp
klaim dalam token, AWS STS akan menggunakan nilai dalamazp
klaim sebagaiaud
klaim. -
(Opsional) Untuk Menambahkan tanda, Anda dapat menambahkan pasangan nilai-kunci guna membantu mengidentifikasi dan mengelola. IdPs Anda juga dapat menggunakan tanda untuk mengontrol akses ke sumber daya AWS . Untuk mempelajari lebih lanjut tentang menandai penyedia IAM OIDC identitas, lihatTandai OpenID Connect (OIDC) penyedia identitas. Pilih Tambahkan tanda. Masukkan nilai untuk setiap pasangan nilai-kunci tanda.
-
Verifikasi informasi yang telah Anda berikan. Setelah selesai, pilih Tambahkan penyedia. IAMakan mencoba mengambil dan menggunakan cap jempol CA perantara teratas dari sertifikat server iDP OIDC untuk membuat penyedia identitas. IAM OIDC
catatan
Rantai sertifikat penyedia OIDC identitas harus dimulai dengan domain atau penerbitURL, kemudian sertifikat perantara, dan diakhiri dengan sertifikat root. Jika urutan rantai sertifikat berbeda atau menyertakan duplikat atau sertifikat tambahan, maka Anda menerima kesalahan ketidakcocokan tanda tangan dan STS gagal memvalidasi Token JSON Web (). JWT Perbaiki urutan sertifikat dalam rantai yang dikembalikan dari server untuk menyelesaikan kesalahan. Untuk informasi selengkapnya tentang standar rantai sertifikat, lihat certificate_list di RFC 5246 di situs web Seri
. RFC -
Tugaskan IAM peran ke penyedia identitas Anda untuk memberikan identitas pengguna eksternal yang dikelola oleh izin penyedia identitas Anda untuk mengakses AWS sumber daya di akun Anda. Untuk mempelajari lebih lanjut tentang menciptakan peran untuk federasi identitas, lihat Buat peran untuk penyedia identitas pihak ketiga (federasi).
catatan
OIDC IdPs digunakan dalam kebijakan kepercayaan peran harus dalam akun yang sama dengan peran yang mempercayainya.
Untuk menambahkan atau menghapus sidik jari penyedia IAM OIDC identitas (konsol)
catatan
AWS mengamankan komunikasi dengan penyedia OIDC identitas (IdPs) menggunakan pustaka otoritas sertifikat root tepercaya (CAs) kami untuk memverifikasi sertifikat titik akhir JSON Web Key Set (JWKS). TLS Jika OIDC IDP Anda bergantung pada sertifikat yang tidak ditandatangani oleh salah satu dari tepercaya iniCAs, maka kami mengamankan komunikasi menggunakan cap jempol yang diatur dalam konfigurasi iDP. AWS akan kembali ke verifikasi sidik jari jika kami tidak dapat mengambil TLS sertifikat atau jika TLS v1.3 diperlukan.
Buka IAM konsol di https://console.aws.amazon.com/iam/
. -
Pada panel navigasi, silakan pilih Penyedia identitas. Kemudian pilih nama penyedia IAM identitas yang ingin Anda perbarui.
-
Pilih tab Verifikasi titik akhir, lalu di bagian Cetak Jempol, pilih Kelola. Untuk memasukkan nilai sidik jari baru, pilih Tambahkan sidik jari. Untuk menghapus sidik jari, pilih Hapus di samping sidik jari yang ingin Anda hapus.
catatan
Seorang penyedia IAM OIDC identitas harus memiliki setidaknya satu dan dapat memiliki maksimal lima sidik jari.
Setelah selesai, pilih Simpan perubahan.
Untuk menambahkan audiens untuk penyedia IAM OIDC identitas (konsol)
-
Di panel navigasi, pilih Penyedia identitas, kemudian pilih nama penyedia IAM identitas yang ingin Anda perbarui.
-
Di bagian Audiens, pilih Tindakan dan pilih Tambahkan audiens.
-
Ketik ID klien dari aplikasi yang Anda daftarkan dengan IdP dan diterima dalamTahapĀ 1, dan itu akan membuat permintaan ke. AWS Lalu, pilih Tambahkan audiens.
catatan
Seorang penyedia IAM OIDC identitas harus memiliki setidaknya satu dan dapat memiliki maksimal 100 audiens.
Untuk menghapus audiens untuk penyedia IAM OIDC identitas (konsol)
-
Di panel navigasi, pilih Penyedia identitas, kemudian pilih nama penyedia IAM identitas yang ingin Anda perbarui.
-
Di bagian Audiens, pilih tombol radio di samping audiens yang ingin Anda hapus, lalu pilih Tindakan.
-
Pilih Hapus audiens. Jendela baru terbuka.
-
Jika Anda menghapus audiens, identitas yang bergabung dengan audiens tidak dapat mengambil peran yang terkait dengan audiens. Di jendela, baca peringatan dan konfirmasikan bahwa Anda ingin menghapus audiens dengan mengetikkan kata
remove
di bidangnya. -
Pilih Hapus untuk menghapus audiens.
Untuk menghapus penyedia IAM OIDC identitas (konsol)
Buka IAM konsol di https://console.aws.amazon.com/iam/
. -
Pada panel navigasi, silakan pilih Penyedia identitas.
-
Pilih kotak centang di samping penyedia IAM identitas yang ingin Anda hapus. Jendela baru terbuka.
-
Konfirmasikan bahwa Anda ingin menghapus penyedia dengan mengetik kata
delete
di bidangnya. Lalu, pilih Hapus.
Membuat dan mengelola penyedia IAM OIDC identitas (AWS CLI)
Anda dapat menggunakan AWS CLI perintah berikut untuk membuat dan mengelola penyedia IAM OIDC identitas.
Untuk membuat penyedia IAM OIDC identitas (AWS CLI)
-
(Opsional) Untuk mendapatkan daftar semua penyedia IAM OIDC identitas di AWS akun Anda, jalankan perintah berikut:
-
Untuk membuat penyedia IAM OIDC identitas baru, jalankan perintah berikut:
Untuk memperbarui daftar sidik jari sertifikat server untuk penyedia IAM OIDC identitas yang sudah ada ()AWS CLI
-
Untuk memperbarui daftar sidik jari sertifikat server untuk penyedia IAM OIDC identitas, jalankan perintah berikut:
Untuk menandai penyedia IAM OIDC identitas yang ada (AWS CLI)
-
Untuk menandai penyedia IAM OIDC identitas yang sudah ada, jalankan perintah berikut:
Untuk mencantumkan tag untuk penyedia IAM OIDC identitas yang ada (AWS CLI)
-
Untuk membuat daftar tanda penyedia IAM OIDC identitas yang sudah ada, jalankan perintah berikut:
Untuk menghapus tag pada penyedia IAM OIDC identitas (AWS CLI)
-
Untuk menghapus tanda penyedia IAM OIDC identitas yang sudah ada, jalankan perintah berikut:
Untuk menambahkan atau menghapus ID klien dari penyedia IAM OIDC identitas yang sudah ada (AWS CLI)
-
(Opsional) Untuk mendapatkan daftar semua penyedia IAM OIDC identitas di AWS akun Anda, jalankan perintah berikut:
-
(Opsional) Untuk mendapatkan informasi detail tentang penyedia IAM OIDC identitas, jalankan perintah berikut:
-
Untuk menambahkan ID klien baru ke penyedia IAM OIDC identitas yang sudah ada, jalankan perintah berikut:
-
Untuk menghapus klien dari penyedia IAM OIDC identitas yang sudah ada, jalankan perintah berikut:
Untuk menghapus penyedia IAM OIDC identitas (AWS CLI)
-
(Opsional) Untuk mendapatkan daftar semua penyedia IAM OIDC identitas di AWS akun Anda, jalankan perintah berikut:
-
(Opsional) Untuk mendapatkan informasi detail tentang penyedia IAM OIDC identitas, jalankan perintah berikut:
-
Untuk menghapus penyedia IAM OIDC identitas, jalankan perintah berikut:
Membuat dan mengelola Penyedia OIDC Identitas (AWS API)
Anda dapat menggunakan IAM API perintah berikut untuk membuat dan mengelola OIDC penyedia.
Untuk membuat penyedia IAM OIDC identitas (AWS API)
-
(Opsional) Untuk mendapatkan daftar semua penyedia IAM OIDC identitas di AWS akun Anda, panggil operasi berikut:
-
Untuk membuat penyedia IAM OIDC identitas baru, panggil operasi berikut:
Untuk memperbarui daftar sidik jari sertifikat server untuk penyedia IAM OIDC identitas yang sudah ada ()AWS API
-
Untuk memperbarui daftar sidik jari sertifikat server untuk penyedia IAM OIDC identitas, panggil operasi berikut:
Untuk menandai penyedia IAM OIDC identitas yang ada (AWS API)
-
Untuk menandai penyedia IAM OIDC identitas yang sudah ada, panggil operasi berikut:
Untuk mencantumkan tag untuk penyedia IAM OIDC identitas yang ada (AWS API)
-
Untuk membuat daftar tanda penyedia IAM OIDC identitas yang sudah ada, panggil operasi berikut:
Untuk menghapus tag pada penyedia IAM OIDC identitas yang ada (AWS API)
-
Untuk menghapus tanda penyedia IAM OIDC identitas yang sudah ada, panggil operasi berikut:
Untuk menambahkan atau menghapus ID klien dari penyedia IAM OIDC identitas yang sudah ada (AWS API)
-
(Opsional) Untuk mendapatkan daftar semua penyedia IAM OIDC identitas di AWS akun Anda, panggil operasi berikut:
-
(Opsional) Untuk mendapatkan informasi detail tentang penyedia IAM OIDC identitas, panggil operasi berikut:
-
Untuk menambahkan ID klien baru ke penyedia IAM OIDC identitas yang sudah ada, panggil operasi berikut:
-
Untuk menghapus ID klien dari penyedia IAM OIDC identitas yang ada, panggil operasi berikut:
Untuk menghapus penyedia IAM OIDC identitas (AWS API)
-
(Opsional) Untuk mendapatkan daftar semua penyedia IAM OIDC identitas di AWS akun Anda, panggil operasi berikut:
-
(Opsional) Untuk mendapatkan informasi detail tentang penyedia IAM OIDC identitas, panggil operasi berikut:
-
Untuk menghapus penyedia IAM OIDC identitas, panggil operasi berikut: