Hub documentation

Как настроить SAML SSO с Okta

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Как настроить SAML SSO с Okta

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

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

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

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

Откройте новую вкладку/окно в вашем браузере и войдите в свой аккаунт Okta.

Перейдите в раздел «Admin/Applications» и нажмите кнопку «Create App Integration».

Затем выберите приложение «SAML 2.0» и нажмите «Создать».

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

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

Скопируйте «Assertion Consumer Service URL» из настроек организации на Hugging Face и вставьте его в поле «Single sign-on URL» в Okta. URL выглядит так: https://huggingface.co/organizations/[organizationIdentifier]/saml/consume.

В Okta установите следующие параметры:

  • Установите значение Audience URI (SP Entity Id), соответствующее значению “SP Entity ID” на Hugging Face.
  • Установите формат идентификатора имени в Unspecified.
  • Установите значение Custom для параметра Application username, с выражением user.getInternalProperty("id").
  • В разделе «Attribute Statements» добавьте http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress со значением user.email.
  • В разделе Показать дополнительные параметры убедитесь, что параметры Response и Assertion Signature установлены в значение Signed.

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

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

В вашем приложении Okta, в разделе «Sign On/Settings/More details», найдите следующие поля:

  • URL входа
  • Публичный сертификат
  • SP Entity ID Они понадобятся вам для завершения настройки SSO на Hugging Face.

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

  • URL входа
  • SP Entity ID
  • Публичный сертификат

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

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

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

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

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

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

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

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

Update on GitHub