Lewati ke konten utama

Ketidaksesuaian email Ping Identity SSO/SCIM

Claude menggunakan email sebagai pengidentifikasi utama untuk mencocokkan login SSO dengan kursi yang disediakan. Produk Ping Identity (PingOne dan PingFederate) memiliki konfigurasi atribut yang fleksibel dan berlapis. Ketika penyediaan SCIM dan SSO SAML/OIDC menarik dari atribut pengguna yang berbeda, ketidaksesuaian memblokir akses.

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.

  • Mendarat di akun pribadi gratis — Jika pembuatan organisasi tidak dibatasi, orang tersebut melewati organisasi Anda sepenuhnya.

  • “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

Produk Ping Identity memungkinkan pemetaan atribut granular di berbagai tingkat (direktori, adaptor IdP, konektor SP, aplikasi). SCIM dan SSO masing-masing dapat melintasi jalur berbeda melalui lapisan ini, menghasilkan nilai email yang berbeda mencapai Claude:

Atribut Ping

Nilai tipikal

Biasanya digunakan oleh

email (PingOne)

Direkomendasikan untuk SCIM dan SAML/OIDC

username (PingOne)

testuser1 atau [email protected]

Pengidentifikasi login default; mungkin berbeda dari email

Atribut adaptor IdP (PingFederate)

Bervariasi menurut jenis adaptor (LDAP, HTML Form, dll.)

Sumber identitas PingFederate

Atribut LDAP mail

Email bersumber direktori di PingFederate

LDAP sAMAccountName atau uid

Mungkin ID karyawan atau nama pengguna pendek

Kadang-kadang dipetakan ke email secara keliru

Atribut populasi kustom

Bidang kustom yang ditentukan per lingkungan

Konfigurasi PingOne tingkat lanjut

Claude memerlukan kecocokan string yang tepat antara email yang disediakan SCIM dan email yang ditegaskan SSO.

Catatan PingFederate: Sistem kontrak atribut PingFederate sangat kompleks—email dapat melewati berbagai lapisan (LDAP → adaptor IdP → kontrak adaptor → konektor SP → pernyataan). Ketidaksesuaian di lapisan mana pun akan menyebabkan nilai yang salah mencapai Claude. Lacak nilainya dari awal hingga akhir.


Langkah diagnostik

Langkah 1 — Konfirmasi ketidaksesuaian (PingOne)

  1. Periksa pemetaan atribut SCIM: Di Admin PingOne, buka Connections → Applications → [aplikasi Claude] → Attribute Mappings. Temukan atribut yang dipetakan ke emails[primary].value atau email. Catat atribut pengguna PingOne yang digunakan sebagai sumber.

  2. Periksa pemetaan atribut SSO: Di aplikasi yang sama, buka tab SAML atau OIDC dan temukan atribut atau klaim yang dipetakan ke email. Catat atribut sumbernya.

  3. Jika SCIM dan SSO mereferensikan atribut PingOne yang berbeda, Anda telah mengonfirmasi ketidaksesuaian.

Langkah 1 (alternatif) — Konfirmasi ketidaksesuaian (PingFederate)

  1. Di konsol Admin PingFederate, temukan SP Connection untuk Claude.

  2. Di Attribute Contract Fulfillment, temukan atribut email dan lacak sumbernya kembali ke adaptor IdP atau penyimpanan data LDAP.

  3. Secara terpisah, periksa konektor penyediaan SCIM atau saluran penyediaan keluar untuk Claude dan lacak sumber atribut email yang dikirim.

  4. Jika kedua pelacakan mengarah ke atribut direktori yang berbeda, Anda telah mengonfirmasi ketidaksesuaian.

Langkah 2 — Identifikasi ruang lingkup masalah

  • Jika sebagian besar atau semua orang yang disediakan berbagi ketidaksesuaian format email yang sama, ini adalah masalah pemetaan atribut sistemik. Perbaikannya ada di pemetaan atribut SCIM IdP Anda.

  • Jika hanya satu atau dua orang yang terpengaruh, masalahnya mungkin spesifik untuk akun tersebut. Periksa profil mereka secara langsung.

Langkah 3 — Periksa nilai atribut untuk orang tertentu

  1. PingOne: Buka Identities → Users → [User] dan bandingkan nilai bidang Username dan Email.

  2. PingFederate dengan LDAP: Periksa catatan LDAP orang tersebut dan bandingkan mail, userPrincipalName, sAMAccountName, dan atribut lain apa pun yang digunakan dalam pemetaan adaptor Anda.


Resolusi

PingOne — Selaraskan kedua pemetaan dengan atribut email

  1. Di Connections → Applications → [aplikasi Claude], buka Attribute Mappings.

  2. Untuk SCIM: Pastikan emails[primary].value dipetakan ke atribut Email Address PingOne.

  3. Untuk SAML/OIDC: Pastikan atribut atau klaim email juga dipetakan ke atribut Email Address PingOne.

  4. Simpan perubahan.

PingFederate — Selaraskan kontrak atribut di semua lapisan

  1. Di SP Connection untuk Claude, buka Attribute Contract Fulfillment.

  2. Temukan atribut email. Pastikan sumbernya adalah atribut LDAP atau penyimpanan data yang sama yang digunakan di saluran penyediaan keluar SCIM Anda.

  3. Jika menggunakan adaptor IdP kustom, pastikan kontrak adaptor mencakup atribut email kanonik dan dipetakan dengan benar melalui ke koneksi SP.

  4. Perbarui penyediaan SCIM untuk menggunakan atribut sumber yang sama.

Picu sinkronisasi penuh

Kritis — Sinkronisasi penuh diperlukan: Sinkronisasi inkremental tidak akan memperbarui catatan yang ada setelah Anda mengubah pemetaan atribut. Anda harus memicu restart penuh dari siklus penyediaan.

  1. PingOne: Di pengaturan penyediaan aplikasi, picu siklus penyediaan penuh. Anda mungkin perlu menonaktifkan dan mengaktifkan kembali penyediaan untuk memaksa push ulang lengkap.

  2. PingFederate: Picu sinkronisasi penuh di saluran penyediaan keluar Anda. Periksa log penyediaan Anda untuk mengonfirmasi nilai email yang diperbarui sedang dikirim.

  3. Verifikasi bahwa nilai email yang diperbarui muncul dalam log penyediaan sebelum meminta orang untuk mencoba login lagi.


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 secara tidak sengaja membuat akun Claude pribadi gratis. Hubungi tim Dukungan kami untuk menghapusnya.

  • Akun hantu (kursi email salah): Hubungi tim Dukungan kami untuk membatalkan penyediaan ini.

  • Ketersediaan kursi: Jika akun hantu menempati semua kursi yang dikontrak, login baru akan gagal. Hubungi tim Dukungan kami.

  • Menambahkan kembali orang yang terpengaruh: Setelah akun hantu dihapus, orang 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 dalam log penyediaan cocok dengan format email yang dikirim SSO.

  2. Minta orang yang terpengaruh untuk menghapus cookie browser untuk claude.ai, lalu login melalui SSO.

  3. Konfirmasi orang tidak membuat akun gratis.

  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

Bidang username PingOne digunakan alih-alih email

Ubah pemetaan SCIM ke atribut Email Address PingOne.

Ketidaksesuaian atribut PingFederate di seluruh lapisan kontrak

Lacak atribut email dari awal hingga akhir: sumber LDAP → adaptor IdP → kontrak adaptor → konektor SP → pernyataan.

LDAP sAMAccountName atau uid dipetakan sebagai sumber email

Gunakan atribut LDAP mail sebagai gantinya.

Sinkronisasi penyediaan inkremental tidak memperbarui catatan yang ada

Sinkronisasi ulang penuh diperlukan setelah mengubah pemetaan atribut.

Kontrak atribut diperbarui di PingFederate tetapi konektor SCIM tidak diperbarui

Koneksi SP dan saluran penyediaan SCIM keluar harus diperbarui secara independen.

Email diperbarui di SCIM tetapi orang masih tidak dapat login

Periksa 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 Anda ketika:

  • Atribut SCIM dan SSO tampak identik tetapi orang masih tidak dapat mengakses kursi mereka.

  • Anda memerlukan konfirmasi email yang dicatat Claude 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?