Panduan Integrasi Enterprise SSO
Integrasi tracio.ai dengan SAML, OIDC, dan identity provider kustom. Langkah demi langkah untuk Okta, Auth0, dan Azure AD lengkap dengan contoh kode.
Pelanggan enterprise membutuhkan integrasi Single Sign-On (SSO) untuk dashboard tracio.ai mereka. Panduan ini membahas cara menghubungkan tracio.ai dengan identity provider Anda menggunakan SAML 2.0 atau OpenID Connect (OIDC), dengan instruksi khusus untuk tiga provider yang paling umum: Okta, Auth0, dan Azure AD.
Protokol yang Didukung
tracio.ai mendukung dua protokol SSO: SAML 2.0 dan OpenID Connect. SAML adalah standar enterprise tradisional yang didukung secara luas oleh identity provider lama. OIDC adalah standar modern yang dibangun di atas OAuth 2.0, dengan implementasi lebih sederhana dan dukungan mobile yang lebih baik. Kami merekomendasikan OIDC untuk integrasi baru dan SAML untuk organisasi yang telah menstandarkannya.
Kedua protokol mengikuti alur yang sama: pengguna mencoba mengakses dashboard tracio.ai, dialihkan ke identity provider Anda untuk autentikasi, lalu dialihkan kembali ke tracio.ai dengan assertion atau token yang ditandatangani. tracio.ai memvalidasi assertion tersebut, membuat atau memperbarui sesi pengguna, dan memberikan akses berdasarkan peran yang dipetakan.
Integrasi Okta
Untuk Okta, buat integrasi aplikasi baru di konsol admin Okta Anda. Pilih OIDC sebagai metode sign-in dan Web Application sebagai tipe aplikasi. Atur sign-in redirect URI ke https://dashboard.tracio.ai/auth/callback/oidc. Atur sign-out redirect URI ke https://dashboard.tracio.ai/auth/logout.
Di dashboard tracio.ai pada Settings > Authentication, masukkan domain Okta, client ID, dan client secret Anda. tracio.ai akan otomatis menemukan endpoint OIDC dari metadata URL Okta Anda. Konfigurasikan pemetaan grup-ke-peran untuk menetapkan peran tracio.ai (Admin, Analyst, Viewer) berdasarkan keanggotaan grup Okta.
Integrasi Auth0
Buat Regular Web Application baru di dashboard Auth0 Anda. Tambahkan https://dashboard.tracio.ai/auth/callback/oidc ke Allowed Callback URLs. Tambahkan https://dashboard.tracio.ai ke Allowed Logout URLs. Aktifkan koneksi yang sesuai (database, social, enterprise) pada tab Connections aplikasi.
Di tracio.ai, masukkan domain Auth0, client ID, dan client secret Anda. Endpoint OIDC discovery Auth0 di https://your-domain.auth0.com/.well-known/openid-configuration menyediakan seluruh metadata yang diperlukan. Gunakan Auth0 Rules atau Actions untuk menyertakan claim kustom dalam ID token untuk pemetaan peran.
Integrasi Azure AD
Di portal Azure, buka Azure Active Directory > App registrations > New registration. Atur redirect URI ke https://dashboard.tracio.ai/auth/callback/oidc. Pada Certificates & secrets, buat client secret baru. Pada API permissions, pastikan izin openid, profile, dan email diberikan.
Di tracio.ai, masukkan tenant ID, client ID, dan client secret Azure AD Anda. Metadata URL OIDC mengikuti pola https://login.microsoftonline.com/{tenant-id}/v2.0/.well-known/openid-configuration. Petakan grup Azure AD atau app role ke peran tracio.ai pada konfigurasi pemetaan peran.
Pemetaan Peran dan Provisioning
tracio.ai mendukung tiga peran: Admin (akses penuh termasuk manajemen API key dan billing), Analyst (akses baca/tulis ke event, signal, dan rule), serta Viewer (akses dashboard hanya-baca). Peran dipetakan dari grup atau claim identity provider Anda.
Kami juga mendukung SCIM 2.0 untuk provisioning dan deprovisioning pengguna secara otomatis. Ketika seorang karyawan ditambahkan ke grup yang sesuai di identity provider Anda, mereka otomatis di-provisioning di tracio.ai dengan peran yang benar. Ketika mereka dihapus, aksesnya dicabut dalam hitungan menit. SCIM memastikan manajemen siklus hidup pengguna tetap terpusat di identity provider Anda.