Claude menggunakan email sebagai pengidentifikasi utama untuk mencocokkan login SSO dengan kursi yang disediakan. Di Microsoft Entra ID, penyediaan SCIM dan autentikasi SSO dikonfigurasi di tempat terpisah dan dapat menarik email dari atribut pengguna yang berbeda—menyebabkan ketidaksesuaian yang memblokir akses. Panduan ini menjelaskan cara mengidentifikasi masalah, memperbaiki pemetaan atribut, dan membersihkan efek samping apa pun.
Berlaku untuk: Paket Enterprise dan organisasi Console yang menggunakan penyediaan SCIM. Paket Team tidak memiliki penyediaan SCIM, jadi skenario ketidaksesuaian ini tidak berlaku — lihat Siapkan penyediaan JIT atau SCIM untuk mengetahui apa yang tersedia di setiap paket.
Gejala
Orang mungkin mengalami satu atau lebih hal berikut saat mencoba mengakses organisasi Anda melalui SSO:
“Pembuatan akun diblokir” — Orang tersebut melakukan autentikasi melalui SSO tetapi Claude tidak dapat menemukan akun yang disediakan yang cocok. Jika pembuatan organisasi dibatasi (direkomendasikan), orang tersebut sepenuhnya diblokir.
Mendarat di akun pribadi gratis — Jika pembuatan organisasi tidak dibatasi, orang tersebut melewati organisasi Anda dan membuat atau mendarat di akun pribadi gratis.
“Periksa akun mana yang Anda masuki” ketidaksesuaian — Panggilan balik SSO menampilkan email yang berbeda dari yang dimasukkan orang tersebut saat login.
Kegagalan autentikasi Claude Code — CLI Claude Code menampilkan kesalahan ketidaksesuaian email selama alur autentikasi.
Bagaimana ini terjadi
Akun pengguna Microsoft Entra ID memiliki beberapa atribut mirip email yang dapat menampung nilai berbeda. Penyediaan SCIM dan autentikasi SSO dikonfigurasi di area admin terpisah dan masing-masing dapat menarik dari atribut yang berbeda:
Atribut Entra | Nilai tipikal | Biasanya digunakan oleh |
|
| Pemetaan userName SCIM default |
|
| Klaim email OIDC / SAML |
|
| Alamat utama Exchange / M365 |
| Mungkin berisi alias atau alamat sekunder | Email kontak alternatif |
Ketidaksesuaian terjadi ketika SCIM menarik email dari satu atribut sementara SSO mengirim email dari atribut lain. Bahkan perbedaan halus memblokir akses—Claude memerlukan kecocokan string yang tepat.
Kebingungan umum: Entra memiliki dua area admin terpisah. Aplikasi penyediaan SCIM berada di bawah Aplikasi Enterprise (istilah Microsoft untuk aplikasi terintegrasi—tidak terkait dengan paket Claude Anda). Aplikasi SSO/OIDC berada di bawah Pendaftaran Aplikasi. Admin IT sering kali menavigasi ke lokasi yang salah.
Langkah diagnostik
Langkah 1 — Konfirmasi ketidaksesuaian
Periksa email SCIM: Di Pusat Admin Entra → Aplikasi Enterprise → [Aplikasi Claude SCIM] → Penyediaan → Log penyediaan, temukan orang yang baru disediakan dan periksa Atribut yang Dimodifikasi. Nilai yang dipetakan ke emails[type eq “work”].value adalah apa yang SCIM kirim ke Claude.
Periksa email SSO: Di Aplikasi Enterprise → [Aplikasi Claude] → Masuk tunggal → Atribut & Klaim, temukan klaim email. Untuk aplikasi OIDC, periksa Pendaftaran Aplikasi → [Aplikasi Claude] → Konfigurasi Token.
Jika dua atribut sumber menunjuk ke bidang berbeda, Anda telah mengonfirmasi ketidaksesuaian.
Langkah 2 — Identifikasi cakupan
Jika sebagian besar atau semua orang yang disediakan berbagi ketidaksesuaian format yang sama, ini adalah masalah pemetaan atribut sistemik. Perbaikannya ada di konfigurasi pemetaan atribut SCIM.
Jika hanya satu atau dua orang yang terpengaruh, periksa profil pengguna mereka langsung di Entra.
Langkah 3 — Periksa klaim token OIDC (hanya aplikasi OIDC)
Di Pusat Admin Entra, buka Pendaftaran Aplikasi (bukan Aplikasi Enterprise).
Temukan aplikasi Claude OIDC dan klik “Konfigurasi Token.”
Periksa klaim email opsional.
Referensi silang dengan pemetaan atribut SCIM Anda untuk mengonfirmasi apakah keduanya cocok.
Resolusi
Perbaiki pemetaan atribut SCIM
Navigasikan ke aplikasi penyediaan SCIM — bukan aplikasi SSO/OIDC:
Buka Pusat Admin Entra → Aplikasi Enterprise.
Cari aplikasi Claude SCIM. Cari aplikasi dengan bagian Penyediaan.
Klik Penyediaan → Edit penyediaan → Pemetaan atribut.
Temukan baris di mana atribut SCIM adalah emails[type eq “work”].value. Klik untuk mengedit.
Ubah Atribut Sumber agar sesuai dengan apa yang SSO kirim — biasanya mail.
Juga periksa pemetaan userName dan perbarui jika diperlukan.
Klik “Simpan.”
Picu sinkronisasi penyediaan penuh
Sinkronisasi penuh diperlukan — inkremental tidak akan berfungsi. Anda harus memicu restart penuh dari siklus penyediaan.
Buka halaman ikhtisar Penyediaan.
Klik Restart penyediaan.
Tunggu sinkronisasi selesai.
Verifikasi di log penyediaan bahwa email telah diperbarui ke format yang benar.
Pembersihan pasca-perbaikan
Setelah memperbaiki pemetaan atribut dan menyelesaikan sinkronisasi penuh:
Akun gratis nakal: Jika pembuatan organisasi tidak dibatasi sebelum perbaikan, beberapa orang mungkin telah membuat akun Claude pribadi gratis. Hubungi tim Dukungan kami untuk penghapusan.
Akun hantu (kursi email salah): Akun yang awalnya disediakan dengan email yang salah mungkin masih ada di organisasi Anda, menempati kursi yang tidak pernah dapat digunakan. Hubungi tim Dukungan kami untuk membatalkan penyediaan ini.
Ketersediaan kursi: Jika akun hantu menempati semua kursi yang dikontrak, login baru akan gagal dengan kesalahan kehabisan kursi bahkan setelah pemetaan diperbaiki.
Menambahkan kembali orang yang terpengaruh: Setelah akun hantu dihapus, orang dengan email yang diperbaiki mungkin perlu diundang kembali atau disediakan kembali.
Cegah kejadian di masa depan: Aktifkan “Batasi pembuatan organisasi” di pengaturan Identitas dan akses organisasi Anda.
Verifikasi
Periksa sampel orang yang disediakan—konfirmasi email mereka di log penyediaan cocok dengan format email yang SSO kirim.
Minta orang yang terpengaruh untuk menghapus cookie browser untuk claude.ai, lalu masuk melalui SSO. Mereka harus mendarat langsung di ruang kerja organisasi Anda.
Konfirmasi orang tidak membuat akun gratis—dengan pembuatan organisasi dibatasi, orang yang diblokir melihat kesalahan yang jelas alih-alih mendarat di akun pribadi.
Jika Claude Code terpengaruh, minta orang tersebut menjalankan kembali
claude auth login --enterprisedan konfirmasi email cocok dengan kursi yang disediakan mereka.
Masalah umum
Masalah | Solusi |
Pemetaan SCIM diperbarui tetapi klaim SSO tidak diperiksa (atau sebaliknya) | Keduanya harus diperbarui. SCIM di bawah Aplikasi Enterprise → Penyediaan; klaim SSO di bawah Masuk tunggal → Atribut & Klaim atau Pendaftaran Aplikasi → Konfigurasi Token. |
userPrincipalName dalam format ID karyawan, bukan email asli | Alihkan SCIM untuk menggunakan atribut mail sebagai gantinya. |
Sinkronisasi inkremental berjalan tetapi email tidak diperbarui | Restart penyediaan diperlukan setelah perubahan pemetaan atribut. |
Klaim email aplikasi OIDC tidak dikonfigurasi sebagai klaim opsional | Tambahkan email di bawah Pendaftaran Aplikasi → Konfigurasi Token. |
Email diperbarui tetapi orang masih tidak dapat masuk | Cari organisasi gratis nakal atau akun hantu. Hapus cookie browser dan coba lagi. |
Kapan menghubungi Dukungan
Hubungi tim Dukungan kami dengan domain organisasi Anda, email orang yang terpengaruh, dan tangkapan layar pemetaan atribut saat:
Atribut SCIM dan SSO tampak identik tetapi orang masih tidak dapat mengakses kursi mereka.
Anda memerlukan konfirmasi email yang Claude catat selama penyediaan SCIM untuk orang tertentu.
Anda memerlukan bantuan membersihkan akun hantu atau organisasi gratis nakal.
Orang mengalami kesalahan kehabisan kursi meskipun ada kursi yang dikontrak tersedia.
