SCIM 프로비저닝 구성

SCIM 프로비저닝은 Kliv의 팀 구성원을 ID 공급자와 자동으로 동기화합니다. Okta나 Entra에서 알맞은 그룹에 누군가를 추가하면 Kliv 계정이 만들어집니다. 그곳에서 비활성화하면 열려 있던 세션을 포함해 Kliv 액세스가 즉시 취소됩니다. 수동으로 정리할 필요가 없고, 떠난 사람이 액세스 권한을 유지하는 일도 없습니다.

이것은 디렉터리 동기화이며 SSO와 함께 동작합니다. SSO는 사람들이 로그인하는 방식이고, SCIM은 계정이 만들어지고 제거되는 방식입니다.

설정할 내용

ID 공급자에 기본 URL과 토큰 두 가지를 알려 주면, 나머지는 공급자 쪽에서 처리합니다. 이 기능을 켜면 Kliv에서 개별 사용자를 직접 관리하지 않으며, 공급자가 기준 정보(source of truth)가 됩니다.

프로비저닝을 켜고 정보 확인하기

  1. 사용자 관리 → Single Sign-On으로 이동합니다.
  2. 프로비저닝 탭을 엽니다.
  3. Kliv가 공급자에게 필요한 기본 URL을 보여 줍니다. 복사하세요.
  4. 토큰 생성을 선택합니다. Kliv가 베어러 토큰을 한 번만 보여 줍니다. 지금 복사해서 안전한 곳에 보관하세요. 보안을 위해 Kliv는 이 토큰을 다시 보여 주지 않습니다.

ID 공급자에서 연결하기

공급자의 관리 콘솔에서 Kliv 애플리케이션의 프로비저닝 설정을 열고 다음을 붙여넣습니다.

  • Kliv의 기본 URL
  • 방금 생성한 토큰

그런 다음 원하는 작업을 활성화합니다. 보통 사용자 생성, 사용자 업데이트, 사용자 비활성화이며, 그룹 동기화를 사용한다면 그것도 포함합니다. 공급자에는 대개 연결 테스트 버튼이 있으니, 실행해서 연결이 정상인지 확인하세요.

계정이 만들어지고 제거되는 방식

  • 생성/활성화 — 공급자에서 Kliv에 할당된 사용자는 표준 구성원 액세스 권한이 있는 Kliv 계정을 받습니다.
  • 업데이트 — 이름이나 그 밖의 속성 변경이 자동으로 반영됩니다.
  • 비활성화 — 공급자에서 사용자를 비활성 상태로 바꾸면 해당 사용자의 Kliv 액세스가 취소되고 열려 있던 세션이 종료됩니다. 다시 로그인할 수 없습니다.
  • 삭제 — 사용자를 완전히 제거하는 것으로, 비활성화의 영구적인 형태입니다.

SCIM으로 프로비저닝된 새 구성원은 구성원 액세스 권한만 받습니다. 그룹 매핑을 의도적으로 설정하지 않는 한 공급자로부터 관리자 역할이나 상위 역할을 상속받지 않습니다.

토큰 교체

토큰이 노출되었을 수 있거나 보안 정책에서 정한 주기가 되면 토큰을 교체하세요.

  1. 프로비저닝 탭에서 토큰 교체를 선택합니다.
  2. 새 토큰(한 번만 표시됨)을 복사해 ID 공급자에서 업데이트합니다.

공급자를 새 토큰으로 업데이트하기 전까지는 프로비저닝이 실패합니다. 따라서 새 값을 바로 공급자에 붙여넣을 수 있을 때 교체하세요.

상태 확인

프로비저닝 탭에는 연결 상태와 최근 오류가 표시됩니다. 공급자가 프로비저닝 실패를 보고하면 먼저 여기를 확인하세요. 연결 실패의 원인은 거의 항상 만료되었거나 일치하지 않는 토큰, 또는 끝까지 복사되지 않은 기본 URL입니다.

Kliv에서 SCIM 사용자 관리

사용자나 그룹을 SCIM이 소유하게 되면 ID 공급자가 해당 항목을 관리합니다. SCIM이 관리하는 사용자나 그룹을 Kliv에서 직접 편집하려 했는데 거부되더라도 정상적인 동작입니다. 공급자의 정보를 덮어쓰지 않도록 보호하는 것이며 버그가 아닙니다. 대신 공급자에서 변경하세요.