Lewati ke konten utama

Ketidaksesuaian email OneLogin SSO/SCIM

Claude menggunakan email sebagai pengidentifikasi utama untuk mencocokkan login SSO dengan kursi yang disediakan. Di OneLogin, penyediaan SCIM dan SSO SAML dikonfigurasi di tab terpisah dari aplikasi dan dapat mereferensikan bidang profil pengguna yang berbeda, menyebabkan ketidaksesuaian yang 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. Jika organisasi Anda memiliki pembuatan organisasi yang dibatasi (direkomendasikan), orang tersebut sepenuhnya diblokir.

  • Mendarat di akun pribadi gratis — Jika pembuatan organisasi tidak dibatasi, orang tersebut melewati organisasi Anda sepenuhnya dan membuat atau mendarat di akun pribadi gratis alih-alih kursi yang disediakan mereka.

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

Profil pengguna OneLogin berisi bidang yang berbeda untuk nama pengguna dan email, yang mungkin menyimpan nilai yang berbeda. Parameter penyediaan SCIM dan pernyataan atribut SAML dikonfigurasi secara independen dan masing-masing dapat menarik dari bidang yang berbeda:

Bidang OneLogin

Nilai tipikal

Biasanya digunakan oleh

Username

testuser1 atau [email protected]

Kadang digunakan dalam pemetaan userName SCIM

Email

Direkomendasikan untuk SCIM dan SAML

Login Name

Mungkin berbeda dari email jika SSO digunakan untuk login non-email

Konfigurasi warisan atau khusus

Bidang pengguna khusus

Atribut khusus yang ditentukan per organisasi

Pemetaan atribut lanjutan

Ketidaksesuaian umum: tab parameter SCIM memetakan atribut email ke Username (yang mungkin berupa ID karyawan atau nama pendek) sementara pernyataan atribut SAML mengirim bidang Email. Claude memerlukan kecocokan string yang tepat.

Kebingungan umum: Parameter SCIM dan pernyataan atribut SAML OneLogin berada di tab berbeda dari aplikasi yang sama — Parameters untuk SCIM dan SSO (atau Parameters dengan bidang khusus SAML) untuk SSO. Keduanya harus diperiksa dan diselaraskan.


Langkah diagnostik

Langkah 1 — Konfirmasi ketidaksesuaian

  1. Periksa email SCIM: Di portal Admin OneLogin, buka Applications → [Aplikasi Claude] → Parameters. Temukan bidang yang dipetakan ke email yang diterima Claude. Catat kolom OneLogin value — ini menunjukkan bidang pengguna mana yang dikirim.

  2. Periksa email SAML: Di aplikasi yang sama, buka tab SSO. Klik More Actions → Edit SAML Response atau periksa bagian SAML Attribute Statements. Temukan atribut untuk email dan catat bidang sumbernya.

  3. Periksa orang tertentu: Di Users → [User], bandingkan bidang Username dan Email. Jika berbeda, pemetaan apa pun yang menggunakan satu atau yang lain akan menyebabkan ketidaksesuaian.

Langkah 2 — Identifikasi cakupan 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 kemungkinan spesifik untuk akun tersebut. Periksa profil mereka secara langsung.

Langkah 3 — Tinjau nilai bidang pengguna

  1. Buka Users → [Affected User] → User Info.

  2. Periksa bidang Username dan Email.

  3. Jika Username dalam format yang tidak cocok dengan email yang valid, SCIM mungkin mengirim nilai yang tidak valid atau tidak cocok.


Resolusi

Selaraskan kedua pemetaan ke bidang Email

Bidang Email OneLogin adalah sumber paling andal untuk SCIM dan SAML, karena dirancang untuk menyimpan alamat email yang valid.

  1. Perbarui parameter SCIM: Di Applications → [Aplikasi Claude] → Parameters, temukan baris untuk atribut email yang diterima Claude. Ubah Value menjadi Email (bidang Email OneLogin).

  2. Perbarui pernyataan atribut SAML: Di tab SSO (atau Parameters untuk atribut SAML), perbarui nilai atribut email untuk menggunakan bidang Email yang sama.

  3. Klik “Save.”

Picu sinkronisasi penuh

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

  1. Di tab Provisioning aplikasi, cari opsi Re-sync atau Sync All dan jalankan.

  2. Untuk menyediakan kembali orang individual: Buka Users → [User] → Applications, temukan aplikasi Claude, dan gunakan Re-provision.

  3. Periksa log aktivitas penyediaan OneLogin untuk kesalahan.

  4. Verifikasi nilai email yang diperbarui muncul dalam log 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 secara tidak sengaja membuat akun Claude pribadi gratis. Hubungi tim Dukungan kami untuk menghapusnya.

  • Akun hantu (kursi email salah): Akun yang disediakan awalnya 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 “Restrict organization creation” 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 menyimpan nama pendek atau ID karyawan, bukan email

Alihkan SCIM untuk menggunakan bidang Email.

Atribut SAML diperbarui tetapi parameter SCIM tidak diubah

Baik tab Parameters (untuk SCIM) maupun atribut SSO/SAML harus diperbarui secara independen.

Re-sync tampaknya tidak memicu

Coba hapus dan tetapkan kembali orang yang terpengaruh dari aplikasi.

Bidang pengguna khusus dipetakan tetapi kosong untuk beberapa orang

Alihkan ke bidang Email standar.

Email diperbarui di SCIM tetapi orang masih tidak dapat login

Periksa organisasi gratis nakal atau akun hantu. Hapus cookie browser dan coba lagi.

“Invite domain not allowed” saat mencoba menambahkan kembali orang

Domain organisasi Anda mungkin tidak diverifikasi di Claude. Hubungi Dukungan.


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?