JIT 또는 SCIM 프로비저닝 설정 | Anthropic 지원 센터

이 가이드는 Claude 또는 Claude Console 조직의 사용자 프로비저닝 및 역할 할당을 구성하는 방법을 다룹니다.

JIT 프로비저닝은 Team 플랜, Enterprise 플랜 및 Console 조직에서 사용할 수 있습니다. SCIM 프로비저닝은 Enterprise 및 Console 조직에서만 사용할 수 있습니다.

시작하기 전에: 이 가이드는 싱글 사인온(SSO) 설정의 단계를 이미 완료했다고 가정합니다. 여기에는 도메인 확인 및 ID 공급자(IdP)와의 SSO 구성이 포함되며, Admin(Console) 또는 Owner(Claude) 역할이 있어야 합니다.

1단계: 프로비저닝 모드 선택

SSO가 구성되면 사용자가 조직에 프로비저닝되는 방식을 결정해야 합니다. 이는 Organization settings > Organization and access의 User provisioning 섹션을 통해 제어됩니다.

프로비저닝 옵션

초대만이 기본값입니다. 사용자는 Claude 또는 Console 설정에서 직접 추가 및 제거됩니다.

Just-in-time(JIT): Anthropic IdP 앱에 할당된 사용자는 처음 로그인할 때 자동으로 프로비저닝됩니다. 이 옵션은 모든 플랜에서 사용할 수 있습니다.

SCIM 디렉토리 동기화: 사용자는 IdP의 할당에 따라 자동으로 프로비저닝 및 프로비저닝 해제되며, 먼저 로그인할 필요가 없습니다. SCIM은 Enterprise 플랜 및 자체 상위 조직이 있거나 Enterprise 상위 조직에 가입한 Console 조직에서 사용할 수 있습니다. SCIM은 Team 플랜 또는 Team 플랜의 상위 조직에 가입한 Console 조직에서는 사용할 수 없습니다.

SCIM 디렉토리 동기화가 켜져 있으면 Claude는 새로 프로비저닝된 각 멤버에게 환영 이메일을 보냅니다. 이를 끄려면 Owner 및 Primary Owner는 Organization settings > Organization and access > User provisioning으로 이동하여 SCIM directory sync를 찾고 "새 멤버에게 환영 이메일 보내기"를 끌 수 있습니다.

참고: Claude는 고객 관리 암호화 키(CMEK), HIPAA 또는 FERPA와 같은 추가 데이터 처리 또는 규정 준수 요구 사항이 있는 조직에는 이 환영 이메일을 보내지 않으므로 해당 조직에는 설정이 표시되지 않습니다. 변경 사항은 저장 후 프로비저닝된 멤버에게 적용되며, 이미 전송된 이메일은 계속 전달됩니다.

프로비저닝 동작 개요

이 표를 사용하여 조직에 적합한 프로비저닝 모드를 결정하는 데 도움을 받으세요:

모드	프로비저닝	역할 및 시트 유형 변경	제거
초대만	사용자가 수동으로 추가됨	역할 및 시트 유형이 수동으로 변경됨	사용자가 수동으로 제거됨
Just-in-time(JIT)	IdP 앱에 할당된 사용자는 로그인 시 User 역할로 프로비저닝됨	역할 및 시트 유형이 수동으로 변경됨	수동 제거 필요. JIT는 멤버를 자동으로 제거하지 않습니다. IdP 앱에서 누군가를 할당 해제하면 더 이상 로그인할 수 없지만 멤버 목록에 남아 있고 관리자가 제거할 때까지 시트를 유지합니다.
JIT + 그룹 매핑	매핑된 그룹 중 하나 이상에 있는 사용자는 로그인 시 그룹 멤버십의 최고 권한 역할로 프로비저닝됨	역할 및 시트 유형은 다음 로그인 시 그룹 멤버십에 따라 업데이트됩니다. Primary Owner의 역할은 변경되지 않습니다.	대부분 수동. 매핑된 모든 그룹에서 제거되었지만 여전히 앱에 할당된 사용자는 다음 로그인 시 조직에서 제거됩니다. 이는 Primary Owner에게 적용되지 않습니다. 앱에서 완전히 할당 해제한 사용자는 더 이상 로그인할 수 없지만 멤버 목록에 남아 있고 관리자가 제거할 때까지 시트를 유지합니다.
SCIM 디렉토리 동기화	IdP 앱에 할당된 사용자는 상위 조직에 가입한 모든 조직에 자동으로 프로비저닝됩니다.	역할 및 시트 유형이 수동으로 변경됨	IdP 앱에서 제거된 사용자는 자동으로 제거됨
SCIM + 그룹 매핑	매핑된 그룹 중 하나 이상에 있는 사용자는 자동으로 프로비저닝되며, 해당 그룹이 추가된 상위 조직에 가입한 조직에만 적절한 역할로 프로비저닝됩니다.	역할 및 시트 유형 변경이 그룹 멤버십에 따라 자동으로 전파됨	그룹 액세스가 취소되면 자동 제거

참고: JIT 사용자를 영구적으로 제거하려면 Claude에서 제거하고 IdP에서 할당을 해제하세요. Claude에서만 제거한 사용자는 SSO로 다음 로그인할 때 다시 추가됩니다.

JIT와 SCIM 모두 Enable group mappings과 결합하여 IdP 그룹 멤버십에 따라 역할 또는 시트 계층 할당을 제어할 수 있습니다. 프로비저닝 모드에 대해 이 옵션 중 하나를 선택하면 Enable group mappings이 User provisioning 섹션 내에 나타납니다:

중요: 그룹 매핑은 사용자의 역할 유형 및 시트 계층만 설정합니다. Custom 역할을 가진 사용자는 Claude의 그룹에서 권한을 얻으며, 이러한 그룹은 프로비저닝 모드가 SCIM 디렉토리 동기화일 때만 IdP에서 동기화됩니다. JIT를 사용하면 Organization settings > Groups에서 그룹을 만들고 사용자를 수동으로 추가해야 합니다. JIT에서 IdP 그룹을 Custom 역할에 매핑했지만 이를 수행하지 않으면 해당 사용자는 로그인할 때 권한이 없습니다. Enterprise 플랜에서 그룹 관리에 대해 자세히 알아보세요.

사용 가능한 역할 및 시트 계층

제품	역할	시트 유형
Team 플랜	Owner, Admin, User	Premium, Standard
Seat 기반 Enterprise 플랜	Owner, Admin, User, Custom	프리미엄, 표준
사용량 기반 엔터프라이즈 플랜(두 가지 시트 유형 포함)	소유자, 관리자, 사용자, 사용자 정의	Chat, Chat + Claude Code
사용량 기반 엔터프라이즈 플랜(단일 시트 유형)	소유자, 관리자, 사용자, 사용자 정의	엔터프라이즈
Console	관리자, 개발자, 제한된 개발자, 청구, Claude Code 사용자, 사용자	—

시트 구매 또는 플랜의 시트 할당 조정에 대한 정보는 팀 플랜 및 엔터프라이즈 플랜 가이드를 참조하세요.

2단계: SCIM 디렉토리 동기화 설정(SCIM 사용 시)

참고: 초대 전용 또는 JIT 프로비저닝을 사용 중인 경우 이 단계를 건너뛰세요.

프로비저닝 모드로 SCIM을 선택한 경우, 활성화하기 전에 ID 공급자와 Anthropic 간의 연결을 설정해야 합니다.

Claude의 조직 및 액세스 설정(claude.ai/admin-settings/organization)으로 이동하거나 Console의 ID 및 액세스 설정(platform.claude.com/settings/identity)으로 이동하세요.
사용자 프로비저닝 섹션에서 SCIM 디렉토리 동기화 옆의 "SCIM 설정"(또는 "SCIM 관리")을 클릭하세요.
WorkOS 설정 가이드를 따라 ID 공급자에서 SCIM을 구성하세요. WorkOS의 값을 IdP의 Anthropic 애플리케이션에 복사해야 합니다.

‼️ IdP 그룹 단계에 도달하면 일시 중지하여 이 가이드의 3단계와 4단계를 다른 가이드와 함께 검토하세요.

IdP별 JIT/SCIM 설정 지침은 다음을 참조하세요:

Okta SAML / OKTA SCIM
Entra ID SAML / Entra ID SCIM
Google SAML / Directory Sync
OneLogin SAML / OneLogin SCIM
JumpCloud SAML / JumpCloud SCIM
추가 IdP는 여기를 참조하세요.

IdP가 연결되면 3단계로 진행하세요.

3단계: 프로비저닝 모드 구성 및 그룹 매핑 활성화

설정의 사용자 프로비저닝 섹션을 찾으세요.
선택한 옵션을 선택하세요:
1. 초대 전용: 새 멤버는 기존 멤버가 수동으로 초대한 경우에만 참여할 수 있습니다. SSO 액세스만으로는 조직에 추가되지 않습니다.
2. Just-in-time(JIT): SSO 액세스 권한이 있는 사용자가 처음 로그인할 때 참여하도록 허용합니다. 각 새 멤버는 사용 가능한 시트 중 하나를 사용합니다.
3. SCIM 디렉토리 동기화: 디렉토리가 변경되면 멤버를 자동으로 추가하거나 제거합니다. 조직은 항상 최신 상태로 유지됩니다.
"Just-in-time(JIT)" 또는 "SCIM 디렉토리 동기화"를 선택한 경우 아직 "변경 사항 저장"을 클릭하지 마세요. 먼저 모든 사용자가 IdP의 Anthropic 애플리케이션에 할당되었는지 확인하세요. 저장할 때 할당되지 않은 사용자는 조직에서 프로비저닝 해제됩니다.
IdP에서 모든 사용자가 할당되었음을 확인한 후 다음 중 하나를 선택하세요:
1. "변경 사항 저장"을 클릭하여 설정을 완료하고 초기 프로비저닝을 트리거하세요. 사용 가능한 경우 관리자 콘솔에는 동기화가 적용되기 전에 변경할 내용의 미리보기가 표시되며, 제거될 사용자 수도 포함됩니다. 확인하기 전에 검토하고 제거 수가 예상보다 높으면 취소하세요. SCIM 동기화 작동 방식에 대해 자세히 알아보세요.
2. 그룹 매핑 활성화를 켜고 4단계로 이동하세요. 엔터프라이즈 플랜을 사용 중이고 SCIM을 사용하여 IdP 그룹을 "사용자 정의" 역할에 매핑할 계획이라면 먼저 다음 섹션의 단계를 따르세요.

SCIM 그룹 매핑과 함께 사용자 정의 역할 사용(엔터프라이즈 플랜)

IdP 그룹은 첫 번째 SCIM 동기화가 실행된 후에만 Claude에 나타나므로 미리 사용자 정의 역할에 할당할 수 없습니다. 동기화된 그룹이 사용자 정의 역할에 할당될 때까지 "사용자 정의"에 매핑된 그룹의 사용자는 권한이 없습니다. 권한이 필요한 기능은 회색으로 표시되거나 숨겨지며 Claude Code 로그인이 실패합니다. 이를 방지하려면 SCIM을 두 번에 걸쳐 설정하세요:

그룹 매핑 활성화를 끈 상태에서 "변경 사항 저장"을 클릭하고 초기 동기화가 완료되도록 하세요.
조직 설정 > 역할로 이동하여 동기화된 그룹을 사용자 정의 역할에 할당하세요. 그룹이 아직 나열되지 않은 경우 조직 설정 > 그룹에서 "업데이트 확인"을 클릭하고 그룹만 동기화하세요.
사용자 프로비저닝으로 돌아가서 그룹 매핑 활성화를 켜고 4단계로 이동하세요.

엔터프라이즈 플랜에서 역할 기반 권한 설정에 대해 자세히 알아보세요.

4단계: ID 공급자에서 그룹을 구성하고 그룹을 역할 및 시트 유형에 매핑

할당하려는 각 역할에 대해 IdP에서 그룹을 만드세요. 단일 시트 엔터프라이즈 플랜을 사용 중이 아닌 경우 각 시트 유형에 대해서도 그룹을 만드세요.
1. 이러한 그룹에 대한 명명 요구 사항은 더 이상 없지만, 그룹 이름에 무언가를 포함하는 것이 좋습니다(예: anthropic-claude- 또는 anthropic-console-). 이렇게 하면 식별하기가 더 쉬워집니다.
만든 그룹에 사용자를 추가하고, 최소한 한 명의 사용자(자신 포함)가 Admin(Console) 또는 Owner(Claude) 역할에 매핑될 그룹에 있는지 확인하세요.
Claude 또는 Console의 조직 및 액세스 또는 ID 및 액세스 설정으로 돌아가서 사용자 프로비저닝을 찾으세요.
그룹 매핑 활성화를 켜세요(아직 켜지 않은 경우):
그룹 매핑 활성화 섹션에서 각 역할 옆의 "추가"를 클릭하고 드롭다운에서 IdP의 해당 그룹을 선택하세요.
1. 그룹 매핑을 사용할 때는 모든 사용자가 역할 기반 그룹에 할당되어 계정이 프로비저닝되도록 해야 합니다. 사용자를 시트 계층 기반 그룹에 할당하는 것은 선택 사항입니다.
2. IdP 그룹을 "Custom" 역할에 매핑할 수 있습니다. 이 역할이 할당된 사용자는 기본 권한이 없으며, 해당 액세스는 Claude의 그룹에 할당된 사용자 정의 역할에 의해 완전히 결정됩니다. JIT를 사용하는 경우, JIT가 IdP에서 그룹 멤버십을 동기화하지 않으므로 사용자가 로그인하기 전에 조직 설정 > 그룹에서 이러한 사용자를 그룹에 수동으로 추가하세요.
단일 시트 Enterprise를 제외한 모든 플랜: IdP 그룹에 시트 계층 할당 섹션(선택 사항)에서 각 시트 유형 옆의 "추가"를 클릭하고 IdP에서 해당 그룹을 선택합니다. 시트 계층 그룹에 없는 사용자는 제거되지 않습니다. 기존 사용자는 현재 시트 유형을 유지합니다. 새 사용자는 할당되지 않은 구매 시트가 남아 있는 가장 높은 시트 유형(예: 할당되지 않은 Premium 시트가 남아 있으면 Premium, 그 다음 Standard)을 받으며, 사용 가능한 시트가 없으면 시트 없이 추가됩니다.
1. 단일 시트 Enterprise: 시트 유형 매핑이 적용되지 않습니다. 프로비저닝된 모든 사용자는 조직에서 사용 가능한 Enterprise 시트가 있으면 자동으로 할당됩니다.
필요한 모든 그룹이 적절한 역할 및 시트 유형에 매핑되었는지 확인하세요.
"변경 사항 저장"을 클릭하세요.
1. 참고: Microsoft Entra는 40분마다만 SCIM 변경 사항을 푸시하므로 변경 사항이 나타나기 전에 지연이 있을 수 있습니다. "SCIM 관리"를 클릭하고 디렉터리를 확인하여 IdP에서 동기화된 사용자를 확인할 수 있습니다. 디렉터리의 해당 사용자는 Claude / Console에 프로비저닝됩니다.

중요: 액세스가 필요한 모든 사용자는 그룹 매핑 구성을 저장하기 전에 적절한 그룹에 할당되어야 합니다. 이러한 사용자는 SSO를 활성화할 때 IdP의 Anthropic 애플리케이션에 이미 할당되어 있어야 합니다.

Primary Owner 역할이 JIT 및 SCIM과 함께 작동하는 방식

조직의 Primary Owner는 SCIM 조정에서 제외됩니다. Primary Owner 계정이 IdP 디렉터리에 없거나 역할에 매핑된 그룹의 멤버가 아닌 경우, SCIM이 동기화할 때 건너뜁니다. JIT 및 그룹 매핑을 사용하면 Primary Owner의 역할은 로그인할 때 변경되지 않으며, 매핑된 그룹에 없으면 제거되지 않습니다. Primary Owner의 멤버십 및 역할은 유지됩니다.
이 제외는 단일 Primary Owner 역할에만 적용됩니다. Owner 및 Admin 역할은 제외되지 않으며 역할에 매핑된 그룹에 반드시 있어야 하며, 그렇지 않으면 SCIM 그룹 매핑이 활성화될 때 제거됩니다. JIT 및 그룹 매핑을 사용하면 다음 로그인 시 제거됩니다.
Primary Owner 역할은 그룹 매핑을 통해 할당할 수 없습니다. 조직 설정 > 멤버에서만 수동으로 전송할 수 있습니다. SCIM 또는 그룹 매핑을 활성화하기 전에 의도한 Primary Owner를 설정하세요.
Primary Owner는 SSO 로그인 적용에서 제외되지 않습니다. SSO 적용은 이메일 도메인으로 적용되며, Primary Owner의 이메일이 적용된 도메인에 있으면 SSO를 통해 인증해야 합니다.

문제 해결

사용자가 올바르게 할당되었고 디렉터리에 표시되지만 Claude에 멤버로 추가되지 않습니까?

조직에 멤버를 추가할 수 있는 충분한 시트가 구매되고 사용 가능한지 확인하세요.

조직 설정 > 조직 및 액세스에 표시된 사용 가능한 시트 수를 확인하고 필요한 경우 추가 시트를 구매하세요(Team 플랜 및 Enterprise 플랜에 대한 가이드 참조).
사용 가능한 시트가 있으면 조직 및 액세스 페이지로 돌아가서 디렉터리 동기화(SCIM) 옆의 "지금 동기화"를 클릭하세요. 이렇게 하면 아직 멤버로 추가되지 않은 사용자의 계정을 프로비저닝하기 위한 동기화가 트리거됩니다.

사용자가 올바른 역할로 프로비저닝되지 않습니다

사용자가 IdP의 올바른 그룹에 할당되었는지 확인하세요.
조직 및 액세스 설정에서 그룹이 올바른 역할에 매핑되었는지 확인하세요.
JIT의 경우: 역할 변경이 적용되려면 사용자가 로그아웃했다가 다시 로그인해야 합니다.
SCIM의 경우: "동기화"를 클릭하여 즉시 동기화를 시작하거나 자동 동기화 주기를 기다리세요:

Custom 역할에 매핑된 사용자가 로그인 후 아무것도 액세스할 수 없습니다

이는 프로비저닝 모드가 JIT이고 IdP 그룹이 Custom 역할에 매핑될 때 발생합니다. JIT는 역할 유형을 할당하지만 IdP에서 그룹 멤버십을 동기화하지 않으므로 이러한 사용자는 사용자 정의 역할이 첨부된 그룹에 없으며 권한이 없습니다.

이를 해결하려면 다음 중 하나를 수행하세요:

조직 설정 > 그룹에서 영향을 받는 사용자를 적절한 그룹에 수동으로 추가하세요. Enterprise 플랜에서 그룹 관리에 대해 자세히 알아보세요.
프로비저닝 모드를 SCIM 디렉터리 동기화로 전환하여 IdP에서 그룹 및 해당 멤버십을 동기화하세요. SCIM 동기화 작동 방식에 대해 자세히 알아보세요.

그룹 매핑을 활성화한 후 Admin/Owner 액세스를 잃었습니다

이는 그룹 매핑을 구성하는 사람이 Admin 또는 Owner 역할에 매핑된 그룹에 할당되지 않아 권한이 User로 다운그레이드될 때 발생합니다. 매핑된 그룹에 없는 사람은 조직에서 제거되며(JIT의 경우 다음 로그인 시, SCIM의 경우 다음 동기화 시) 다시 추가해야 합니다. 이는 Primary Owner에게 영향을 주지 않습니다.