Microsoft Entra ID (Azure AD) ile SAML SSO yapılandırma

Bu kılavuzda, SSO sağlayıcısı olarak Microsoft Entra ID'yi ve tercih edilen kimlik protokolü olarak Security Assertion Markup Language (SAML) protokolünü kullanacağız.

Şu anda SP başlatmalı ve IdP başlatmalı kimlik doğrulamayı destekliyoruz. Kullanıcı sağlama için bkz. SCIM.

Bu özellik, Team & Enterprise planlarının bir parçasıdır.

Adım 1: Kimlik Sağlayıcınızda yeni bir uygulama oluşturun

Tarayıcınızda yeni bir sekme/pencere açın ve organizasyonunuzun Azure portalına giriş yapın.

“Enterprise applications” bölümüne gidin ve “New application” düğmesine tıklayın.

Bu sayfaya yönlendirileceksiniz, “Create your own application” seçeneğine tıklayın, uygulamanızın adını girin ve ardından uygulamayı “Create” ile oluşturun.

Ardından “Tek Oturum Açma”yı seçin ve SAML’i seçin

Adım 2: Uygulamanızı Azure üzerinde yapılandırın

Tarayıcınızda yeni bir sekme/pencere açın ve organizasyonunuzun ayarlarındaki SSO bölümüne gidin. SAML protokolünü seçin.

Hugging Face'teki organizasyon ayarlarından “SP Entity Id” değerini kopyalayın ve Azure'daki “Identifier (Entity Id)” alanına yapıştırın (1).

Hugging Face'teki organizasyon ayarlarından “Assertion Consumer Service URL” değerini kopyalayın ve Azure'daki “Reply URL” alanına (2) yapıştırın.

URL şu görünüme sahiptir: https://huggingface.co/organizations/[organizationIdentifier]/saml/consume.

Ardından “SAML Certificates” altında, “Signin Option”ın “Sign SAML response and assertion” olarak ayarlandığını doğrulayın.

Yeni uygulamanızı kaydedin.

Adım 3: Yapılandırmayı Hugging Face üzerinde tamamlayın

Azure uygulamanızda “Set up” altında aşağıdaki alanı bulun:

• Giriş Yapma URL'si

Ve “SAML Sertifikaları” altında:

• “Sertifika (base64)” dosyasını indirin

Hugging Face'te SSO kurulumunu tamamlamak için bunlara ihtiyacınız olacaktır.

Organizasyonunuzun ayarlarındaki SSO bölümünde, bu değerleri Azure'dan kopyalayıp yapıştırın:

• Giriş URL'si -> Oturum açma URL'si
• Sertifika -> Halka açık sertifika

Herkese açık sertifika aşağıdaki biçimde olmalıdır:

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

Ayarları kaydetmek için artık “Update and Test SAML configuration” seçeneğine tıklayabilirsiniz.

SSO sağlayıcınızın (IdP) oturum açma ekranına yönlendirilmelisiniz. Oturum açıldıktan sonra, organizasyonunuzun ayarlar sayfasına yönlendirileceksiniz.

SAML seçicisinin yakınındaki yeşil onay işareti, testin başarılı olduğunu doğrular.

Adım 4: Organizasyonunuzda SSO'yu etkinleştirin

Tek Oturum Açma yapılandırıldı ve test edildiğine göre, “Enable” düğmesine tıklayarak onu organizasyonunuzdaki üyeler için etkinleştirebilirsiniz.

Etkinleştirildikten sonra, organizasyonunuzdaki üyeler Nasıl çalışır bölümünde açıklanan SSO kimlik doğrulama akışını tamamlamalıdır.