Memungkinkan login dengan terhubung ke platform autentikasi perusahaan Anda. Dive mendukung dua metode: Microsoft Entra ID (OIDC) dan SAML 2.0. Keduanya dapat diatur dari layar admin, dan tidak perlu pengaturan terpisah di sisi Dive. Jika Anda ingin memusatkan manajemen pengguna dengan SSO, aktifkan juga "Larang login selain SSO".
Paket yang tersedia
Fitur ini dapat digunakan pada paket Enterprise. Fitur ini juga dapat digunakan selama masa uji coba paket Enterprise. Anda juga dapat menggunakannya untuk verifikasi sebelum penerapan.
Siapa yang dapat mengatur
Hanya pengguna dengan izin pemilik yang dapat melakukannya. Lakukan dari browser PC.
Perbedaan dua metode
| Metode | IdP target | Satuan integrasi |
|---|---|---|
| Metode 1: Microsoft Entra ID (OIDC) | Microsoft 365 / Azure AD | Per tenant |
| Metode 2: SAML 2.0 | Okta / Microsoft Entra ID / OneLogin / HENNGE One, dan lainnya | Per domain email |
Langkah pengaturan umum
- Buka [Fungsi Pemilik] dari menu samping
- Pilih tab [Keamanan] di bagian atas, lalu buka kartu [Pengaturan Single Sign-On (SSO)]
- Centang "Aktifkan"
Sampai Anda mencentang "Aktifkan" dan menyimpan, login SSO tidak akan aktif meskipun Anda mengatur metode 1 maupun metode 2.
Metode 1: Integrasi Microsoft Entra ID (OIDC)
Integrasi dilakukan per tenant Microsoft 365 / Azure AD.
- Perluas [Integrasi Microsoft Entra ID (OIDC)]
- Klik [+ Masuk dengan akun Microsoft dan hubungkan tenant yang terkait]
- Di layar login Microsoft, masuk dengan akun administrator dari tenant yang ingin dihubungkan
- Di layar yang kembali, informasi tenant (domain, ID tenant) akan ditambahkan ke daftar tenant terhubung
- Klik [Simpan]
※ Email gratis (gmail.com, outlook.com, dll.) dan domain bersama tidak termasuk target integrasi. Silakan gunakan domain milik organisasi Anda sendiri.
Metode 2: Integrasi SAML 2.0
Dapat terintegrasi dengan IdP SAML 2.0 seperti Okta / Microsoft Entra ID / OneLogin / HENNGE One, dll. Saat [Integrasi SAML 2.0] diperluas, Langkah 1 sampai 4 akan ditampilkan secara berurutan.
Langkah 1: Daftarkan Dive di IdP Anda
Buat aplikasi SAML baru di IdP yang Anda gunakan, lalu atur tiga nilai berikut yang ditampilkan di layar. Setiap nilai dapat disalin dengan tombol salin.
- ID entitas SP (Audience)
- ACS URL (Reply URL)
- Format NameID (emailAddress)
Pastikan selalu memberikan alamat email sebagai NameID. Dive mengidentifikasi pengguna berdasarkan alamat email.
Langkah 2: Verifikasi kepemilikan domain perusahaan
Daftarkan domain email karyawan yang akan login dengan SSO. Untuk mencegah pemalsuan, kepemilikan diverifikasi dengan rekaman TXT DNS.
- Masukkan domain (contoh: example.co.jp) lalu klik [Tambah]
- Daftarkan rekaman TXT yang ditampilkan di layar ke DNS perusahaan Anda
- Nama:
_dive-verify.(domain) - Nilai: string token yang ditampilkan di layar
- Nama:
- Setelah tercermin di DNS, klik [Verifikasi]
- Setelah tag berubah menjadi [Terverifikasi], pengaturan selesai
Anda juga dapat memverifikasi dengan rekaman TXT yang ditempatkan langsung di domain (apex). Perubahan DNS dapat memerlukan waktu beberapa menit hingga beberapa jam untuk berlaku. Mengklik sebelum perubahan tercermin hanya akan membuat proses gagal, jadi silakan tunggu sebentar lalu coba lagi.
Domain email gratis, ISP, dan operator seluler, serta .ac.jp / .ed.jp / .go.jp / .lg.jp, tidak dapat didaftarkan. Jika hal ini berlaku untuk Anda, silakan hubungi dukungan.
Langkah 3: Daftarkan metadata IdP
- [URL metadata] atau [Tempel XML]: pilih salah satu lalu masukkan metadata IdP
- Klik [Periksa isinya], lalu periksa ID entitas IdP, SSO URL, dan masa berlaku sertifikat penandatanganan yang terbaca
- Klik [Simpan dan hubungkan]
Disarankan untuk mendaftar menggunakan URL metadata. Saat mendaftar dengan URL, Dive akan otomatis menyesuaikan setiap hari ketika sertifikat penandatanganan diganti di sisi IdP. Jika Anda menempelkan XML, data tidak diperbarui otomatis, sehingga Anda perlu menempelkannya lagi setiap kali sertifikat diperbarui.
Setelah pendaftaran, Anda dapat memeriksa status integrasi dan masa berlaku sertifikat penandatanganan di layar ini. Saat masa berlaku sertifikat hampir habis, kami akan memberi tahu Anda melalui email 30, 14, 7, dan 1 hari sebelum berakhir. Saat Anda mengganti sertifikat di sisi IdP, klik [Ambil ulang metadata].
Untuk menghentikan SSO sementara, gunakan [Jeda]. Untuk mengakhiri integrasi, gunakan [Lepaskan tautan].
Langkah 4: Pendaftaran otomatis pengguna SSO (opsional)
Jika diaktifkan, orang yang berhasil diautentikasi oleh IdP akan otomatis ditambahkan ke tim saat login pertama kali. Ini menghemat tenaga untuk mengundang, tetapi setiap orang yang ditambahkan memakai satu akun (kursi), sehingga status awalnya nonaktif.
- Izin untuk pengguna yang dibuat otomatis dapat dipilih dari "Pengguna hanya-lihat" atau "Pengguna pembuat"
- Jika jumlah akun kontrak Anda sudah mencapai batas, pendaftaran otomatis tidak akan dilakukan (tidak ada biaya tambahan untuk akun di atas batas)
- Jika tetap nonaktif, silakan admin mengundang pengguna seperti sebelumnya
Selama Sinkronisasi daftar karyawan HR (SCIM) digunakan, pendaftaran otomatis tidak dilakukan. Orang yang sudah diundang dan disinkronkan dari sistem HR atau IdP akan otomatis terhubung saat pertama kali login dengan SAML SSO (Sinkronkan daftar karyawan dari sistem HR secara otomatis (SCIM)).
Periksa apakah sudah berfungsi
Buka layar login di jendela privat, klik [Login dengan SSO], lalu masukkan alamat email perusahaan Anda. Anda akan diarahkan ke layar login IdP. Jika layar Dive terbuka setelah login, pengaturan sudah selesai.
Larang login selain SSO
Jika Anda ingin memusatkan manajemen pengguna dengan SSO, centang "Larang login selain SSO" lalu simpan.
Setelah diaktifkan, layar login Dive hanya menampilkan tombol SSO, dan login dengan ID/kata sandi tidak lagi diterima.
Perlu diketahui, selama pengaturan ini aktif, Anda tidak dapat melepaskan atau menjeda integrasi SAML, serta tidak dapat menghapus domain terverifikasi yang terakhir (karena tidak ada lagi jalur untuk login). Jika ingin melepaskan, hilangkan centang "Larang login selain SSO" terlebih dahulu.
Pengguna di luar cakupan
- Akun tanpa email (ID login yang diterbitkan oleh admin) tidak dapat menggunakan SSO, sehingga tidak termasuk dalam pembatasan ini
Pemecahan masalah
| Gejala | Yang perlu diperiksa |
|---|---|
| Muncul "SSO tidak dikonfigurasi untuk alamat email ini" | Kemungkinan domain belum terverifikasi, atau pengaturan SAML belum disimpan. Pastikan domain di Langkah 2 menampilkan "Terverifikasi" dan tag "Belum diterapkan" sudah hilang |
| Domain tetap "Belum diverifikasi" | Rekaman TXT masih menunggu untuk berlaku. Meskipun nilainya diapit tanda kutip, verifikasi tetap dapat dilakukan, tetapi spasi atau baris baru yang berlebih akan membuat verifikasi gagal |
| Muncul "(domain) sudah dikonfigurasi SSO oleh tim lain" | Tim lain telah mendaftarkan domain yang sama. Ini bisa terjadi misalnya ketika kontrak dipisah di antara perusahaan grup. Silakan hubungi dukungan |
| Muncul "Tidak ada entityID IdP di metadata" | Kemungkinan Anda menempelkan metadata sisi SP. Silakan periksa apakah itu metadata federasi IdP |
| IdP mengembalikan error | Pastikan SP entity ID / ACS URL yang didaftarkan di IdP sama persis dengan nilai yang ditampilkan di Langkah 1 |
| Bisa login, tetapi muncul "Akun belum terdaftar" | Karena pendaftaran otomatis nonaktif, belum ada pengguna di sisi Dive. Minta admin untuk mengundang, atau aktifkan Langkah 4 |
| Tiba-tiba semua orang tidak bisa login | Penyebab yang paling mungkin adalah masa berlaku sertifikat penandatanganan sudah habis. Periksa "Masa berlaku sertifikat penandatanganan" di layar admin, lalu setelah memperbaruinya di sisi IdP, klik "Ambil ulang metadata" |
Tips untuk memanfaatkannya dengan baik
- Selalu uji sebelum mengaktifkan pemaksaan SSO: Dengan pengguna uji, pastikan alurnya "Tombol SSO → login berhasil → layar Dive terbuka" sebelum mengaktifkan
- Daftarkan metadata melalui URL: Dive otomatis mengikuti penggantian sertifikat, sehingga mengurangi beban operasional dan mencegah semua orang tidak bisa login karena sertifikat kedaluwarsa
- Rapikan tenant: Jika Anda menggunakan beberapa tenant Microsoft, merapikan tenant mana saja yang akan dihubungkan sejak awal akan mengurangi masalah
- MFA untuk pengguna SSO: Pengguna SSO diasumsikan mengelola MFA di sisi IdP. Mereka dikecualikan dari pengaturan wajib MFA milik Dive