실패한 SSO 로그인 문제 해결
ID 공급자를 통한 로그인이 되지 않을 때, Kliv는 단순히 "로그인 실패"라고만 하지 않고 실제로 어떻게 고쳐야 하는지 알려 주도록 만들어져 있습니다. 이 페이지에서는 어디를 보아야 하는지, 찾은 내용을 어떻게 읽는지 설명합니다.
원인을 확인하는 곳
로그인 실패에 대한 화면은 의도적으로 두 가지로 나뉩니다.
- 로그인하려는 사용자에게는 짧은 참조 ID와 함께 "로그인할 수 없습니다"라는 일반 메시지만 표시됩니다. 기술적인 세부 정보는 보이지 않습니다. 보이면 ID 구성 방식이 노출될 수 있기 때문입니다.
- 관리자는 감사 로그에서 전체 진단을 볼 수 있습니다. 참조 ID가 가리키는 곳이 바로 여기입니다.
따라서 팀원이 로그인 실패를 알려 오면 참조 ID를 물어본 뒤 감사 로그에서 찾아보세요.
진단 내용 읽기
- 사용자 관리 → Single Sign-On으로 이동해 감사 탭을 엽니다.
- 실패한 로그인을 찾습니다(참조 ID와 일치하는 항목을 찾거나 가장 최근 항목을 확인합니다).
- 항목을 열어 예상 값과 수신 값 비교 세부 정보를 확인합니다. Kliv가 수행하는 각 검사에 대해 예상한 값과 공급자가 실제로 보낸 값이 나옵니다. 불일치하는 부분이 바로 고쳐야 할 곳입니다.
Single Sign-On 페이지의 로그인 테스트 단계를 실행하면, 실제 사용자를 끌어들이지 않고도 필요할 때 실패를 재현하면서 문제를 고칠 수 있습니다.
일반적인 원인과 해결 방법
발급자(issuer)가 일치하지 않음(OIDC). 가장 흔한 OIDC 문제입니다. 발급자 URL은 공급자의 값과 글자 하나까지 같아야 합니다. Microsoft Entra 발급자는 테넌트마다 다르고, Google은 발급자를 두 가지 이상의 형식으로 게시합니다. 사용 중인 공급자 앱에서 정확한 발급자를 복사해 Kliv에 붙여넣으세요.
서명 인증서 만료(SAML). 어제까지 되던 로그인이 갑자기 실패합니다. 공급자의 서명 인증서가 만료된 것입니다. 최신 인증서를 업로드하거나 공급자의 메타데이터에서 새로 고침하세요. 상태 카드가 이런 일이 생기기 전에 경고해 주므로 놓치지 마세요.
사용자의 이메일 도메인이 확인되지 않음. Kliv는 소유를 증명한 이메일 도메인에 대해서만 계정을 만듭니다. 확인되지 않은 도메인 때문에 로그인이 거부되었다면 해당 도메인의 도메인 확인을 완료하세요.
계정이 비활성화됨. 해당 사용자가 ID 공급자나 Kliv에서 비활성화되었다면 설계상 로그인이 거부됩니다. SSO 로그인이 비활성화된 계정을 조용히 다시 활성화하는 일은 없습니다. 액세스가 필요한 사용자라면 공급자에서 다시 활성화하세요.
신원(NameID)이 고정적이지 않음. 공급자가 매번 다른 식별자를 보내거나 고정 ID 대신 이메일을 보내면, Kliv가 같은 사람을 안정적으로 알아볼 수 없습니다. 사전 설정에서 지정한 고정 식별자를 보내도록 공급자를 구성하세요.
이메일이 "확인됨"으로 표시되지 않음. Kliv는 이를 요구하지 않습니다. 이메일 확인 플래그가 아니라 공급자의 고정 식별자로 사람을 식별하므로, "확인됨" 표시가 없는 것은 원인이 아닙니다. 대신 다른 검사 항목을 살펴보세요.
그래도 해결되지 않는다면
예상 값과 수신 값 비교 세부 정보에는 실패한 구체적인 검사 항목의 이름이 나오며, 공급자에 맞는 안내도 함께 제공됩니다. 해당 검사 하나를 중심으로 공급자에서 수정한 다음 로그인 테스트를 다시 실행하세요. 켜기 전에 테스트 성공이 필수였으므로, 이전에는 되다가 갑자기 멈춘 구성은 거의 항상 인증서 만료이거나 공급자 쪽에서 설정이 바뀐 경우입니다.