메인 콘텐츠로 건너뛰기

Okta SSO/SCIM 이메일 불일치

Claude는 이메일을 기본 식별자로 사용하여 SSO 로그인을 프로비저닝된 시트와 일치시킵니다. Okta에서 SCIM 프로비저닝과 SSO는 별도로 구성되며 다른 사용자 프로필 필드에서 이메일을 가져올 수 있습니다. 이 가이드는 불일치를 식별하고 해결하는 방법을 설명합니다.

적용 대상: SCIM 프로비저닝을 사용하는 Enterprise 플랜 및 Console 조직. Team 플랜에는 SCIM 프로비저닝이 없으므로 이 불일치 시나리오가 적용되지 않습니다. 각 플랜에서 사용 가능한 기능은 JIT 또는 SCIM 프로비저닝 설정을 참조하세요.


증상

SSO를 통해 조직에 액세스하려고 할 때 사용자가 다음 중 하나 이상을 경험할 수 있습니다:

  • “계정 생성이 차단됨” — SSO 인증은 성공하지만 Claude가 일치하는 프로비저닝된 계정을 찾을 수 없습니다. 조직에 조직 생성이 제한되어 있으면(권장) 해당 사용자는 완전히 차단됩니다.

  • 무료 개인 계정에 랜딩 — 조직 생성이 제한되지 않으면 사용자는 조직을 완전히 우회하고 프로비저닝된 시트 대신 무료 개인 계정을 생성하거나 랜딩합니다.

  • “로그인한 계정 확인” 불일치 — SSO 콜백이 사용자가 로그인할 때 입력한 이메일과 다른 이메일을 표시합니다.

  • Claude Code 인증 실패 — Claude Code CLI가 인증 흐름 중에 이메일 불일치 오류를 표시합니다.


이것이 발생하는 방식

Okta 사용자 프로필에는 ID를 나타내는 여러 필드가 포함되어 있습니다. SCIM 프로비저닝(Provisioning → To App 아래)과 SAML/OIDC SSO(Sign On 아래)는 독립적으로 구성됩니다.

Okta 속성

일반적인 값

일반적으로 사용하는 대상

user.login

testuser1 또는 [email protected]

기본 SCIM userName 매핑; 때때로 NameID

user.email

SAML/OIDC 이메일 클레임(권장)

appuser.email

사용자 이메일의 앱 수준 재정의

사용자 정의 앱 수준 속성 매핑

일반적인 불일치: SCIM은 user.login을 사용하고 SAML은 user.email을 보냅니다. Claude는 정확한 문자열 일치가 필요합니다.

일반적인 혼동: Okta의 SCIM 속성 매핑과 SAML 속성 명령문은 두 개의 다른 탭에 있습니다. SCIM의 경우 Provisioning → To App, SSO의 경우 Sign On입니다.


진단 단계

1단계 — 불일치 확인

  1. SCIM 이메일 확인: Applications → [Claude App] → Provisioning → To App → Attribute Mappings로 이동합니다. email(또는 userName) 행을 찾습니다. Value 열은 전송되는 Okta 표현식을 표시합니다.

  2. SSO 이메일 확인(SAML): Applications → [Claude App] → Sign On → SAML Settings → Edit → Attribute Statements로 이동합니다. email 속성을 찾습니다. Value 열은 어떤 Okta 필드가 어설션되는지 나타냅니다.

  3. SSO 이메일 확인(OIDC): Applications → [Claude App] → Sign On → OpenID Connect ID Token으로 이동하고 이메일에 대한 Claims 섹션을 검토합니다.

  4. SCIM 및 SSO 값이 다른 Okta 필드를 참조하면 불일치가 확인됩니다.

2단계 — 문제의 범위 파악

  • 대부분 또는 모든 프로비저닝된 사용자가 영향을 받음: 이는 시스템 속성 매핑 문제입니다. 수정은 IdP의 SCIM 속성 매핑에 있습니다.

  • 한두 명의 사용자만 영향을 받음: 문제는 해당 계정에만 해당됩니다. 해당 사용자 프로필을 직접 확인하세요.

3단계 — Okta 사용자 프로필 직접 확인

  1. Directory → People → [User] → Profile로 이동합니다.

  2. Login 및 Email 필드 값을 비교합니다. 이 필드 간의 차이는 매핑 불일치를 생성합니다.


해결

두 매핑을 동일한 Okta 필드에 정렬

가장 안전한 수정은 SCIM과 SSO 모두에 user.email을 사용하는 것입니다. 이 필드는 Okta의 정규 이메일 주소를 포함합니다.

  1. SCIM 매핑 업데이트: Provisioning → To App → Attribute Mappings에서 email(또는 userName) 소스를 user.email로 변경합니다.

  2. SSO 클레임 업데이트(SAML): Sign On → SAML Settings → Attribute Statements에서 이메일 속성 값을 user.email로 변경합니다.

  3. SSO 클레임 업데이트(OIDC): Sign On → OpenID Connect ID Token → Claims에서 이메일 클레임을 user.email에 매핑하도록 업데이트합니다.

  4. “저장”을 클릭합니다.

전체 재동기화 강제 실행

중요 — 전체 동기화 필요: 속성 매핑을 변경한 후 증분 동기화는 기존 레코드를 업데이트하지 않습니다.

  1. Provisioning → To App에서 “Force Sync”를 클릭하여 할당된 모든 사용자의 전체 재평가를 트리거합니다.

  2. 또는 특정 사용자의 경우: Provisioning → Push Users → 영향을 받은 사용자 선택 → Push Now.

  3. Okta System Log(Reports → System Log)에서 프로비저닝 오류를 확인합니다.

  4. 사용자가 로그인을 다시 시도하기 전에 업데이트된 이메일 값이 프로비저닝 로그에 나타나는지 확인합니다.


수정 후 정리

속성 매핑을 수정하고 전체 동기화를 완료한 후:

  • 불법 무료 계정: 수정 전에 조직 생성이 제한되지 않았다면 일부 사용자가 무료 개인 Claude 계정을 생성했을 수 있습니다. 제거를 위해 지원 팀에 문의하세요.

  • Ghost 계정(잘못된 이메일 시트): 잘못된 이메일로 원래 프로비저닝된 계정이 조직에 여전히 존재할 수 있으며 사용할 수 없는 시트를 차지합니다. 프로비저닝 해제를 위해 지원 팀에 문의하세요.

  • 시트 가용성: Ghost 계정이 모든 계약된 시트를 차지하고 있으면 매핑이 수정된 후에도 새 로그인이 시트 부족 오류로 실패합니다.

  • 영향을 받은 사용자 다시 추가: Ghost 계정 제거 후 수정된 이메일을 가진 사용자는 다시 초대되거나 다시 프로비저닝되어야 할 수 있습니다.

  • 향후 발생 방지: 조직의 Identity and access 설정에서 “조직 생성 제한”을 활성화하여 프로비저닝되지 않은 사용자가 무료 계정을 생성하는 것을 방지합니다.


확인

수정 및 정리를 완료한 후:

  1. 프로비저닝된 사용자 샘플을 확인합니다. 프로비저닝 로그의 이메일이 SSO가 보내는 이메일 형식과 일치하는지 확인합니다.

  2. 영향을 받은 사용자에게 claude.ai의 브라우저 쿠키를 지우도록 요청한 후 SSO를 통해 로그인합니다. 오류 없이 조직의 워크스페이스에 직접 랜딩해야 합니다.

  3. 사용자가 무료 계정을 생성하지 않는지 확인합니다. 조직 생성이 제한되면 차단된 사용자는 개인 계정에 랜딩하는 대신 명확한 오류를 봅니다.

  4. Claude Code가 영향을 받은 경우 사용자에게 claude auth login --enterprise를 다시 실행하도록 하고 이메일이 프로비저닝된 시트와 일치하는지 확인합니다.


일반적인 문제

문제

해결책

관리자가 SAML 클레임을 업데이트하지만 SCIM 속성 매핑을 잊음(또는 그 반대)

둘 다 업데이트해야 합니다. SCIM 매핑은 Provisioning → To App 아래, SAML 클레임은 Sign On → SAML Settings 아래입니다.

user.login에 일부 사용자의 사용자 이름(이메일 아님)이 포함됨

둘 다 user.email로 전환하고 모든 사용자에 대해 이메일 필드가 채워져 있는지 확인합니다.

증분 동기화가 실행되지만 이메일이 업데이트되지 않음

속성 매핑 변경 후 Force Sync 또는 Push Users가 필요합니다.

앱 수준 프로필 속성(appuser.email)이 사용자 프로필(user.email)과 다름

앱 수준 속성 매핑이 사용자 프로필 값을 재정의하는지 확인합니다.

이메일이 업데이트되었지만 사용자가 여전히 로그인할 수 없음

불법 무료 조직 또는 Ghost 계정을 찾습니다. 브라우저 쿠키를 지우고 다시 시도합니다. 지속되면 지원팀에 문의하세요.

OIDC 및 SAML 앱은 Claude용 별도의 Okta 앱입니다

일부 조직에서는 둘 다 구성합니다. 두 앱 모두에서 속성 정렬을 확인합니다.


지원팀에 문의할 시기

다음의 경우 조직의 도메인, 영향을 받은 사용자의 이메일, 속성 매핑 스크린샷과 함께 지원 팀에 문의하세요:

  • SCIM 및 SSO 속성이 동일해 보이지만 사용자가 여전히 시트에 액세스할 수 없습니다.

  • 특정 사용자에 대해 SCIM 프로비저닝 중에 Claude가 기록한 이메일 확인이 필요합니다.

  • Ghost 계정 또는 불법 무료 조직 정리에 도움이 필요합니다.

  • 사용 가능한 계약된 시트가 있음에도 불구하고 사용자가 시트 부족 오류에 도달하고 있습니다.

답변이 도움되었나요?