메인 콘텐츠로 건너뛰기

Microsoft Entra ID SSO/SCIM 이메일 불일치

Claude는 이메일을 기본 식별자로 사용하여 SSO 로그인을 프로비저닝된 시트와 일치시킵니다. Microsoft Entra ID에서 SCIM 프로비저닝과 SSO 인증은 별도의 위치에서 구성되며 다른 사용자 속성에서 이메일을 가져올 수 있어 액세스를 차단하는 불일치가 발생합니다. 이 가이드는 문제를 식별하고, 속성 매핑을 수정하고, 부작용을 정리하는 방법을 안내합니다.

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


증상

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

  • “계정 생성이 차단됨” — 사용자가 SSO를 통해 인증하지만 Claude가 일치하는 프로비저닝된 계정을 찾을 수 없습니다. 조직 생성이 제한된 경우(권장), 사용자가 완전히 차단됩니다.

  • 무료 개인 계정에 도착 — 조직 생성이 제한되지 않은 경우, 사용자가 조직을 우회하고 무료 개인 계정을 생성하거나 도착합니다.

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

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


이것이 발생하는 방식

Microsoft Entra ID 사용자 계정에는 다른 값을 보유할 수 있는 여러 이메일 같은 속성이 있습니다. SCIM 프로비저닝과 SSO 인증은 별도의 관리 영역에서 구성되며 각각 다른 속성에서 가져올 수 있습니다:

Entra 속성

일반적인 값

일반적으로 사용되는 대상

userPrincipalName

[email protected] (직원 ID 형식일 수 있음)

기본 SCIM userName 매핑

mail

[email protected] (표준 이메일)

OIDC / SAML 이메일 클레임

proxyAddresses

Exchange / M365 기본 주소

otherMails

별칭 또는 보조 주소를 포함할 수 있음

대체 연락처 이메일

SCIM이 한 속성에서 이메일을 가져오고 SSO가 다른 속성에서 이메일을 보낼 때 불일치가 발생합니다. 미묘한 차이도 액세스를 차단합니다. Claude는 정확한 문자열 일치를 요구합니다.

일반적인 혼동: Entra에는 두 개의 별도 관리 영역이 있습니다. SCIM 프로비저닝 앱은 Enterprise 애플리케이션 아래에 있습니다(Microsoft의 통합 앱 용어 - Claude 플랜과 무관). SSO/OIDC 앱은 앱 등록 아래에 있습니다. IT 관리자가 자주 잘못된 위치로 이동합니다.


진단 단계

1단계 — 불일치 확인

  1. SCIM 이메일 확인: Entra 관리 센터 → Enterprise 애플리케이션 → [Claude SCIM 앱] → 프로비저닝 → 프로비저닝 로그에서 최근에 프로비저닝된 사용자를 찾고 수정된 속성을 검사합니다. emails[type eq “work”].value에 매핑된 값이 SCIM이 Claude에 보낸 것입니다.

  2. SSO 이메일 확인: Enterprise 애플리케이션 → [Claude 앱] → Single sign-on → 속성 및 클레임에서 이메일 클레임을 찾습니다. OIDC 앱의 경우 앱 등록 → [Claude 앱] → 토큰 구성을 확인합니다.

  3. 두 소스 속성이 다른 필드를 가리키면 불일치를 확인한 것입니다.

2단계 — 범위 식별

  • 대부분 또는 모든 프로비저닝된 사용자가 동일한 형식 불일치를 공유하면 이는 체계적 속성 매핑 문제입니다. 수정은 SCIM 속성 매핑 구성에 있습니다.

  • 한두 명의 사용자만 영향을 받으면 Entra에서 직접 사용자 프로필을 확인합니다.

3단계 — OIDC 토큰 클레임 확인(OIDC 앱만 해당)

  1. Entra 관리 센터에서 앱 등록(Enterprise 애플리케이션 아님)으로 이동합니다.

  2. Claude OIDC 앱을 찾고 “토큰 구성”을 클릭합니다.

  3. 이메일 선택적 클레임을 확인합니다.

  4. SCIM 속성 매핑과 교차 참조하여 일치하는지 확인합니다.


해결

SCIM 속성 매핑 수정

SCIM 프로비저닝 앱으로 이동합니다(SSO/OIDC 앱 아님):

  1. Entra 관리 센터 → Enterprise 애플리케이션으로 이동합니다.

  2. Claude SCIM 앱을 검색합니다. 프로비저닝 섹션이 있는 앱을 찾습니다.

  3. 프로비저닝 → 프로비저닝 편집 → 속성 매핑을 클릭합니다.

  4. SCIM 속성이 emails[type eq “work”].value인 행을 찾습니다. 편집하려면 클릭합니다.

  5. 소스 속성을 SSO가 보내는 것과 일치하도록 변경합니다(일반적으로 mail).

  6. userName 매핑도 확인하고 필요한 경우 업데이트합니다.

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

전체 프로비저닝 동기화 트리거

전체 동기화 필요 — 증분은 작동하지 않습니다. 프로비저닝 주기의 전체 재시작을 트리거해야 합니다.

  1. 프로비저닝 개요 페이지로 이동합니다.

  2. 프로비저닝 재시작을 클릭합니다.

  3. 동기화가 완료될 때까지 기다립니다.

  4. 프로비저닝 로그에서 이메일이 올바른 형식으로 업데이트되었는지 확인합니다.


수정 후 정리

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

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

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

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

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

  • 향후 발생 방지: 조직의 ID 및 액세스 설정에서 “조직 생성 제한”을 활성화합니다.


확인

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

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

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

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


일반적인 문제

문제

해결책

SCIM 매핑은 업데이트되었지만 SSO 클레임은 확인되지 않음(또는 그 반대)

둘 다 업데이트해야 합니다. SCIM은 Enterprise 애플리케이션 → 프로비저닝 아래; SSO 클레임은 Single sign-on → 속성 및 클레임 또는 앱 등록 → 토큰 구성 아래.

userPrincipalName이 직원 ID 형식이며 실제 이메일이 아님

SCIM을 mail 속성을 사용하도록 전환합니다.

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

속성 매핑 변경 후 프로비저닝 재시작이 필요합니다.

OIDC 앱 이메일 클레임이 선택적 클레임으로 구성되지 않음

앱 등록 → 토큰 구성 아래에 이메일을 추가합니다.

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

불량 무료 조직 또는 고스트 계정을 찾습니다. 브라우저 쿠키를 지우고 다시 시도합니다.


지원팀에 문의할 시기

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

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

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

  • 고스트 계정 또는 불량 무료 조직 정리에 도움이 필요합니다.

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

답변이 도움되었나요?