Konfigurasikan KeyCloak untuk digunakan dengan Adobe SSO

Terakhir diperbarui pada 29 Okt 2026

Siapkan KeyCloak sebagai penyedia identitas SAML (IdP) agar pengguna Anda dapat masuk ke aplikasi dan layanan Adobe menggunakan kredensial organisasi mereka.

Sebelum Anda memulai

Pastikan Anda memiliki:

  • Peran admin sistem di Adobe Admin Console
  • Akses admin ke realm KeyCloak yang mengautentikasi pengguna Adobe Anda
  • Domain yang dapat Anda verifikasi dan tambahkan ke direktori
Kiat

Pastikan alamat email setiap pengguna termasuk dalam domain yang diklaim di Admin Console. KeyCloak menggunakan alamat email sebagai pengidentifikasi pengguna.

Buat direktori dan unduh metadata Adobe

Masuk ke Admin Console, navigasikan ke Pengaturan > Identitas > Direktori, dan pilih Buat Direktori.

Masukkan nama direktori, pilih Federated ID, lalu pilih Berikutnya.

Pilih Penyedia SAML Lainnya, lalu Berikutnya.

Pada layar Siapkan IdP, pilih Unduh file Metadata Adobe. Biarkan layar ini tetap terbuka untuk langkah berikutnya.

Impor klien Adobe ke KeyCloak

Masuk ke KeyCloak Admin Console dan pilih realm yang mengautentikasi pengguna Adobe Anda.

Pilih Klien > Impor klien.

Di File Sumber Daya, pilih Telusuri dan unggah file metadata Adobe. KeyCloak akan mengisi ID entitas, URL ACS, sertifikat, dan pengaturan SAML lainnya milik Adobe dari file tersebut.

Catatan

Impor file metadata Adobe daripada membuat klien secara manual. Hal ini memastikan KeyCloak menggunakan pengaturan SAML Adobe yang tepat.

Di Nama, masukkan Adobe Identity Management – <nama organisasi Anda>, lalu pilih Simpan.

Verifikasi pengaturan yang diimpor:

  • URI pengalihan yang valid menunjukkan URL ACS Adobe.
  • Format Name ID adalah email.
  • Penandatanganan diaktifkan di Signature and Encryption.
  • Tab Keys menampilkan sertifikat Adobe.

Memetakan atribut pengguna

Adobe memerlukan alamat email, nama depan, dan nama belakang pengguna dalam pernyataan SAML.Buat cakupan klien yang mengirimkannya.

Di panel navigasi, pilih Cakupan klien > Buat cakupan klien.

Masukkan Adobe Identity Scope sebagai nama, pilih SAML sebagai protokol, lalu pilih Simpan.

Di tab Mapper, pilih Konfigurasikan mapper baru (atau Tambahkan mapper > Berdasarkan konfigurasi), lalu pilih Atribut Pengguna.

Masukkan nilai untuk atribut pertama di tabel berikut.Biarkan Format Nama Atribut SAML sebagai Tidak Ditentukan dan nonaktifkan Agregasi nilai atribut, lalu pilih Simpan.

Masukkan atribut pengguna
Masukkan atribut pengguna.

Ulangi langkah 3 dan 4 untuk setiap atribut di tabel.

 

Catatan

CountryCode bukan atribut bawaan KeyCloak.Untuk mengirimkannya, tambahkan dulu atribut pengguna khusus di Pengaturan Realm > Profil Pengguna yang menyimpan kode negara ISO 3166-1 dua huruf.

Pilih Klien, pilih klien Adobe, lalu pilih tab Cakupan klien.

Pilih Tambahkan cakupan klien, pilih Adobe Identity Scope, lalu pilih Tambahkan > Bawaan.

Unggah metadata KeyCloak ke Admin Console

Di KeyCloak, navigasikan ke Pengaturan Realm > Umum > Endpoint dan pilih Metadata Penyedia Identitas SAML 2.0.

Simpan XML yang terbuka sebagai file, seperti keycloak-idp-metadata.xml.

Kembali ke layar Siapkan IdP di Adobe Admin Console, unggah file metadata KeyCloak, lalu pilih Berikutnya.

Biarkan pembuatan akun otomatis tetap aktif. Jika organisasi Anda menyediakan pengguna secara manual, matikan pengaturan ini.

Di Pemetaan atribut, pilih negara default, lalu pilih Selesai.

Selanjutnya, verifikasi kepemilikan domain dan tambahkan domain ke direktori, jika Anda belum melakukannya.

Uji single sign-on

Di Admin Console, buka Pengaturan > Identitas > Direktori, lalu pilih direktori Anda.

Di panel detail direktori, pilih Uji.

Masuk sebagai pengguna KeyCloak.Pastikan bahwa halaman Validasi IdP berhasil menampilkan daftar nilai yang diharapkan untuk setiap atribut.

Halaman validasi IdP berhasil di Admin Console
Pastikan validasi IdP berhasil.

Jika ada atribut yang tidak ditemukan, periksa mapper-nya dan pastikan bahwa Adobe Identity Scope merupakan scope default pada klien Adobe. Untuk masalah lainnya, lihat Mengatasi error Login Federated ID (SSO) atau lakukan SAML trace. Untuk bantuan terkait konfigurasi Anda, buka Admin Console > Dukungan untuk menghubungi Layanan Pelanggan Adobe.