개요

SCIM 2.0 프로비저닝은 아이덴티티 프로바이더를 통해 팀원과 디렉터리 그룹을 자동으로 관리해. SSO가 활성화된 엔터프라이즈 플랜에서 쓸 수 있어.

사전 준비 사항

  • Cursor Enterprise 플랜
  • 먼저 SSO가 구성되어 있어야 함 - SCIM은 활성 SSO 연결이 필요함
  • ID 제공자(Okta, Azure AD 등)에 대한 관리자 권한
  • Cursor 조직에 대한 관리자 권한

작동 방식

사용자 프로비저닝

IDP의 SCIM 애플리케이션에 할당되면 사용자는 자동으로 Cursor에 추가돼. 할당 해제되면 제거돼. 변경 사항은 실시간으로 동기화돼.

디렉터리 그룹

디렉터리 그룹과 멤버십은 IDP에서 동기화돼. 그룹과 사용자 관리는 반드시 IDP에서 해야 해. Cursor는 이 정보를 읽기 전용으로 보여줘.

지출 관리

디렉터리 그룹별로 사용자당 지출 한도를 다르게 설정해. 디렉터리 그룹 한도가 팀 수준 한도보다 우선이야. 여러 그룹에 속한 사용자는 적용 가능한 한도 중 가장 높은 한도가 적용돼.

설정

1

SSO가 구성되어 있는지 확인하기

SCIM을 쓰려면 먼저 SSO가 설정되어 있어야 해. 아직 SSO를 안 했다면, 진행하기 전에 SSO 설정 가이드를 따라줘.
2

Active Directory Management에 접속하기

관리자 계정으로 cursor.com/dashboard?tab=active-directory 로 이동하거나, 대시보드 설정에서 “Active Directory Management” 탭을 선택해.
3

SCIM 설정 시작하기

SSO가 확인되면 단계별 SCIM 설정 링크가 보여. 이걸 클릭해서 설정 마법사를 시작해.
4

IdP에서 SCIM 구성하기

사용하는 IdP에서: - SCIM 애플리케이션 생성 또는 구성 - Cursor에서 제공하는 SCIM 엔드포인트와 토큰 사용 - 사용자 및 그룹 푸시 프로비저닝 활성화 - 연결 테스트
5

지출 한도 구성하기(선택)

Cursor의 Active Directory Management 페이지로 돌아와서: - 동기화된 디렉터리 그룹 확인 - 필요에 따라 특정 그룹에 사용자별 지출 한도 설정 - 여러 그룹에 속한 사용자에게 적용되는 한도 검토

IdP 설정

IdP별 설정 방법은 여기서 확인해:

Identity Provider 가이드

Okta, Azure AD, Google Workspace 등 설정 가이드.

사용자 및 그룹 관리

모든 사용자와 그룹 관리는 반드시 아이덴티티 프로바이더를 통해서만 할 수 있어. 아이덴티티 프로바이더에서 바뀐 내용은 자동으로 Cursor에 동기화되지만, Cursor에서 사용자나 그룹을 직접 수정할 수는 없어.

사용자 관리

  • 아이덴티티 프로바이더에서 SCIM 애플리케이션에 할당해서 사용자를 추가해
  • SCIM 애플리케이션에서 할당을 해제해서 사용자를 제거해
  • 사용자 프로필 변경(이름, 이메일)은 아이덴티티 프로바이더에서 자동으로 동기화돼

그룹 관리

  • 디렉터리 그룹은 아이덴티티 프로바이더에서 자동으로 동기화돼
  • 그룹 멤버십 변경은 실시간으로 반영돼
  • 그룹을 활용해 사용자를 조직하고 서로 다른 지출 한도를 설정해

지출 한도

  • 각 디렉터리 그룹마다 사용자별 한도를 다르게 설정해
  • 사용자는 자신이 속한 그룹 중 가장 높은 지출 한도를 상속받아
  • 그룹 한도가 팀 전체 기본 사용자별 한도보다 우선해

FAQ

대시보드에 SCIM 관리가 왜 안 보여?

SCIM 설정 전에 SSO가 제대로 구성돼 있고 동작하는지 확인해. SCIM은 동작하려면 활성화된 SSO 연결이 필요해.

유저가 왜 동기화되지 않아?

아이덴티티 제공자에서 유저가 SCIM 애플리케이션에 할당돼 있는지 확인해. Cursor에 나타나려면 유저를 명시적으로 할당해야 해.

그룹이 왜 안 보여?

아이덴티티 제공자의 SCIM 설정에서 그룹 푸시 프로비저닝이 활성화돼 있는지 확인해. 그룹 동기화는 유저 동기화와 별도로 설정해야 해.

지출 한도가 왜 적용되지 않아?

아이덴티티 제공자에서 유저가 기대하는 그룹에 제대로 할당돼 있는지 확인해. 그룹 멤버십이 어떤 지출 한도가 적용되는지 결정해.

SCIM 유저와 그룹을 Cursor에서 직접 관리할 수 있어?

아니. 모든 유저와 그룹 관리는 아이덴티티 제공자에서 해야 해. Cursor는 이 정보를 읽기 전용으로 보여줘.

변경 사항은 얼마나 빨리 동기화돼?

아이덴티티 제공자에서 한 변경 사항은 실시간으로 Cursor에 동기화돼. 대량 작업의 경우 잠깐 지연될 수 있어.