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

Panduan ini akan menggunakan Microsoft Entra ID sebagai penyedia SSO dan protokol Open ID Connect (OIDC) sebagai protokol identitas yang kami rekomendasikan.

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.

Buka pusat admin Microsoft Entra ID dan klik “Enterprise applications”

Anda akan diarahkan ke halaman ini. Kemudian klik “New application” di bagian atas dan “Create your own application”.

Masukkan nama untuk aplikasi Anda (misalnya, Hugging Face SSO), lalu pilih “Daftarkan aplikasi untuk terintegrasi dengan Microsoft Entra ID (Aplikasi yang sedang Anda kembangkan)“.

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 OIDC.

Salin “Redirection URI” dari pengaturan organisasi di Hugging Face dan tempelkan ke kolom “Redirect URI” di Azure Entra ID. Pastikan Anda memilih “Web” di menu dropdown. URL-nya terlihat seperti ini: https://huggingface.co/organizations/[organizationIdentifier]/oidc/consume.

Simpan aplikasi baru Anda.

Langkah 3: Finalisasi konfigurasi di Hugging Face

Kami perlu mengumpulkan informasi berikut untuk menyelesaikan pengaturan di Hugging Face:

• Client ID dari aplikasi OIDC
• Client secret dari aplikasi OIDC
• URL Penerbit dari aplikasi OIDC

Di Microsoft Entra ID, navigasikan ke Enterprise applications, lalu klik aplikasi yang baru Anda buat dalam daftar.

Di ringkasan aplikasi, klik “Single sign-on”, lalu “Go to application”

Pada ringkasan aplikasi OIDC, Anda akan menemukan field yang dapat disalin bernama “Application (client) ID”. Salin ID tersebut ke clipboard Anda dan tempelkan ke field “Client ID” di Hugging Face.

Selanjutnya, klik “Endpoints” di menu atas di Microsoft Entra. Salin nilai di bidang “OpenID connect metadata document” dan tempelkan ke bidang “Issue URL” di Hugging Face.

Kembali ke Microsoft Entra, navigasikan ke “Certificates & secrets”, dan buat rahasia baru dengan mengklik “New client secret”.

Setelah Anda membuat secret, salin nilai secret tersebut dan tempelkan ke dalam field “Client secret” di Hugging Face.

Anda sekarang dapat mengklik “Update and Test OIDC 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 pengatur OIDC 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