Lewati ke konten
Pusat Bantuan Clevera

Menyiapkan SSO dengan Okta

Penyiapan Okta langkah demi langkah untuk single sign-on Clevera, dengan SAML 2.0 atau OpenID Connect: pengaturan aplikasi Okta, nilai Okta mana yang dimasukkan ke kolom Clevera mana, menetapkan pengguna, dan pengujian.

Diperbarui 5 mnt baca

Siapkan single sign-on antara Okta dan Clevera agar tim kamu masuk dengan akun Okta mereka. Kamu dapat terhubung dengan SAML 2.0 atau OpenID Connect (OIDC); panduan ini membahas keduanya di sisi Okta dan kolom yang sesuai di Clevera.

Konsol admin Okta berubah dari waktu ke waktu. Jika label di bawah tidak cocok dengan apa yang kamu lihat, 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 pada Paket kustom.
  • Kamu adalah admin Okta yang dapat membuat integrasi aplikasi dan menetapkannya.
  • Kamu mengetahui domain email yang digunakan orang-orangmu di Okta, seperti acme.example.

Buka dialog penyiapan Clevera terlebih dahulu agar kamu dapat menyalin nilai darinya: buka menu ruang kerja di bagian atas bilah sisi, pilih Pengaturan tim, lalu Keamanan, dan klik Siapkan SSO. Pilih Okta sebagai Identity provider.

Langkah 1 dialog penyiapan SSO dengan Okta dan SAML 2.0 dipilih serta Entity ID, ACS URL, dan metadata URL untuk disalin
Salin ketiga nilai ini ke penyedia identitas kamu.

Terhubung dengan SAML 2.0

  1. Buat aplikasi di Okta

    Di Konsol Admin Okta, buka Applications → Applications dan klik Create App Integration. Pilih SAML 2.0 dan klik Berikutnya. Beri nama Clevera dan klik Berikutnya.

  2. Masukkan nilai Clevera

    Di bawah SAML Settings, isi:

    Kolom Okta Nilai dari Clevera
    Single sign-on URL ACS URL (Reply URL): https://app.clevera.ai/sso/saml/callback. Pastikan Use this for Recipient URL and Destination URL dicentang.
    Audience URI (SP Entity ID) Entity ID / Audience URI (salin dari dialog Clevera; diakhiri dengan ID ruang kerja kamu)
    Default RelayState Biarkan kosong
    Name ID format EmailAddress
    Application username Email

  3. Periksa penandatanganan

    Klik Show Advanced Settings dan periksa apakah Response dan Assertion Signature keduanya Signed, Signature Algorithm adalah RSA-SHA256, dan Assertion Encryption adalah Unencrypted. Clevera memerlukan respons dan pernyataan yang ditandatangani.

  4. Tambahkan atribut nama

    Di bawah Attribute Statements, tambahkan firstName dengan nilai user.firstName dan lastName dengan nilai user.lastName. Clevera menggunakannya untuk menamai akun baru. Klik Berikutnya, jawab pertanyaan umpan balik Okta sebagai aplikasi internal, dan klik Selesai.

  5. Salin nilai Okta ke Clevera

    Pada tab Sign On aplikasi, buka detail penyiapan SAML (View SAML setup instructions, atau More details di konsol yang lebih baru). Di Clevera, atur Protocol ke SAML 2.0, klik Lanjutkan, dan tempel:

    Nilai Okta Kolom Clevera
    Identity Provider Issuer (atau Issuer) IdP Entity ID
    Identity Provider Single Sign-On URL (atau Sign on URL) SSO sign-in URL
    X.509 Certificate (atau Signing Certificate) X.509 certificate

    Biarkan Logout URL kosong kecuali kamu menggunakan single logout Okta.

    Langkah 2 dialog penyiapan SSO dengan IdP Entity ID, sign-in URL, dan sertifikat diisi
    Logout URL bersifat opsional.

  6. Tetapkan pengguna

    Pada tab Assignments aplikasi, klik Assign dan tambahkan orang atau grup yang harus menggunakan Clevera. Orang yang tidak ditetapkan tidak dapat masuk melalui Okta.

Kemudian selesaikan di Clevera: domain dan peran.

Terhubung dengan OpenID Connect

  1. Buat aplikasi di Okta

    Buka Applications → Applications → Create App Integration. Pilih OIDC - OpenID Connect, lalu Web Application, dan klik Berikutnya.

  2. Atur URI pengalihan

    Dalam dialog penyiapan Clevera, atur Protocol ke OpenID Connect dan salin Redirect URI (callback URL) dari kotak abu-abu. Kemudian isi Okta:

    Kolom Okta Nilai
    App integration name Clevera
    Grant type Authorization Code
    Sign-in redirect URIs Redirect URI (callback URL): https://app.clevera.ai/sso/oidc/callback
    Sign-out redirect URIs Hapus contohnya; biarkan kosong
    Controlled access Pilih siapa yang dapat menggunakan aplikasi, atau Skip group assignment for now dan tetapkan nanti

    Klik Simpan.

  3. Salin kredensial

    Pada tab General aplikasi, di bawah Client Credentials, salin Client ID dan Client secret. Biarkan Client authentication diatur ke Client secret.

  4. Isi di Clevera

    Di Clevera, klik Lanjutkan dan masukkan:

    Kolom Clevera Nilai
    Client ID Client ID Okta
    Client secret Client secret Okta
    Discovery URL https:// domain Okta kamu /.well-known/openid-configuration, contohnya https://acme.okta.com/.well-known/openid-configuration

    Jika kamu menggunakan server otorisasi kustom, gunakan URL penemuan miliknya sendiri, contohnya https://acme.okta.com/oauth2/default/.well-known/openid-configuration.

    Langkah 2 dialog penyiapan SSO untuk OpenID Connect dengan client ID, secret, dan discovery URL
    Dengan discovery URL, kolom endpoint tetap tersembunyi.

  5. Tetapkan pengguna

    Pada tab Assignments, tetapkan orang atau grup yang harus menggunakan Clevera.

Selesaikan di Clevera

  1. Pada Domains & roles, tambahkan setiap domain email yang dimiliki pengguna Okta kamu, pilih Create accounts on first sign-in dan Default role for new SSO members.
  2. Pada Tinjau, klik Simpan konfigurasi.
  3. Klik Run test, aktifkan Enable SSO, dan masuk sebagai pengguna uji yang ditetapkan di jendela pribadi, mulai dari halaman masuk Clevera.
  4. Jika sudah berfungsi untuk semua orang, aktifkan Require SSO jika kamu ingin SSO menjadi satu-satunya cara masuk.

Anggota kemudian mengetik email kantor mereka di halaman masuk Clevera dan klik Continue with Okta.

Pemecahan masalah

Masalah Apa yang harus diperiksa
"SSO authentication failed…" tepat setelah masuk Okta, dengan SAML Response dan Assertion Signature keduanya Signed; sertifikat di Clevera adalah sertifikat penandatanganan aplikasi saat ini; Audience URI cocok persis dengan Entity ID Clevera.
"SSO session expired. Please try again." setelah mengeklik ubin Clevera di Okta Diharapkan: proses masuk harus dimulai di halaman masuk Clevera.
Okta mengatakan pengguna tidak ditetapkan ke aplikasi Tetapkan mereka di tab Assignments aplikasi.
"Your email domain is not authorized for this team's SSO." Email Okta orang tersebut menggunakan domain yang tidak ada di Allowed email domains. Tambahkan di Clevera.
Okta menunjukkan kesalahan URI pengalihan (OIDC) Sign-in redirect URIs harus persis sama dengan Redirect URI (callback URL) dari Clevera, https://app.clevera.ai/sso/oidc/callback.

Pesan lainnya: Perbaiki masalah masuk SSO.

Memahami single sign-onApa yang diubah SSO untuk anggota kamu.Menyiapkan SSO dengan SAMLSetiap kolom dan nilai SAML.Menyiapkan SSO dengan OpenID ConnectSetiap kolom dan klaim OIDC.Perbaiki masalah masuk SSOSetiap pesan SSO dan apa yang harus dilakukan.