Как настроить SAML SSO с Microsoft Entra ID (Azure AD)

В этом руководстве мы будем использовать Microsoft Entra ID в качестве провайдера SSO, а протокол Security Assertion Markup Language (SAML) — в качестве предпочтительного протокола идентификации.

В настоящее время поддерживаются аутентификация, инициированная SP, и аутентификация, инициированная IdP. Для настройки пользователей см. SCIM.

Эта функция входит в планы Team & Enterprise.

Шаг 1: Создайте новое приложение в вашем Identity Provider

Откройте новую вкладку/окно в вашем браузере и войдите в Azure portal вашей организации.

Перейдите в раздел «Enterprise applications» и нажмите кнопку «New application».

Вы будете перенаправлены на эту страницу, нажмите «Create your own application», введите название вашего приложения, а затем нажмите «Create», чтобы создать приложение.

Затем выберите «Single Sign-On» и выберите SAML

Шаг 2: Настройте ваше приложение в Azure

Откройте новую вкладку/окно в вашем браузере и перейдите в раздел SSO в настройках вашей организации. Выберите протокол SAML.

Скопируйте «SP Entity Id» из настроек организации на Hugging Face и вставьте его в поле «Identifier (Entity Id)» на стороне Azure (1).

Скопируйте «Assertion Consumer Service URL» из настроек организации на Hugging Face и вставьте его в поле «Reply URL» в Azure (2).

URL выглядит так: https://huggingface.co/organizations/[organizationIdentifier]/saml/consume.

Затем в разделе «SAML Certificates» убедитесь, что параметр «Signin Option» установлен в значение «Sign SAML response and assertion».

Сохраните новое приложение.

Шаг 3: Завершение настройки на Hugging Face

В вашем приложении Azure, в разделе «Set up», найдите следующее поле:

• URL входа

А в разделе «SAML Certificates»:

• Скачайте «Сертификат (base64)»

Вам понадобятся они, чтобы завершить настройку SSO на Hugging Face.

В разделе SSO в настройках вашей организации скопируйте и вставьте эти значения из Azure:

• Login Url -> URL входа
• Сертификат -> Публичный сертификат

Публичный сертификат должен иметь следующий формат:

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

Теперь вы можете нажать «Update and Test SAML configuration», чтобы сохранить настройки.

Вы должны быть перенаправлены на страницу входа вашего провайдера SSO (IdP). После входа в систему вы будете перенаправлены на страницу настроек вашей организации.

Зеленая галочка рядом с селектором SAML подтвердит успешное прохождение теста.

Шаг 4: Включите SSO в вашей организации

Теперь, когда Single Sign-On настроен и протестирован, вы можете включить его для участников вашей организации, нажав кнопку «Enable».

После включения члены вашей организации должны пройти процесс аутентификации SSO, описанный в разделе Как это работает.