메인 콘텐츠로 건너뛰기

OneLogin SSO/SCIM 이메일 불일치

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 필드

일반적인 값

일반적으로 사용되는 대상

Username

testuser1 또는 [email protected]

SCIM userName 매핑에서 때때로 사용됨

Email

SCIM 및 SAML 모두에 권장됨

Login Name

SSO가 비이메일 로그인에 사용되는 경우 이메일과 다를 수 있음

레거시 또는 사용자 정의 구성

사용자 정의 사용자 필드

조직별로 정의된 사용자 정의 속성

고급 속성 매핑

일반적인 불일치: SCIM 매개변수 탭이 이메일 속성을 Username(직원 ID 또는 짧은 이름일 수 있음)에 매핑하는 반면 SAML 속성 명령문은 Email 필드를 전송합니다. Claude는 정확한 문자열 일치를 요구합니다.

일반적인 혼동: OneLogin의 SCIM 매개변수와 SAML 속성 명령문은 동일한 앱의 다른 탭에 있습니다. SCIM의 경우 Parameters, SSO의 경우 SSO (또는 SAML 관련 필드가 있는 Parameters). 둘 다 확인하고 정렬해야 합니다.


진단 단계

1단계 — 불일치 확인

  1. SCIM 이메일 확인: OneLogin 관리자 포털에서 Applications → [Claude 앱] → Parameters로 이동합니다. Claude가 수신하는 이메일에 매핑된 필드를 찾습니다. OneLogin value 열을 참고하세요. 이는 전송되는 사용자 필드를 표시합니다.

  2. SAML 이메일 확인: 동일한 앱에서 SSO 탭으로 이동합니다. More Actions → Edit SAML Response를 클릭하거나 SAML Attribute Statements 섹션을 확인합니다. 이메일 속성을 찾고 해당 소스 필드를 참고합니다.

  3. 특정 사용자 확인: Users → [User]에서 Username 및 Email 필드를 비교합니다. 이들이 다르면 하나 또는 다른 것을 사용하는 모든 매핑이 불일치를 유발합니다.

2단계 — 문제의 범위 파악

  • 대부분 또는 모든 프로비저닝된 사용자가 동일한 이메일 형식 불일치를 공유하는 경우, 이는 시스템 속성 매핑 문제입니다. 해결책은 IdP의 SCIM 속성 매핑에 있습니다.

  • 1~2명의 사용자만 영향을 받는 경우, 문제는 해당 계정에만 해당될 가능성이 높습니다. 해당 프로필을 직접 확인하세요.

3단계 — 사용자 필드 값 검토

  1. Users → [영향받은 사용자] → User Info로 이동합니다.

  2. Username 및 Email 필드를 모두 확인합니다.

  3. Username이 유효한 이메일과 일치하지 않는 형식인 경우, SCIM이 유효하지 않거나 일치하지 않는 값을 전송할 수 있습니다.


해결

두 매핑을 Email 필드에 정렬

OneLogin의 Email 필드는 SCIM과 SAML 모두에 가장 안정적인 소스이며, 유효한 이메일 주소를 보유하도록 설계되었습니다.

  1. SCIM 매개변수 업데이트: Applications → [Claude 앱] → Parameters에서 Claude가 수신하는 이메일 속성의 행을 찾습니다. Value를 Email(OneLogin Email 필드)로 변경합니다.

  2. SAML 속성 명령문 업데이트: SSO 탭(또는 SAML 속성의 Parameters)에서 이메일 속성 값을 동일한 Email 필드를 사용하도록 업데이트합니다.

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

전체 재동기화 트리거

중요 — 전체 동기화 필수: 증분 동기화는 속성 매핑을 변경한 후 기존 레코드를 업데이트하지 않습니다. 프로비저닝 주기의 전체 재시작을 트리거해야 합니다.

  1. 앱의 Provisioning 탭에서 Re-sync 또는 Sync All 옵션을 찾아 실행합니다.

  2. 개별 사용자를 다시 프로비저닝하려면: Users → [User] → Applications로 이동하여 Claude 앱을 찾고 Re-provision을 사용합니다.

  3. OneLogin 프로비저닝 활동 로그에서 오류를 확인합니다.

  4. 사용자에게 로그인을 다시 시도하도록 요청하기 전에 업데이트된 이메일 값이 로그에 나타나는지 확인합니다.


수정 후 정리

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

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

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

  • 시트 가용성: 유령 계정이 모든 계약된 시트를 차지하는 경우, 매핑이 수정된 후에도 새 로그인이 시트 부족 오류로 실패합니다.

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

  • 향후 발생 방지: 조직의 Identity and access 설정에서 “조직 생성 제한”을 활성화하세요.


확인

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

  2. 영향받은 사용자에게 claude.ai의 브라우저 쿠키를 지우도록 요청한 후 SSO를 통해 로그인하세요.

  3. 사용자가 무료 계정을 생성하지 않는지 확인합니다.

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


일반적인 문제

문제

해결책

Username 필드가 이메일이 아닌 짧은 이름 또는 직원 ID를 보유함

SCIM을 Email 필드를 사용하도록 전환합니다.

SAML 속성은 업데이트되었지만 SCIM 매개변수는 변경되지 않음

Parameters 탭(SCIM용)과 SSO/SAML 속성을 모두 독립적으로 업데이트해야 합니다.

재동기화가 트리거되지 않는 것으로 보임

영향받은 사용자를 앱에서 제거했다가 다시 할당해 보세요.

사용자 정의 사용자 필드가 매핑되었지만 일부 사용자에 대해 비어 있음

표준 Email 필드로 전환합니다.

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

불법 무료 조직 또는 유령 계정을 확인하세요. 브라우저 쿠키를 지우고 다시 시도하세요.

“초대 도메인이 허용되지 않음” 사용자를 다시 추가하려고 할 때

조직의 도메인이 Claude에서 확인되지 않았을 수 있습니다. 지원팀에 문의하세요.


지원팀에 문의할 시기

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

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

  • SCIM 프로비저닝 중에 Claude가 기록한 이메일 확인이 필요합니다.

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

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

답변이 도움되었나요?