Menyiapkan SSO dengan Microsoft Entra ID

Siapkan single sign-on antara Microsoft Entra ID (sebelumnya Azure AD) dan Clevera agar tim kamu dapat masuk menggunakan akun kerja Microsoft mereka. Kamu dapat terhubung menggunakan SAML 2.0 atau OpenID Connect (OIDC); panduan ini mencakup keduanya di sisi Entra dan kolom yang sesuai di Clevera.

Pusat admin Microsoft Entra sering berubah. Jika label di bawah ini tidak cocok, cari pengaturan dengan arti yang sama, dan gunakan panduan umum untuk daftar nilai lengkapnya: SAML, OIDC.

Sebelum kamu mulai#

• Kamu adalah Pemilik ruang kerja Clevera dengan Paket kustom.
• Kamu dapat membuat aplikasi perusahaan atau pendaftaran aplikasi di Entra (misalnya sebagai Administrator Aplikasi).
• Kamu mengetahui domain email yang digunakan anggota timmu, seperti acme.example.

Buka dialog pengaturan Clevera terlebih dahulu agar kamu dapat menyalin nilainya: buka menu ruang kerja di bagian atas bilah sisi, pilih Pengaturan tim, lalu Keamanan, dan klik Siapkan SSO. Pilih Microsoft Entra ID (Azure AD) sebagai Penyedia identitas.

Terhubung dengan SAML 2.0#

1. Buat aplikasi perusahaan#

   Di pusat admin Microsoft Entra, buka Aplikasi perusahaan dan klik Aplikasi baru, lalu Buat aplikasi kamu sendiri. Beri nama Clevera, pilih Integrasikan aplikasi lain apa pun yang tidak kamu temukan di galeri (Non-galeri) dan klik Buat.

2. Pilih SAML#

   Di aplikasi baru tersebut, buka Single sign-on dan pilih SAML.

3. Masukkan nilai Clevera#

   Di Konfigurasi SAML Dasar, klik Edit dan isi:

   Kolom Entra	Nilai dari Clevera
   Pengidentifikasi (ID Entitas)	ID Entitas / URI Audiens (salin dari dialog Clevera; diakhiri dengan ID ruang kerja kamu)
   URL Balasan (URL Assertion Consumer Service)	https://app.clevera.ai/sso/saml/callback
   URL Masuk	Biarkan kosong
   Relay State	Biarkan kosong
   URL Keluar	Hanya jika kamu akan menggunakan single logout: https://app.clevera.ai/sso/saml/slo

   Klik Simpan.

4. Periksa klaim#

   Di Atribut & Klaim, buka Pengidentifikasi Pengguna Unik (ID Nama). Atur Format pengidentifikasi nama ke Alamat email dan atribut sumber ke atribut yang menyimpan email anggota: user.mail, atau user.userprincipalname jika nama masuk mereka adalah email mereka. Pertahankan klaim default givenname, surname, dan emailaddress: Clevera membacanya.

5. Tandatangani respons dan pernyataan#

   Di Sertifikat SAML, klik Edit di samping sertifikat penandatanganan. Atur Opsi Penandatanganan ke Tandatangani respons dan pernyataan SAML dan Algoritma Penandatanganan ke SHA-256. Klik Simpan.

   Entra hanya menandatangani pernyataan secara default, dan Clevera menolak hal tersebut.

6. Salin nilai Entra ke Clevera#

   Di Sertifikat SAML, unduh Sertifikat (Base64) dan buka di editor teks. Di Siapkan Clevera, salin URL-nya. Di Clevera, atur Protokol ke SAML 2.0, klik Lanjutkan, dan tempel:

   Nilai Entra	Kolom Clevera
   Pengidentifikasi Microsoft Entra	ID Entitas IdP
   URL Masuk	URL masuk SSO
   URL Keluar	URL Keluar (opsional)
   Isi Sertifikat (Base64)	Sertifikat X.509

7. Tetapkan orang#

   Di Pengguna dan grup, klik Tambahkan pengguna/grup dan tambahkan orang atau grup yang harus menggunakan Clevera.

Kemudian selesaikan di Clevera: domain dan peran.

Terhubung dengan OpenID Connect#

1. Daftarkan aplikasi#

   Di dialog pengaturan Clevera, atur Protokol ke OpenID Connect dan salin URI Pengalihan (URL callback) dari kotak abu-abu. Di Entra, buka Pendaftaran aplikasi dan klik Pendaftaran baru. Beri nama Clevera, pilih Akun di direktori organisasi ini saja (Penyewa tunggal), dan di bawah URI Pengalihan pilih Web lalu tempel https://app.clevera.ai/sso/oidc/callback. Klik Daftarkan.

2. Salin ID#

   Pada Ringkasan aplikasi, salin ID Aplikasi (klien) dan ID Direktori (penyewa).

3. Buat rahasia klien#

   Buka Sertifikat & rahasia, klik Rahasia klien baru, pilih masa berlaku, dan klik Tambahkan. Segera salin Nilai rahasia tersebut (bukan ID Rahasia); Entra hanya menampilkannya satu kali.

4. Tambahkan klaim email#

   Buka Konfigurasi token, klik Tambahkan klaim opsional, pilih ID, centang email, dan klik Tambahkan. Terima permintaan untuk menambahkan izin email Microsoft Graph. Tanpanya, Clevera akan kembali ke nama masuk (preferred_username), yang hanya berfungsi jika itu adalah email orang tersebut.

5. Isi di Clevera#

   Di Clevera, klik Lanjutkan dan masukkan:

   Kolom Clevera	Nilai
   ID Klien	ID Aplikasi (klien)
   Rahasia klien	Nilai rahasia
   URL Penemuan	https://login.microsoftonline.com/ ID Direktori (penyewa) kamu /v2.0/.well-known/openid-configuration

   Gunakan ID penyewa kamu di URL, bukan common atau organizations: Clevera memeriksa penerbit, dan URL bersama tersebut tidak cocok dengannya.

6. Batasi siapa yang bisa masuk (opsional)#

   Secara default, siapa pun di penyewa kamu dapat menggunakan aplikasi ini. Untuk membatasinya, buka Aplikasi perusahaan → Clevera → Properti, atur Penetapan diperlukan? ke Ya, dan tambahkan orang atau grup di Pengguna dan grup.

Selesaikan di Clevera#

1. Pada Domain & peran, tambahkan setiap domain email yang digunakan anggota timmu, termasuk domain terverifikasi tambahan di penyewa kamu. Pilih Buat akun saat pertama kali masuk dan Peran default untuk anggota SSO baru.
2. Pada Tinjau, klik Simpan konfigurasi.
3. Klik Jalankan pengujian, aktifkan Aktifkan SSO, dan masuk sebagai pengguna uji di jendela pribadi, mulai dari halaman masuk Clevera.
4. Jika sudah berfungsi untuk semua orang, aktifkan Wajibkan SSO jika kamu ingin SSO menjadi satu-satunya cara masuk.

Anggota mengetik email kerja mereka di halaman masuk Clevera dan klik Lanjutkan dengan Microsoft Entra ID (Azure AD).

Pemecahan masalah#

Pesan lainnya: Perbaiki masalah masuk SSO.

Terkait#