메인 콘텐츠로 건너뛰기

Google Workspace SSO/SCIM 이메일 불일치

Claude는 이메일을 기본 식별자로 사용하여 SSO 로그인을 프로비저닝된 시트와 일치시킵니다. Google Workspace에서 SCIM 자동 프로비저닝과 SAML SSO는 특히 사람들이 이메일 별칭을 가지고 있을 때 서로 다른 이메일 값을 보낼 수 있으며, 이로 인해 액세스를 차단하는 불일치가 발생합니다.

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


증상

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

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

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

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

  • Claude Code 인증 실패 — Claude Code CLI는 인증 흐름 중에 이메일 불일치 오류를 표시하여 사람이 조직에 연결하지 못하도록 합니다.


이것이 발생하는 방식

Google Workspace 계정에는 기본 이메일이 있고 여러 별칭이 있을 수 있습니다. SCIM 프로비저닝과 SAML SSO는 Google Admin 콘솔에서 별도로 구성되며 다른 주소 필드에서 가져올 수 있습니다:

Google 속성

일반적인 값

일반적으로 사용되는 대상

primaryEmail

SCIM 및 SAML 모두에 권장

이메일 별칭

SCIM에서 실수로 매핑되는 경우가 있음

사용자 정의 스키마 필드

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

고급 속성 매핑

조직 단위 이메일

OU 파생 주소 변형

복잡한 조직 구조에서 드물게 발생

가장 일반적인 불일치: SCIM은 별칭 주소를 보내도록 구성되고 SAML은 기본 이메일을 보냅니다(또는 그 반대). 별칭과 기본 이메일은 다른 문자열이므로 Claude는 이들을 일치시킬 수 없습니다. Claude는 정확한 문자열 일치가 필요합니다.

일반적인 혼동: Google Admin에서 SCIM 자동 프로비저닝 설정과 SAML 속성 매핑은 동일한 앱 내의 별도 탭에 있습니다. 관리자가 하나를 업데이트하고 다른 하나를 놓치는 경우가 있습니다. 두 위치를 모두 확인하세요.


진단 단계

1단계 — 불일치 확인

  1. SCIM 이메일 확인: Google Admin 콘솔에서 앱 → 웹 및 모바일 앱 → [Claude 앱] → 자동 프로비저닝으로 이동합니다. Claude로 전송되는 이메일 필드에 매핑된 속성을 확인합니다.

  2. SAML 이메일 확인: 동일한 앱에서 SAML 속성 매핑 섹션으로 이동합니다. 이메일에 매핑된 속성을 찾고 해당 소스를 기록합니다.

  3. 특정 사람 확인: 디렉토리 → 사용자 → [사용자]에서 기본 이메일을 나열된 별칭 이메일과 비교합니다.

2단계 — 문제의 범위 파악

  • 대부분 또는 모든 프로비저닝된 사람이 동일한 이메일 형식 불일치를 공유하면 이는 체계적인 속성 매핑 문제입니다. 해결책은 IdP의 SCIM 속성 매핑에 있습니다.

  • 한두 명만 영향을 받으면 문제는 해당 계정에만 해당할 가능성이 높습니다. 해당 프로필을 직접 확인하세요.

3단계 — SAML 구성에서 Name ID 확인

  1. 앱 설정에서 SAML → 서비스 공급자 세부 정보로 이동합니다.

  2. Name ID가 기본 정보 → 기본 이메일로 설정되어 있는지 확인합니다.

  3. Name ID가 사용자 정의 스키마 필드 또는 별칭으로 설정되면 SCIM과 다른 값을 보낼 수 있습니다.


해결

두 매핑을 primaryEmail에 정렬

Google Workspace의 primaryEmail은 SCIM과 SAML 모두에 가장 안정적인 소스입니다.

  1. SCIM 프로비저닝 업데이트: 앱 → 웹 및 모바일 앱 → [Claude 앱] → 자동 프로비저닝 → 속성 매핑에서 이메일 속성이 primaryEmail에 매핑되는지 확인합니다.

  2. SAML Name ID 업데이트: SAML → 서비스 공급자 세부 정보에서 Name ID를 기본 정보 → 기본 이메일로 설정합니다.

  3. SAML 속성 매핑 업데이트: 속성 매핑 단계에서 이메일 속성이 기본 정보 → 기본 이메일에 매핑되는지 확인합니다.

  4. 모든 변경 사항을 저장합니다.

전체 재동기화 트리거

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

  1. Google Admin 콘솔에서 앱의 자동 프로비저닝 설정으로 이동합니다.

  2. 프로비저닝을 일시적으로 일시 중단한 후 다시 활성화합니다. 이렇게 하면 할당된 모든 사람의 전체 동기화가 트리거됩니다.

  3. 또는 앱 할당에서 영향을 받은 사람을 제거했다가 다시 추가하여 개별 레코드를 강제로 재프로비저닝합니다.

  4. 프로비저닝 로그에서 오류를 모니터링하고 이메일이 SAML 형식과 일치하도록 업데이트되었는지 확인한 후 사람들에게 다시 시도하도록 요청합니다.


수정 후 정리

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

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

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

  • 시트 가용성: 유령 계정이 모든 계약된 시트를 차지하고 있으면 새 로그인이 시트 부족 오류로 실패합니다. 유령 계정을 프로비저닝 해제하면 해당 시트가 해제됩니다.

  • 영향을 받은 사람 다시 추가: 유령 계정이 제거된 후 수정된 이메일을 가진 사람들을 다시 초대하거나 재프로비저닝해야 할 수 있습니다.

  • 향후 발생 방지: 조직의 ID 및 액세스 설정에서 “조직 생성 제한”을 활성화합니다. 이렇게 하면 아직 프로비저닝되지 않은 사람들이 실수로 무료 개인 계정을 생성하는 것을 방지합니다.


확인

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

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

  3. 사람들이 무료 계정을 생성하지 않는지 확인하세요. 조직 생성이 제한되면 차단된 사람들은 개인 계정에 도착하는 대신 명확한 오류를 봅니다.

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


일반적인 문제

문제

해결책

SCIM은 별칭을 보내고 SAML은 기본 이메일을 보냄

항상 둘 다에 primaryEmail을 사용하세요.

SAML 설정의 Name ID를 확인하지 않음

Name ID 필드는 로그인 시 전송되는 이메일을 결정합니다. 이는 속성 매핑 섹션과 별개입니다. 둘 다 확인하세요.

일부 사람의 사용자 정의 스키마 필드가 비어 있음

primaryEmail과 같은 표준 Google 속성을 사용하세요.

매핑 변경 후 재프로비저닝이 자동으로 트리거되지 않음

전체 동기화를 강제하기 위해 프로비저닝을 수동으로 일시 중단했다가 다시 활성화해야 할 수 있습니다.

누군가의 기본 이메일이 변경되었지만 이전 이메일이 Claude에 여전히 나타남

기본 이메일 변경 후 전체 재동기화가 필요합니다.

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

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


지원팀에 문의할 시기

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

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

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

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

  • 사용 가능한 계약된 시트가 있음에도 불구하고 사람들이 시트 부족 오류를 받고 있습니다.

답변이 도움되었나요?