Cara mengonfigurasi SAML SSO dengan Microsoft Entra ID (Azure AD)

Dalam panduan ini, kami akan menggunakan Microsoft Entra ID 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 portal Azure organisasi Anda.

Beralih ke “Enterprise applications” dan klik tombol “New application”.

Anda akan diarahkan ke halaman ini, klik “Create your own application”, isi nama aplikasi Anda, lalu klik “Create” untuk membuat aplikasi.

Lalu pilih “Single Sign-On”, dan pilih SAML

Langkah 2: Konfigurasikan aplikasi Anda di Azure

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

Salin “SP Entity Id” dari pengaturan organisasi di Hugging Face, lalu tempelkan di kolom “Identifier (Entity Id)” di Azure (1).

Salin “Assertion Consumer Service URL” dari pengaturan organisasi di Hugging Face, lalu tempelkan di kolom “Reply URL” di Azure (2).

URL-nya terlihat seperti ini: https://huggingface.co/organizations/[organizationIdentifier]/saml/consume.

Lalu di bawah “SAML Certificates”, pastikan “Signin Option” diatur ke “Sign SAML response and assertion”.

Simpan aplikasi baru Anda.

Langkah 3: Finalisasi konfigurasi di Hugging Face

Dalam aplikasi Azure Anda, di bawah “Set up”, temukan bidang berikut:

• URL Login

Dan di bawah “Sertifikat SAML”:

• Unduh “Certificate (base64)”

Anda akan membutuhkannya untuk menyelesaikan pengaturan SSO di Hugging Face.

Pada bagian SSO di pengaturan organisasi Anda, salin-tempel nilai-nilai ini dari Azure:

• Login Url -> URL masuk
• Sertifikat -> 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.