Claude는 이메일을 기본 식별자로 사용하여 SSO 로그인을 프로비저닝된 시트와 일치시킵니다. Ping Identity 제품(PingOne 및 PingFederate)은 유연한 계층화된 속성 구성을 제공합니다. SCIM 프로비저닝과 SAML/OIDC SSO가 서로 다른 사용자 속성에서 데이터를 가져올 때, 불일치로 인해 액세스가 차단됩니다.
적용 대상: SCIM 프로비저닝을 사용하는 Enterprise 플랜 및 Console 조직. Team 플랜에는 SCIM 프로비저닝이 없으므로 이 불일치 시나리오가 적용되지 않습니다. 각 플랜에서 사용 가능한 기능은 JIT 또는 SCIM 프로비저닝 설정을 참조하세요.
증상
SSO를 통해 조직에 액세스하려고 할 때 사용자가 다음 중 하나 이상을 경험할 수 있습니다:
“계정 생성이 차단됨” — 사용자가 SSO를 통해 인증되지만 Claude가 일치하는 프로비저닝된 계정을 찾을 수 없습니다.
무료 개인 계정으로 이동 — 조직 생성이 제한되지 않으면 사용자가 조직을 완전히 우회합니다.
“로그인한 계정 확인” 불일치 — SSO 콜백이 사용자가 로그인 시 입력한 이메일과 다른 이메일을 표시합니다.
Claude Code 인증 실패 — Claude Code CLI가 인증 흐름 중에 이메일 불일치 오류를 표시합니다.
이것이 발생하는 방식
Ping Identity 제품은 여러 수준(디렉터리, IdP 어댑터, SP 커넥터, 애플리케이션)에서 세분화된 속성 매핑을 허용합니다. SCIM과 SSO는 각각 이러한 계층을 통해 서로 다른 경로를 따를 수 있으므로 Claude에 도달하는 이메일 값이 달라질 수 있습니다:
Ping 속성 | 일반적인 값 | 일반적으로 사용되는 대상 |
| SCIM 및 SAML/OIDC 모두에 권장됨 | |
|
| 기본 로그인 식별자, 이메일과 다를 수 있음 |
IdP 어댑터 속성 (PingFederate) | 어댑터 유형(LDAP, HTML Form 등)에 따라 다름 | PingFederate 신원 소스 |
LDAP | PingFederate의 디렉터리 소스 이메일 | |
LDAP | 직원 ID 또는 짧은 사용자 이름일 수 있음 | 실수로 이메일에 매핑되기도 함 |
사용자 정의 population 속성 | 환경별로 정의된 사용자 정의 필드 | 고급 PingOne 구성 |
Claude는 SCIM 프로비저닝된 이메일과 SSO 어설션 이메일 간의 정확한 문자열 일치를 요구합니다.
PingFederate 참고: PingFederate의 속성 계약 시스템은 특히 복잡합니다. 이메일은 여러 계층(LDAP → IdP 어댑터 → 어댑터 계약 → SP 커넥터 → 어설션)을 통과할 수 있습니다. 어느 계층에서든 불일치가 발생하면 잘못된 값이 Claude에 도달합니다. 값을 끝에서 끝까지 추적하세요.
진단 단계
단계 1 — 불일치 확인 (PingOne)
SCIM 속성 매핑 확인: PingOne Admin에서 Connections → Applications → [Claude 앱] → Attribute Mappings로 이동합니다. emails[primary].value 또는 email에 매핑된 속성을 찾습니다. 소스로 사용되는 PingOne 사용자 속성을 기록합니다.
SSO 속성 매핑 확인: 같은 앱에서 SAML 또는 OIDC 탭으로 이동하여 이메일에 매핑된 속성 또는 클레임을 찾습니다. 소스 속성을 기록합니다.
SCIM과 SSO가 서로 다른 PingOne 속성을 참조하면 불일치를 확인한 것입니다.
단계 1 (대체) — 불일치 확인 (PingFederate)
PingFederate Admin 콘솔에서 Claude의 SP Connection을 찾습니다.
Attribute Contract Fulfillment에서 이메일 속성을 찾고 그 소스를 IdP 어댑터 또는 LDAP 데이터 저장소로 추적합니다.
별도로 Claude의 SCIM 프로비저닝 커넥터 또는 아웃바운드 프로비저닝 채널을 확인하고 전송되는 이메일 속성의 소스를 추적합니다.
두 추적이 서로 다른 디렉터리 속성으로 이어지면 불일치를 확인한 것입니다.
단계 2 — 문제의 범위 파악
대부분 또는 모든 프로비저닝된 사용자가 동일한 이메일 형식 불일치를 공유하면 이는 체계적 속성 매핑 문제입니다. 해결책은 IdP의 SCIM 속성 매핑에 있습니다.
한두 명의 사용자만 영향을 받으면 문제는 해당 계정에만 해당할 가능성이 높습니다. 해당 프로필을 직접 확인하세요.
단계 3 — 특정 사용자의 속성 값 확인
PingOne: Identities → Users → [사용자]로 이동하여 Username 및 Email 필드 값을 비교합니다.
LDAP가 있는 PingFederate: 사용자의 LDAP 레코드를 확인하고 mail, userPrincipalName, sAMAccountName 및 어댑터 매핑에 사용되는 기타 속성을 비교합니다.
해결
PingOne — 두 매핑을 이메일 속성에 맞추기
Connections → Applications → [Claude 앱]에서 Attribute Mappings를 엽니다.
SCIM의 경우: emails[primary].value가 PingOne의 Email Address 속성에 매핑되는지 확인합니다.
SAML/OIDC의 경우: 이메일 속성 또는 클레임도 PingOne의 Email Address 속성에 매핑되는지 확인합니다.
변경 사항을 저장합니다.
PingFederate — 모든 계층에서 속성 계약 맞추기
Claude의 SP Connection에서 Attribute Contract Fulfillment로 이동합니다.
이메일 속성을 찾습니다. 그 소스가 SCIM 아웃바운드 프로비저닝 채널에서 사용되는 동일한 LDAP 또는 데이터 저장소 속성인지 확인합니다.
사용자 정의 IdP 어댑터를 사용하는 경우 어댑터의 계약에 정규 이메일 속성이 포함되어 있고 SP 연결을 통해 올바르게 매핑되는지 확인합니다.
SCIM 프로비저닝을 업데이트하여 동일한 소스 속성을 사용하도록 합니다.
전체 재동기화 트리거
중요 — 전체 동기화 필수: 속성 매핑을 변경한 후 증분 동기화는 기존 레코드를 업데이트하지 않습니다. 프로비저닝 사이클의 전체 재시작을 트리거해야 합니다.
PingOne: 앱의 프로비저닝 설정에서 전체 프로비저닝 사이클을 트리거합니다. 완전한 재푸시를 강제하려면 프로비저닝을 비활성화했다가 다시 활성화해야 할 수 있습니다.
PingFederate: 아웃바운드 프로비저닝 채널에서 전체 동기화를 트리거합니다. 프로비저닝 로그를 확인하여 업데이트된 이메일 값이 전송되고 있는지 확인합니다.
사용자에게 로그인을 다시 시도하도록 요청하기 전에 업데이트된 이메일 값이 프로비저닝 로그에 나타나는지 확인합니다.
수정 후 정리
속성 매핑을 수정하고 전체 동기화를 완료한 후:
불량 무료 계정: 수정 전에 조직 생성이 제한되지 않았다면 일부 사용자가 실수로 무료 개인 Claude 계정을 생성했을 수 있습니다. 지원팀에 문의하여 이를 제거하도록 합니다.
Ghost 계정(잘못된 이메일 시트): 지원팀에 문의하여 이를 프로비저닝 해제합니다.
시트 가용성: Ghost 계정이 계약된 모든 시트를 차지하고 있으면 새 로그인이 실패합니다. 지원팀에 문의합니다.
영향을 받은 사용자 다시 추가: Ghost 계정이 제거된 후 사용자를 다시 초대하거나 다시 프로비저닝해야 할 수 있습니다.
향후 발생 방지: 조직의 Identity and access 설정에서 “조직 생성 제한”을 활성화합니다.
검증
프로비저닝된 사용자의 샘플을 확인하여 프로비저닝 로그의 이메일이 SSO가 전송하는 이메일 형식과 일치하는지 확인합니다.
영향을 받은 사용자에게 claude.ai의 브라우저 쿠키를 지우고 SSO를 통해 로그인하도록 요청합니다.
사용자가 무료 계정을 생성하지 않는지 확인합니다.
Claude Code가 영향을 받은 경우 사용자에게
claude auth login --enterprise를 다시 실행하도록 하고 이메일이 프로비저닝된 시트와 일치하는지 확인합니다.
일반적인 문제
문제 | 해결책 |
PingOne | SCIM 매핑을 PingOne의 Email Address 속성으로 전환합니다. |
계약 계층 전체에서 PingFederate 속성 불일치 | 이메일 속성을 끝에서 끝까지 추적합니다: LDAP 소스 → IdP 어댑터 → 어댑터 계약 → SP 커넥터 → 어설션. |
LDAP | 대신 LDAP |
증분 프로비저닝 동기화가 기존 레코드를 업데이트하지 않음 | 속성 매핑을 변경한 후 전체 재동기화가 필요합니다. |
PingFederate에서 속성 계약이 업데이트되었지만 SCIM 커넥터는 업데이트되지 않음 | SP 연결과 아웃바운드 SCIM 프로비저닝 채널을 모두 독립적으로 업데이트해야 합니다. |
SCIM에서 이메일이 업데이트되었지만 사용자가 여전히 로그인할 수 없음 | 불량 무료 조직 또는 ghost 계정을 확인합니다. 브라우저 쿠키를 지우고 다시 시도합니다. |
지원팀에 문의할 시기
다음의 경우 조직의 도메인, 영향을 받은 사용자의 이메일, 속성 매핑의 스크린샷과 함께 지원팀에 문의하세요:
SCIM 및 SSO 속성이 동일해 보이지만 사용자가 여전히 시트에 액세스할 수 없습니다.
특정 사용자에 대해 Claude가 SCIM 프로비저닝 중에 기록한 이메일 확인이 필요합니다.
Ghost 계정 또는 불량 무료 조직 정리에 도움이 필요합니다.
사용 가능한 계약된 시트가 있음에도 불구하고 사용자가 시트 부족 오류를 받고 있습니다.
