Lewati ke konten utama

Ketidaksesuaian email Microsoft Entra ID SSO/SCIM

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

userPrincipalName

[email protected] (mungkin format ID karyawan)

Pemetaan userName SCIM default

mail

[email protected] (email standar)

Klaim email OIDC / SAML

proxyAddresses

Alamat utama Exchange / M365

otherMails

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

  1. 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.

  2. 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.

  3. 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)

  1. Di Pusat Admin Entra, buka Pendaftaran Aplikasi (bukan Aplikasi Enterprise).

  2. Temukan aplikasi Claude OIDC dan klik “Konfigurasi Token.”

  3. Periksa klaim email opsional.

  4. 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:

  1. Buka Pusat Admin Entra → Aplikasi Enterprise.

  2. Cari aplikasi Claude SCIM. Cari aplikasi dengan bagian Penyediaan.

  3. Klik Penyediaan → Edit penyediaan → Pemetaan atribut.

  4. Temukan baris di mana atribut SCIM adalah emails[type eq “work”].value. Klik untuk mengedit.

  5. Ubah Atribut Sumber agar sesuai dengan apa yang SSO kirim — biasanya mail.

  6. Juga periksa pemetaan userName dan perbarui jika diperlukan.

  7. Klik “Simpan.”

Picu sinkronisasi penyediaan penuh

Sinkronisasi penuh diperlukan — inkremental tidak akan berfungsi. Anda harus memicu restart penuh dari siklus penyediaan.

  1. Buka halaman ikhtisar Penyediaan.

  2. Klik Restart penyediaan.

  3. Tunggu sinkronisasi selesai.

  4. 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

  1. Periksa sampel orang yang disediakan—konfirmasi email mereka di log penyediaan cocok dengan format email yang SSO kirim.

  2. Minta orang yang terpengaruh untuk menghapus cookie browser untuk claude.ai, lalu masuk melalui SSO. Mereka harus mendarat langsung di ruang kerja organisasi Anda.

  3. Konfirmasi orang tidak membuat akun gratis—dengan pembuatan organisasi dibatasi, orang yang diblokir melihat kesalahan yang jelas alih-alih mendarat di akun pribadi.

  4. Jika Claude Code terpengaruh, minta orang tersebut menjalankan kembali claude auth login --enterprise dan 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.

Apakah pertanyaan Anda terjawab?