Mengonfigurasi penyedia identitas

Anda sedang melihat dokumentasi Apigee Edge.
Buka Dokumentasi Apigee X. info

Untuk portal terintegrasi, Anda dapat menentukan penyedia identitas untuk mendukung jenis autentikasi yang ditentukan dalam tabel berikut.

Manfaat autentikasi SAML untuk portal terintegrasi

Mengonfigurasi SAML sebagai penyedia identitas untuk portal terintegrasi menawarkan manfaat berikut:

• Siapkan program developer Anda sekali dan gunakan kembali di beberapa portal terintegrasi. Pilih program developer saat membuat portal terintegrasi. Mengupdate atau mengubah program developer dengan mudah seiring berkembangnya persyaratan.
• Kontrol penuh pengelolaan pengguna
  Hubungkan server SAML perusahaan Anda ke portal terintegrasi. Saat pengguna keluar dari organisasi dan dicabut aksesnya secara terpusat, mereka tidak dapat lagi melakukan autentikasi dengan layanan SSO untuk menggunakan portal terintegrasi.

Mengonfigurasi penyedia identitas bawaan

Konfigurasi penyedia identitas bawaan, seperti yang dijelaskan di bagian berikut.

Mengakses halaman Penyedia Identitas Bawaan

Untuk mengakses penyedia identitas bawaan:

1. Pilih Publikasikan > Portal di menu navigasi samping untuk menampilkan daftar portal.
2. Klik baris portal tempat Anda ingin melihat tim.
3. Klik Akun di halaman landing portal. Atau, Anda dapat memilih Akun di drop-down portal di menu navigasi atas.
4. Klik tab Authentication.
5. Di bagian Identity providers, klik jenis penyedia Built-in.
   
6. Konfigurasikan penyedia identitas bawaan, seperti yang dijelaskan di bagian berikut:
   • Mengaktifkan penyedia identitas bawaan
   • Membatasi pendaftaran portal menurut alamat email atau domain
   • Mengonfigurasi notifikasi email

Mengaktifkan penyedia identitas bawaan

Untuk mengaktifkan penyedia identitas bawaan:

1. Akses halaman Penyedia Identitas Bawaan.
2. Klik di bagian Konfigurasi Penyedia.

3. Centang kotak Enabled untuk mengaktifkan penyedia identitas.
   

   Untuk menonaktifkan penyedia identitas bawaan, hapus centang pada kotak.

4. Klik Simpan.

Batasi pendaftaran portal menurut alamat email atau domain

Batasi pendaftaran portal dengan mengidentifikasi alamat email individual (developer@some-company.com) atau domain email (some-company.com, tanpa @ di awal) yang dapat membuat akun di portal Anda.

Untuk mencocokkan semua subdomain bertingkat, tambahkan string karakter pengganti *. ke domain atau subdomain. Misalnya, *.example.com akan cocok dengan test@example.com, test@dev.example.com, dan seterusnya.

Jika dibiarkan kosong, alamat email apa pun dapat digunakan untuk mendaftar di portal.

Untuk membatasi pendaftaran portal menurut alamat email atau domain:

1. Akses halaman Penyedia Identitas Bawaan.
2. Klik di bagian Konfigurasi Penyedia.
3. Di bagian Pembatasan akun, masukkan alamat email atau domain email yang ingin Anda izinkan untuk mendaftar dan login ke portal di kotak teks lalu klik +.
4. Tambahkan entri lain, jika diperlukan.
5. Untuk menghapus entri, klik x di samping entri.
6. Klik Simpan.

Mengonfigurasi notifikasi email

Untuk penyedia bawaan, Anda dapat mengaktifkan dan mengonfigurasi notifikasi email berikut:

Saat mengonfigurasi notifikasi email:

• Gunakan tag HTML untuk memformat teks. Pastikan untuk mengirim email percobaan guna memvalidasi format yang muncul seperti yang diharapkan.

• Anda dapat menyisipkan satu atau beberapa variabel berikut yang akan diganti saat notifikasi email dikirim.

  Variabel	Deskripsi
  {{firstName}}	Nama depan
  {{lastName}}	Nama belakang
  {{email}}	Alamat email
  {{siteurl}}	Link ke portal live
  {{verifylink}}	Link yang digunakan untuk verifikasi akun

Untuk mengonfigurasi notifikasi email:

1. Akses halaman Penyedia Identitas Bawaan.

2. Untuk mengonfigurasi notifikasi email yang dikirim ke:

   • Penyedia API untuk aktivasi akun developer baru, klik di bagian Notifikasi Akun.
   • Pengguna portal untuk memverifikasi identitas mereka, klik di bagian Verifikasi Akun.

3. Edit kolom Subjek dan Isi.

4. Klik Kirim Email Uji Coba untuk mengirim email percobaan ke alamat email Anda.

5. Klik Simpan.

Mengonfigurasi penyedia identitas SAML (beta)

Konfigurasi penyedia identitas SAML, seperti yang dijelaskan di bagian berikut.

Mengakses halaman Penyedia Identitas SAML

Untuk mengakses penyedia identitas SAML:

1. Pilih Publikasikan > Portal di menu navigasi samping untuk menampilkan daftar portal.
2. Klik baris portal tempat Anda ingin melihat tim.
3. Klik Akun di halaman landing portal. Atau, Anda dapat memilih Akun di drop-down portal di menu navigasi atas.
4. Klik tab Authentication.
5. Di bagian Identity providers, klik jenis penyedia SAML.
   

6. Konfigurasi penyedia identitas SAML, seperti yang dijelaskan di bagian berikut:

   • Mengaktifkan penyedia identitas SAML
   • Mengonfigurasi setelan SAML
   • Mengonfigurasi atribut pengguna kustom untuk penyedia identitas SAML
   • Upload sertifikat baru

Aktifkan penyedia identitas SAML

Untuk mengaktifkan penyedia identitas SAML:

1. Akses halaman Penyedia Identitas SAML.
2. Klik di bagian Konfigurasi Penyedia.

3. Centang kotak Enabled untuk mengaktifkan penyedia identitas.

   

   Untuk menonaktifkan penyedia identitas SAML, hapus centang pada kotak.

4. Klik Simpan.

5. Jika Anda telah mengonfigurasi domain kustom, lihat Menggunakan domain kustom dengan penyedia identitas SAML.

Mengonfigurasi setelan SAML

Untuk mengonfigurasi setelan SAML:

1. Akses halaman Penyedia Identitas SAML.
2. Di bagian SAML Settings, klik .

3. Klik Salin di samping URL metadata SP.
   

4. Konfigurasi penyedia identitas SAML menggunakan informasi di file metadata penyedia layanan (SP).

   Untuk beberapa penyedia identitas SAML, Anda hanya akan diminta untuk memasukkan URL metadata. Untuk kasus lainnya, Anda harus mengekstrak informasi spesifik dari file metadata dan memasukkannya ke dalam formulir.
   
   Pada kasus yang kedua, tempel URL ke browser untuk mendownload file metadata SP dan mengekstrak informasi yang diperlukan. Misalnya, ID entitas atau URL login dapat diekstrak dari elemen berikut dalam file metadata SP:

   • <md:EntityDescriptor xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata" ID="diyyaumzqchrbui-a5vnmu1sp8qzekbd.apigee-saml-login" entityID="diyyaumzqchrbui-a5vnmu1sp8qzekbd.apigee-saml-login">
   • <md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="https://diyyaumzqchrbui-a5vnmu1sp8qzekbd.portal-login.apigee.com/saml/SSO/alias/diyyaumzqchrbui-a5vnmu1sp8qzekbd.apigee-saml-login" index="0" isDefault="true"/>

5. Konfigurasi setelan SAML untuk penyedia identitas.

   Di bagian SAML Settings, edit nilai berikut yang diperoleh dari file metadata penyedia identitas SAML:

   Setelan SAML	Deskripsi
   URL login	URL tempat pengguna dialihkan untuk login ke penyedia identitas SAML. Misalnya: https://dev-431871.oktapreview.com/app/googledev431871_devportalsaml_1/exkhgdyponHIp97po0h7/sso/saml
   URL Keluar	URL tempat pengguna dialihkan untuk logout dari penyedia identitas SAML. Kosongkan kolom ini kosong jika: Penyedia identitas SAML Anda tidak menyediakan URL logout Anda tidak ingin pengguna logout dari penyedia identitas SAML saat mereka logout dari portal terintegrasi Anda ingin mengaktifkan domain kustom (lihat masalah umum)
   ID entitas IDP	ID unik untuk penyedia identitas SAML. Misalnya: http://www.okta.com/exkhgdyponHIp97po0h7

6. Klik Simpan.

Mengonfigurasi atribut pengguna kustom untuk penyedia identitas SAML

Untuk memastikan pemetaan yang tepat antara penyedia identitas SAML dan akun developer portal, sebaiknya Anda membuat dan mengonfigurasi atribut pengguna kustom yang ditentukan dalam tabel berikut untuk penyedia identitas SAML Anda. Tetapkan nilai setiap atribut khusus ke atribut pengguna yang sesuai yang ditentukan oleh penyedia identitas SAML Anda (misalnya, Okta).

Berikut cara mengonfigurasi atribut pengguna kustom dan atribut NameID menggunakan Okta sebagai penyedia identitas SAML pihak ketiga.

Menggunakan domain kustom dengan penyedia identitas SAML

Setelah mengonfigurasi dan mengaktifkan penyedia identitas SAML, Anda dapat mengonfigurasi domain kustom (seperti, developers.example.com), seperti yang dijelaskan dalam artikel Menyesuaikan domain Anda.

Penting untuk menjaga sinkronisasi setelan konfigurasi antara domain kustom dan penyedia identitas SAML. Jika setelan konfigurasi tidak sinkron, Anda mungkin mengalami masalah selama otorisasi. Misalnya, permintaan otorisasi yang dikirim ke penyedia identitas SAML mungkin memiliki AssertionConsumerServiceURL yang tidak ditentukan menggunakan domain kustom.

Agar setelan konfigurasi tetap sinkron antara domain kustom dan penyedia identitas SAML:

• Jika Anda mengonfigurasi atau mengupdate domain kustom setelah mengaktifkan dan mengonfigurasi penyedia identitas SAML, simpan konfigurasi domain kustom dan pastikan domain tersebut diaktifkan. Tunggu sekitar 30 menit hingga cache dibatalkan, lalu konfigurasi ulang penyedia identitas SAML menggunakan informasi yang diperbarui di file metadata penyedia layanan (SP), seperti yang dijelaskan di Mengonfigurasi setelan SAML. Anda akan melihat domain kustom di Metadata SP.

• Jika Anda mengonfigurasi domain kustom sebelum mengonfigurasi dan mengaktifkan penyedia identitas SAML, Anda harus mereset domain kustom (dijelaskan di bawah) untuk memastikan bahwa penyedia identitas SAML dikonfigurasi dengan benar.

• Jika perlu mereset (menonaktifkan dan mengaktifkan kembali) penyedia identitas SAML, seperti yang dijelaskan dalam Mengaktifkan penyedia identitas SAML, Anda juga harus Mereset domain kustom (dijelaskan di bawah).

Mereset domain kustom

Untuk mereset (menonaktifkan dan mengaktifkan) domain kustom:

1. Pilih Publikasikan > Portal di navigasi sebelah kiri dan pilih portal Anda.
2. Pilih Setelan di menu drop-down di menu navigasi atas atau di halaman landing.
3. Klik tab Domains.
4. Klik Disable untuk menonaktifkan domain kustom.
5. Klik Aktifkan untuk mengaktifkan kembali domain kustom.

Untuk mengetahui informasi selengkapnya, lihat Menyesuaikan domain.

Upload sertifikat baru

Untuk mengupload sertifikat baru:

1. Download sertifikat dari penyedia identitas SAML Anda.
   

2. Akses halaman Penyedia Identitas SAML.

3. Klik baris zona identitas tempat Anda ingin mengupload sertifikat baru.

4. Di bagian Certificate, klik .

5. Klik Cari dan buka sertifikat di direktori lokal Anda.

6. Klik Buka untuk mengupload sertifikat baru.
   Kolom Informasi sertifikat diperbarui untuk mencerminkan sertifikat yang dipilih.
   

7. Pastikan bahwa sertifikat valid dan masa berlakunya belum habis.

8. Klik Simpan.

Mengonversi sertifikat x509 ke format PEM

Jika mendownload sertifikat x509, Anda harus mengonversinya ke format PEM.

Untuk mengonversi sertifikat x509 ke format PEM:

1. Salin konten ds:X509Certificate element dari file metadata penyedia identitas SAML dan tempel ke editor teks favorit Anda.
2. Tambahkan baris berikut di bagian atas file:
   -----BEGIN CERTIFICATE-----
3. Tambahkan baris berikut di bagian bawah file:
   -----END CERTIFICATE-----
4. Simpan file menggunakan ekstensi .pem.

Berikut adalah contoh konten file PEM:

-----BEGIN CERTIFICATE-----
MIICMzCCAZygAwIBAgIJALiPnVsvq8dsMA0GCSqGSIb3DQEBBQUAMFMxCzAJBgNV
BAYTAlVTMQwwCgYDVQQIEwNmb28xDDAKBgNVBAcTA2ZvbzEMMAoGA1UEChMDZm9v
MQwwCgYDVQQLEwNmb28xDDAKBgNVBAMTA2ZvbzAeFw0xMzAzMTkxNTQwMTlaFw0x
ODAzMTgxNTQwMTlaMFMxCzAJBgNVBAYTAlVTMQwwCgYDVQQIEwNmb28xDDAKBgNV
BAcTA2ZvbzEMMAoGA1UEChMDZm9vMQwwCgYDVQQLEwNmb28xDDAKBgNVBAMTA2Zv
bzCBnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAzdGfxi9CNbMf1UUcvDQh7MYB
OveIHyc0E0KIbhjK5FkCBU4CiZrbfHagaW7ZEcN0tt3EvpbOMxxc/ZQU2WN/s/wP
xph0pSfsfFsTKM4RhTWD2v4fgk+xZiKd1p0+L4hTtpwnEw0uXRVd0ki6muwV5y/P
+5FHUeldq+pgTcgzuK8CAwEAAaMPMA0wCwYDVR0PBAQDAgLkMA0GCSqGSIb3DQEB
BQUAA4GBAJiDAAtY0mQQeuxWdzLRzXmjvdSuL9GoyT3BF/jSnpxz5/58dba8pWen
v3pj4P3w5DoOso0rzkZy2jEsEitlVM2mLSbQpMM+MUVQCQoiG6W9xuCFuxSrwPIS
pAqEAuV4DNoxQKKWmhVv+J0ptMWD25Pnpxeq5sXzghfJnslJlQND
-----END CERTIFICATE-----