Hub documentation

Cara mengonfigurasi SAML SSO dengan Okta

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Cara mengonfigurasi SAML SSO dengan Okta

Dalam panduan ini, kami akan menggunakan Okta sebagai penyedia SSO dan protokol Security Assertion Markup Language (SAML) sebagai protokol identitas yang kami pilih.

Saat ini, kami mendukung autentikasi yang diinisiasi oleh SP dan autentikasi yang diinisiasi oleh IdP. Untuk provisioning pengguna, lihat SCIM.

Fitur ini merupakan bagian dari paket Team & Enterprise.

Langkah 1: Buat aplikasi baru di Identity Provider Anda

Buka tab/jendela baru di browser Anda dan masuk ke akun Okta Anda.

Beralih ke “Admin/Applications” dan klik tombol “Create App Integration”.

Lalu pilih aplikasi “SAML 2.0” dan klik “Create”.

Langkah 2: Konfigurasikan aplikasi Anda di Okta

Buka tab/jendela baru di browser Anda dan navigasikan ke bagian SSO dari pengaturan organisasi Anda. Pilih protokol SAML.

Salin “Assertion Consumer Service URL” dari pengaturan organisasi di Hugging Face, lalu tempelkan di kolom “Single sign-on URL” di Okta. URL-nya terlihat seperti ini: https://huggingface.co/organizations/[organizationIdentifier]/saml/consume.

Di Okta, atur pengaturan berikut:

  • Set Audience URI (SP Entity Id) agar sesuai dengan nilai “SP Entity ID” di Hugging Face.
  • Atur format ID Nama Set menjadi Unspecified.
  • Setel Application username menjadi Custom, dengan ekspresi user.getInternalProperty("id").
  • Di bawah “Attribute Statements”, tambahkan http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress dengan nilai user.email.
  • Di bawah “Show Advanced Settings”, pastikan Response dan Assertion Signature diatur ke: Signed.

Simpan aplikasi baru Anda.

Langkah 3: Finalisasi konfigurasi di Hugging Face

Dalam aplikasi Okta Anda, di bawah “Sign On/Settings/More details”, cari bidang-bidang berikut:

  • URL masuk
  • Sertifikat publik
  • SP Entity ID Anda membutuhkannya untuk menyelesaikan pengaturan SSO di Hugging Face.

Di bagian SSO pada pengaturan organisasi Anda, salin-tempel nilai-nilai ini dari Okta:

  • URL masuk
  • ID Entitas SP
  • Sertifikat publik

Sertifikat publik harus memiliki format berikut:

-----BEGIN CERTIFICATE-----
{certificate}
-----END CERTIFICATE-----

Anda sekarang dapat mengklik “Update and Test SAML configuration” untuk menyimpan pengaturan.

Anda akan diarahkan ke halaman login penyedia SSO (IdP) Anda. Setelah berhasil masuk, Anda akan diarahkan ke halaman pengaturan organisasi Anda.

Tanda centang hijau di dekat pemilih SAML akan mengonfirmasi bahwa pengujian berhasil.

Langkah 4: Aktifkan SSO di organisasi Anda

Sekarang Single Sign-On telah dikonfigurasi dan diuji, Anda dapat mengaktifkannya untuk anggota organisasi Anda dengan mengklik tombol “Enable”.

Setelah diaktifkan, anggota organisasi Anda harus menyelesaikan alur autentikasi SSO yang dijelaskan dalam bagian Cara kerjanya.

Update on GitHub