Claude는 이메일을 기본 식별자로 사용하여 SSO 로그인을 프로비저닝된 시트와 일치시킵니다. OneLogin에서 SCIM 프로비저닝과 SAML SSO는 앱의 별도 탭에서 구성되며 다른 사용자 프로필 필드를 참조할 수 있어 액세스를 차단하는 불일치가 발생할 수 있습니다.
적용 대상: SCIM 프로비저닝을 사용하는 Enterprise 플랜 및 Console 조직. Team 플랜에는 SCIM 프로비저닝이 없으므로 이 불일치 시나리오가 적용되지 않습니다. 각 플랜에서 사용 가능한 기능은 JIT 또는 SCIM 프로비저닝 설정을 참조하세요.
증상
SSO를 통해 조직에 액세스하려고 할 때 사용자가 다음 중 하나 이상을 경험할 수 있습니다:
“계정 생성이 차단됨” — 사용자가 SSO를 통해 인증되지만 Claude가 일치하는 프로비저닝된 계정을 찾을 수 없습니다. 조직에서 조직 생성이 제한된 경우(권장), 사용자가 완전히 차단됩니다.
무료 개인 계정에 랜딩 — 조직 생성이 제한되지 않은 경우, 사용자가 조직을 완전히 우회하고 프로비저닝된 시트 대신 무료 개인 계정을 생성하거나 랜딩합니다.
“로그인한 계정 확인” 불일치 — SSO 콜백이 사용자가 로그인할 때 입력한 이메일과 다른 이메일을 표시합니다.
Claude Code 인증 실패 — Claude Code CLI가 인증 흐름 중에 이메일 불일치 오류를 표시합니다.
이것이 발생하는 방식
OneLogin 사용자 프로필에는 사용자 이름과 이메일에 대한 별개의 필드가 포함되어 있으며, 이는 다른 값을 보유할 수 있습니다. SCIM 프로비저닝 매개변수와 SAML 속성 명령문은 독립적으로 구성되며 각각 다른 필드에서 가져올 수 있습니다:
OneLogin 필드 | 일반적인 값 | 일반적으로 사용되는 대상 |
|
| SCIM userName 매핑에서 때때로 사용됨 |
| SCIM 및 SAML 모두에 권장됨 | |
| SSO가 비이메일 로그인에 사용되는 경우 이메일과 다를 수 있음 | 레거시 또는 사용자 정의 구성 |
사용자 정의 사용자 필드 | 조직별로 정의된 사용자 정의 속성 | 고급 속성 매핑 |
일반적인 불일치: SCIM 매개변수 탭이 이메일 속성을 Username(직원 ID 또는 짧은 이름일 수 있음)에 매핑하는 반면 SAML 속성 명령문은 Email 필드를 전송합니다. Claude는 정확한 문자열 일치를 요구합니다.
일반적인 혼동: OneLogin의 SCIM 매개변수와 SAML 속성 명령문은 동일한 앱의 다른 탭에 있습니다. SCIM의 경우 Parameters, SSO의 경우 SSO (또는 SAML 관련 필드가 있는 Parameters). 둘 다 확인하고 정렬해야 합니다.
진단 단계
1단계 — 불일치 확인
SCIM 이메일 확인: OneLogin 관리자 포털에서 Applications → [Claude 앱] → Parameters로 이동합니다. Claude가 수신하는 이메일에 매핑된 필드를 찾습니다. OneLogin value 열을 참고하세요. 이는 전송되는 사용자 필드를 표시합니다.
SAML 이메일 확인: 동일한 앱에서 SSO 탭으로 이동합니다. More Actions → Edit SAML Response를 클릭하거나 SAML Attribute Statements 섹션을 확인합니다. 이메일 속성을 찾고 해당 소스 필드를 참고합니다.
특정 사용자 확인: Users → [User]에서 Username 및 Email 필드를 비교합니다. 이들이 다르면 하나 또는 다른 것을 사용하는 모든 매핑이 불일치를 유발합니다.
2단계 — 문제의 범위 파악
대부분 또는 모든 프로비저닝된 사용자가 동일한 이메일 형식 불일치를 공유하는 경우, 이는 시스템 속성 매핑 문제입니다. 해결책은 IdP의 SCIM 속성 매핑에 있습니다.
1~2명의 사용자만 영향을 받는 경우, 문제는 해당 계정에만 해당될 가능성이 높습니다. 해당 프로필을 직접 확인하세요.
3단계 — 사용자 필드 값 검토
Users → [영향받은 사용자] → User Info로 이동합니다.
Username 및 Email 필드를 모두 확인합니다.
Username이 유효한 이메일과 일치하지 않는 형식인 경우, SCIM이 유효하지 않거나 일치하지 않는 값을 전송할 수 있습니다.
해결
두 매핑을 Email 필드에 정렬
OneLogin의 Email 필드는 SCIM과 SAML 모두에 가장 안정적인 소스이며, 유효한 이메일 주소를 보유하도록 설계되었습니다.
SCIM 매개변수 업데이트: Applications → [Claude 앱] → Parameters에서 Claude가 수신하는 이메일 속성의 행을 찾습니다. Value를 Email(OneLogin Email 필드)로 변경합니다.
SAML 속성 명령문 업데이트: SSO 탭(또는 SAML 속성의 Parameters)에서 이메일 속성 값을 동일한 Email 필드를 사용하도록 업데이트합니다.
“저장”을 클릭합니다.
전체 재동기화 트리거
중요 — 전체 동기화 필수: 증분 동기화는 속성 매핑을 변경한 후 기존 레코드를 업데이트하지 않습니다. 프로비저닝 주기의 전체 재시작을 트리거해야 합니다.
앱의 Provisioning 탭에서 Re-sync 또는 Sync All 옵션을 찾아 실행합니다.
개별 사용자를 다시 프로비저닝하려면: Users → [User] → Applications로 이동하여 Claude 앱을 찾고 Re-provision을 사용합니다.
OneLogin 프로비저닝 활동 로그에서 오류를 확인합니다.
사용자에게 로그인을 다시 시도하도록 요청하기 전에 업데이트된 이메일 값이 로그에 나타나는지 확인합니다.
수정 후 정리
속성 매핑을 수정하고 전체 동기화를 완료한 후:
불법 무료 계정: 수정 전에 조직 생성이 제한되지 않은 경우, 일부 사용자가 실수로 무료 개인 Claude 계정을 생성했을 수 있습니다. 지원 팀에 문의하여 이를 제거하세요.
유령 계정(잘못된 이메일 시트): 잘못된 이메일로 원래 프로비저닝된 계정이 조직에 여전히 존재할 수 있으며, 절대 사용할 수 없는 시트를 차지합니다. 지원 팀에 문의하여 이를 프로비저닝 해제하세요.
시트 가용성: 유령 계정이 모든 계약된 시트를 차지하는 경우, 매핑이 수정된 후에도 새 로그인이 시트 부족 오류로 실패합니다.
영향받은 사용자 다시 추가: 유령 계정이 제거된 후, 수정된 이메일을 가진 사용자는 다시 초대되거나 다시 프로비저닝되어야 할 수 있습니다.
향후 발생 방지: 조직의 Identity and access 설정에서 “조직 생성 제한”을 활성화하세요.
확인
프로비저닝된 사용자의 샘플을 확인하세요. 프로비저닝 로그의 이메일이 SSO가 전송하는 이메일 형식과 일치하는지 확인합니다.
영향받은 사용자에게 claude.ai의 브라우저 쿠키를 지우도록 요청한 후 SSO를 통해 로그인하세요.
사용자가 무료 계정을 생성하지 않는지 확인합니다.
Claude Code가 영향을 받은 경우, 사용자에게
claude auth login --enterprise를 다시 실행하도록 하고 이메일이 프로비저닝된 시트와 일치하는지 확인합니다.
일반적인 문제
문제 | 해결책 |
Username 필드가 이메일이 아닌 짧은 이름 또는 직원 ID를 보유함 | SCIM을 Email 필드를 사용하도록 전환합니다. |
SAML 속성은 업데이트되었지만 SCIM 매개변수는 변경되지 않음 | Parameters 탭(SCIM용)과 SSO/SAML 속성을 모두 독립적으로 업데이트해야 합니다. |
재동기화가 트리거되지 않는 것으로 보임 | 영향받은 사용자를 앱에서 제거했다가 다시 할당해 보세요. |
사용자 정의 사용자 필드가 매핑되었지만 일부 사용자에 대해 비어 있음 | 표준 Email 필드로 전환합니다. |
SCIM에서 이메일이 업데이트되었지만 사용자가 여전히 로그인할 수 없음 | 불법 무료 조직 또는 유령 계정을 확인하세요. 브라우저 쿠키를 지우고 다시 시도하세요. |
“초대 도메인이 허용되지 않음” 사용자를 다시 추가하려고 할 때 | 조직의 도메인이 Claude에서 확인되지 않았을 수 있습니다. 지원팀에 문의하세요. |
지원팀에 문의할 시기
다음의 경우 조직의 도메인, 영향받은 사용자의 이메일, 속성 매핑의 스크린샷과 함께 지원 팀에 문의하세요:
SCIM 및 SSO 속성이 동일해 보이지만 사용자가 여전히 시트에 액세스할 수 없습니다.
SCIM 프로비저닝 중에 Claude가 기록한 이메일 확인이 필요합니다.
유령 계정 또는 불법 무료 조직 정리에 도움이 필요합니다.
사용 가능한 계약된 시트가 있음에도 불구하고 사용자가 시트 부족 오류에 직면하고 있습니다.
