Если у вас или участников вашей команды возникают проблемы со входом в AI Studios через SAML SSO, обычно причина в неправильной настройке поставщика удостоверений (IdP). В этом руководстве описаны самые частые причины и способы их устранения.
Убедитесь, что используется SAML SSO
AI Studios поддерживает SSO на основе SAML 2.0. Другие протоколы, например OAuth или OpenID, не поддерживаются.
Чтобы использовать SSO, в вашей компании должны быть:
Поставщик удостоверений с поддержкой SAML (например, Okta, Microsoft Entra ID / Azure AD)
Правильно настроенное приложение SAML
Если вы не уверены, использует ли ваша рабочая область SSO, обратитесь в ИТ-отдел или к администратору рабочей области.
Частые проблемы и способы их устранения
1. Учетная запись для входа в IdP и адрес электронной почты для входа в AI Studios не совпадают в точности (с учетом регистра)
• При входе через MS Entra ID в AI Studios передается значение Unique User Identifier • Это значение должно в точности совпадать (с учетом регистра) с адресом электронной почты для входа в AI Studios
Как исправить
Вариант 1. Измените значение, указанное в Unique User Identifier
Измените Unique User Identifier на user.displayname
Задайте для каждого пользователя Display name, в точности совпадающее (с учетом регистра) с его адресом электронной почты для входа в AI Studios
Как изменить уникальный идентификатор пользователя в Microsoft Entra ID
Как изменить уникальный идентификатор пользователя в Microsoft Entra ID
Шаг 1. Перейдите в раздел Attributes & Claims приложения AI Studios в Microsoft Entra ID.
Найдите строку Unique User Identifier и нажмите Edit.
Шаг 2. На странице редактирования снова найдите поле Unique User Identifier.
Нажмите меню с тремя точками справа в этой строке.
Шаг 3. В меню Manage Claim найдите текстовое поле Source attribute.
Скорее всего, по умолчанию в нем указано user.userprincipalname. Измените это значение на:
user.displayname
Шаг 5. Нажмите Save.
Шаг 6. Убедитесь, что у каждого пользователя в качестве Display name указан адрес электронной почты для входа в AI Studios.
Вариант 2. Настройте передачу Unique User Identifier в нижнем регистре !! Обязательное условие !!
Этот способ подходит, только если User principal name совпадает с адресом электронной почты для входа в AI Studios полностью, за исключением регистра
Задайте Transformation ToLowercase(user.userprincipalname)
Как настроить преобразование в Microsoft Entra ID
Как настроить преобразование в Microsoft Entra ID
Шаг 1. Перейдите в раздел Attributes & Claims приложения AI Studios в Microsoft Entra ID.
Найдите строку Unique User Identifier и нажмите Edit.
Шаг 2. На странице редактирования снова найдите поле Unique User Identifier.
Нажмите меню с тремя точками справа в этой строке.
Шаг 3. Измените параметр Source на Transformation. По умолчанию выбрано Attribute.
Шаг 4. В меню Manage Transformation задайте Transformation ToLowercase() .
Шаг 5. Для Parameter 1 выберите attribute. Затем выберите user.userprincipalname в меню Attribute Name.
Шаг 6. Сохраните настройку и проверьте, что это преобразование правильно сохранено в Unique User Identifier. Оно должно отображаться как ToLowercase (user.userprincipalname)
2. Настройка рабочей области не завершена
Если ссылка для входа через SSO не работает, возможно, настройка SSO в рабочей области не завершена или не активна.
Как исправить
Администратор рабочей области должен:
Нажать на изображение профиля, выбрать Setting, а затем нажать SAML SSO в меню слева
Убедиться, что все поля IdP заполнены
Убедиться, что переключатель SSO включен
Проверить, что ACS URL и Entity ID правильно скопированы в IdP
3. Неверные данные IdP или сертификат
SSO может не работать, если неверно указано что-либо из следующего:
SSO Login URL
IdP Issuer
Сертификат X.509
Срок действия сертификата
Как исправить
Сверьте настройки поставщика удостоверений с полями, указанными в AI Studios:
ACS URL / Callback URL
Audience URI / SP Entity ID
X.509 Certificate
Нужна помощь?
Если вы проверили все перечисленное, а SSO по-прежнему не работает:
Сделайте снимок экрана с настройками SAML в вашем IdP
Запишите адрес электронной почты, который использовался при входе
Свяжитесь с вашим персональным менеджером и передайте эти данные
Мы поможем вам разобраться в проблеме.