나 또는 팀원이 SAML SSO로 AI Studios에 로그인하는 데 문제가 있다면, 대개 ID 공급자(IdP) 설정이 잘못된 경우입니다. 이 가이드에서는 가장 흔한 원인과 해결 방법을 안내합니다.
SAML SSO를 사용하고 있는지 확인하기
AI Studios는 SAML 2.0 기반 SSO를 지원합니다. OAuth, OpenID 같은 다른 프로토콜은 지원하지 않습니다.
SSO를 사용하려면 회사에 다음이 있어야 합니다:
SAML 호환 ID 공급자(예: Okta, Microsoft Entra ID / Azure AD)
올바르게 구성된 SAML 애플리케이션
워크스페이스가 SSO를 사용하는지 확실하지 않다면 IT팀이나 워크스페이스 관리자에게 문의하세요.
자주 발생하는 문제와 해결 방법
1. IdP 로그인 계정과 AI Studios 로그인 이메일이 정확히 일치하지 않음(대소문자 구분)
• MS Entra ID로 로그인하면 Unique User Identifier 값이 AI Studios로 전달됩니다 • 이 값은 AI Studios 로그인 이메일과 대소문자까지 정확히 일치해야 합니다
해결 방법
사례 1. Unique User Identifier에 지정된 값 변경하기
Unique User Identifier를 user.displayname으로 변경
각 사용자의 Display name을 AI Studios 로그인 이메일과 대소문자까지 정확히 일치하도록 설정
Microsoft Entra ID에서 Unique User Identifier를 변경하는 방법
Microsoft Entra ID에서 Unique User Identifier를 변경하는 방법
1단계: Microsoft Entra ID에서 AI Studios 앱의 Attributes & Claims로 이동하세요.
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에서 Transformation을 관리하는 방법
Microsoft Entra ID에서 Transformation을 관리하는 방법
1단계: Microsoft Entra ID에서 AI Studios 앱의 Attributes & Claims로 이동하세요.
Unique User Identifier 행을 찾아 Edit을 클릭하세요.
2단계: 편집 페이지에서 Unique User Identifier 필드를 다시 찾으세요.
그 행 오른쪽의 점 세 개 메뉴를 클릭하세요.
3단계: Source 설정을 Transformation으로 바꾸세요. 기본값은 Attribute입니다.
4단계: Manage Transformation 메뉴에서 Transformation을 ToLowercase() 로 설정하세요.
5단계: Parameter 1을 attribute로 설정하세요. 그런 다음 Attribute Name 메뉴에서 user.userprincipalname을 선택하세요.
6단계: 저장한 뒤 Unique User Identifier 아래에 이 변환이 제대로 저장되었는지 다시 확인하세요. ToLowercase (user.userprincipalname) 로 표시되어야 합니다
2. 워크스페이스 설정이 완료되지 않음
SSO 로그인 링크가 동작하지 않으면 워크스페이스의 SSO 구성이 완료되지 않았거나 비활성 상태일 수 있습니다.
해결 방법
워크스페이스 관리자가 다음을 확인해야 합니다.
프로필 이미지를 클릭하고 Setting을 선택한 뒤 왼쪽 메뉴에서 SAML SSO를 클릭
IdP 입력란이 모두 채워져 있는지 확인
SSO 토글이 켜져 있는지 확인
ACS URL과 Entity ID가 IdP에 올바르게 복사되었는지 확인
3. IdP 정보 또는 인증서가 잘못됨
다음 중 하나라도 잘못되면 SSO가 실패할 수 있습니다.
SSO 로그인 URL
IdP Issuer
X.509 인증서
인증서 만료
해결 방법
ID 공급자 구성을 AI Studios에 표시된 다음 항목과 다시 대조하세요.
ACS URL / Callback URL
Audience URI / SP Entity ID
X.509 인증서
아직 도움이 필요하신가요?
위 내용을 모두 확인했는데도 SSO가 동작하지 않는다면:
IdP의 SAML 구성 화면을 스크린샷으로 찍으세요
로그인할 때 사용한 이메일 주소를 적어 두세요
이 정보를 담당 어카운트 매니저에게 전달해 문의하세요
그다음부터 함께 문제를 해결해 드리겠습니다.