KB: SAML SSO 로그인 시 "사용자 이름 또는 비밀번호가 올바르지 않습니다" 오류 발생

솔루션 상세 정보

Connection 테스트는 성공하지만 로그인은 실패하는 경우

SAML Connection Test이(가) 성공적으로 완료되고 다음과 유사한 메시지가 표시되므로 SAML 구성이 올바르게 작동하는 것처럼 보일 수 있습니다.

Connection Test Successful
You would have been signed in as username@domain.com

그러나 사용자가 SSO를 통해 로그인을 시도하면 다음과 같은 상황이 발생합니다.

1. ID 공급자에서 인증에 성공합니다.
2. 사용자가 Enterprise Server로 다시 리디렉션됩니다.
3. Enterprise Server에 다음 오류가 표시됩니다.

"Our system hit a snag, please try again in a moment.
Invalid UserName/Password combination"

사용자 이름이 정확히 일치해야 함

Enterprise Server는 ID 공급자가 제공한 사용자 이름을 사용하여 기존 Enterprise Server 계정을 찾고 사용자를 해당 계정에 매핑합니다.

IdP가 반환한 사용자 이름은 Enterprise Server 내 사용자의 Username 필드에 설정된 값과 정확히 일치해야 합니다.

예를 들어 SAML Connection 테스트에서 다음과 같이 보고되었지만

username@domain.com

Enterprise Server 계정이 다음과 같이 설정되어 있거나

username

또는 다음과 같이 설정되어 있다면

Username@domain.com

값이 정확히 일치하지 않아 SSO 로그인이 실패할 수 있습니다.

Important: 사용자 이름 비교는 case-sensitive. 다음 값은 서로 다른 것으로 간주됩니다.

username@domain.com
Username@domain.com

이 사용자 이름 매핑 동작은 사용자의 인증 유형과 무관하며, 다음 두 인증 방식 모두에 적용됩니다.

• 기본 제공 인증
• Windows 인증

ID 공급자가 반환한 사용자 이름 확인

• SAML Connection Test을(를) 실행하여 ID 공급자가 반환한 사용자 이름을 확인합니다.
• 반환된 사용자 이름을 Enterprise Server 내 사용자의 Username 필드와 비교합니다.
• 철자, 이메일 형식, 대소문자가 모두 동일한지 확인합니다.
• 필요한 경우 Enterprise Server 사용자 이름을 업데이트합니다.
• 정확히 일치하는지 확인한 후에도 문제가 지속되면 UnifiedLogin 로그에서 추가 세부 정보를 확인합니다. 이 로그는 다음 경로에 있습니다.
  C:\ProgramData\Altium\Altium365Data\logs\UnifiedLogin

사용자 이름 매핑 검증 및 수정

1. Enterprise Server 웹 인터페이스를 엽니다.
2. Admin » Settings » Authentication(으)로 이동합니다.
3. 설정된 SAML 인증 공급자를 엽니다.
4. Connection Test을(를) 실행합니다.
5. ID 공급자에서 인증을 완료합니다.
6. 테스트에서 보고된 사용자 이름을 기록합니다.
7. Admin » Users(으)로 이동합니다.
8. 해당 사용자 계정을 엽니다.
9. Username 필드가 대소문자를 포함하여 SAML Connection 테스트에서 반환된 값과 정확히 일치하는지 확인합니다.
10. 필요한 변경 사항을 저장합니다.
11. SSO 로그인을 다시 시도합니다.

추가 참고 사항

• SSO 사용자 매핑은 Enterprise Server의 Username 필드를 사용하여 수행됩니다.
• 이 동작은 계정이 Built-In 인증을 사용하는지, Windows 인증을 사용하는지와 관계없이 적용됩니다.
• 사용자 이름 일치는 case-sensitive.
• 추가 문제 해결이 필요한 경우 다음 위치의 UnifiedLogin 로그를 확인합니다.
  C:\ProgramData\Altium\Altium365Data\logs\UnifiedLogin
• UnifiedLogin 로그에서는 IdP로부터 수신한 ID 정보, 사용자 매핑 및 인증 처리 오류에 대한 세부 정보를 확인할 수 있습니다.
• 예상 결과: Enterprise Server 사용자 이름이 ID 공급자가 제공한 사용자 이름과 정확히 일치하면 사용자가 기존 계정에 성공적으로 매핑되고 SSO 인증이 정상적으로 완료되며 오류가 더 이상 발생하지 않습니다.

참고 자료

• 싱글 사인온 인증 구성