OIDC SSO 설정
OIDC는 ID 공급자를 연결하기 위한 SAML의 대안입니다. 둘 다 팀이 기존 회사 계정으로 로그인할 수 있게 해 줍니다. OIDC는 일부 공급자가 선호하는 더 현대적인 프로토콜입니다. 어느 것을 사용해야 할지 확실하지 않다면 SAML을 사용하세요. SAML이 기본값이며 지원되는 모든 공급자에서 작동합니다. 공급자가 OIDC를 권장하거나 SAML을 선택할 수 없는 경우에 OIDC를 사용하세요.
설정은 SAML과 동일한 형태입니다. 구성하고, 도메인을 확인하고, 테스트한 다음 켭니다. 몇 가지 OIDC 관련 세부 사항이 더해질 뿐입니다.
시작하기 전에
- Single Sign-On을 관리할 권한이 있는 관리자 계정.
- ID 공급자의 관리 콘솔에 대한 액세스.
- 확인할 수 있는 도메인(팀이 로그인에 사용하는 이메일 도메인).
설정 마법사 열기
- 사용자 관리 → Single Sign-On으로 이동합니다.
- Single Sign-On 설정을 선택합니다.
- 공급자를 선택한 다음 프로토콜을 OIDC로 전환합니다.
ID 공급자와 설정 교환
-
공급자의 콘솔에서 새 OIDC(또는 "OpenID Connect") 애플리케이션을 생성합니다. Kliv가 붙여넣을 리디렉션 URL을 보여 줍니다.
-
공급자가 클라이언트 ID, 클라이언트 시크릿, 발급자 URL(공급자의 로그인 서비스를 식별하는 웹 주소)을 제공합니다. 세 가지 모두 Kliv에 붙여넣습니다.
-
발급자 URL은 공급자의 것과 글자 하나까지 정확히 일치해야 합니다. 가장 흔히 틀리는 부분입니다.
- Microsoft Entra 발급자는 테넌트별로 다르며 긴 식별자를 포함합니다. 자신의 앱에서 복사하고, 가이드에 있는 값을 그대로 쓰지 마세요.
- Google은 발급자를 두 가지 이상의 형식으로 게시합니다. 콘솔에 표시된 정확한 값을 사용하세요.
발급자가 조금이라도 다르면 유효한 로그인이 거부됩니다. 아래 테스트 단계에서 이것이 문제인지 알려 줍니다.
Kliv는 이를 초안으로 저장합니다. 구성은 되었지만 아직 적용되지 않은 상태입니다. 완료하기 전까지 팀은 지금과 같은 방식으로 계속 로그인합니다.
도메인 확인
SAML과 마찬가지로, 이메일 도메인을 제어한다는 것을 입증하기 전까지 Kliv는 공급자로부터 계정을 생성하지 않습니다. 도메인 확인을 따라 진행한 다음, 확인됨으로 표시되면 여기로 돌아오세요.
실제 로그인으로 테스트
- 테스트 로그인을 선택합니다.
- 팀이 로그인할 방식 그대로 공급자에서 로그인합니다.
- 성공하면 Kliv가 테스트를 기록하고 켜기가 활성화됩니다.
- 실패하면 Kliv가 예상 값과 수신 값의 세부 정보를 보여 주므로 발급자, 시크릿 또는 리디렉션을 수정할 수 있습니다. 실패한 SSO 로그인 문제 해결을 참고하세요.
켜기
테스트 로그인이 성공하면 켜기를 선택합니다. 이제 확인된 도메인의 사람들은 로그인을 위해 공급자로 보내지며, 첫 로그인 시 표준 구성원 계정이 자동으로 생성됩니다.
새 구성원은 구성원 액세스 권한만 얻습니다. 그룹 매핑을 구성하지 않는 한 상위 역할은 부여되지 않습니다.
사용자 신원에 대한 참고 사항
OIDC는 각 사람을 이메일 주소가 아니라 공급자가 제공하는 안정적인 값 쌍으로 식별합니다. 이는 의도된 것입니다. 이메일이 바뀌어도 동일한 Kliv 계정이 유지되고, 공급자가 이메일을 "확인됨"으로 표시해 주는 것에 Kliv가 의존하지 않는다는 뜻입니다(일부 공급자는 업무용 계정에 대해 이를 보내지 않습니다). 이를 위해 구성할 것은 없습니다. 이메일이 바뀌어도 중복 계정이 생기지 않는 이유를 알아 두면 유용할 뿐입니다.