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

В этом руководстве в качестве провайдера SSO будет использоваться Microsoft Entra ID, а в качестве предпочтительного протокола идентификации — протокол Open ID Connect (OIDC).

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

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

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

Перейдите в центр администрирования Microsoft Entra ID и нажмите «Предприятия приложения»

Вас перенаправят на эту страницу. Затем нажмите «Создать новое приложение» вверху и «Создать собственное приложение».

Введите название вашего приложения (например, Hugging Face SSO), затем выберите «Зарегистрировать приложение для интеграции с Microsoft Entra ID (Приложение, которое вы разрабатываете)».

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

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

Скопируйте «Redirection URI» из настроек организации на Hugging Face и вставьте его в поле «Redirect URI» в Azure Entra ID. Убедитесь, что в выпадающем меню выбран вариант «Web». URL имеет вид: https://huggingface.co/organizations/[organizationIdentifier]/oidc/consume.

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

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

Для завершения настройки на Hugging Face необходимо собрать следующую информацию:

• Client ID приложения OIDC
• Секрет клиента приложения OIDC
• URL издателя приложения OIDC

В Microsoft Entra ID перейдите в раздел Enterprise applications и щёлкните по только что созданному вами приложению в списке.

В обзоре приложения нажмите «Единый вход», затем «Перейти к приложению»

В обзоре приложения OIDC вы найдёте копируемое поле с названием «Application (client) ID». Скопируйте этот ID в буфер обмена и вставьте его в поле «Client ID» на Hugging Face.

Далее щёлкните Endpoints в верхнем меню Microsoft Entra. Скопируйте значение из поля OpenID connect metadata document и вставьте его в поле Issue URL в Hugging Face.

Вернитесь в Microsoft Entra, перейдите в раздел «Сертификаты и секреты» и создайте новый секрет, нажав «Новый клиентский секрет».

После создания секрета скопируйте его значение и вставьте в поле «Client secret» на Hugging Face.

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

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

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

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

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

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

Update on GitHub