Lewati ke konten utama

Ketidaksesuaian email Okta SSO/SCIM

Claude menggunakan email sebagai pengidentifikasi utama untuk mencocokkan login SSO dengan kursi yang disediakan. Di Okta, penyediaan SCIM dan SSO dikonfigurasi secara terpisah dan dapat menarik email dari bidang profil pengguna yang berbeda. Panduan ini menjelaskan cara mengidentifikasi dan mengatasi ketidaksesuaian.

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” — Autentikasi SSO berhasil 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 saat login.

  • Kegagalan autentikasi Claude Code — CLI Claude Code menampilkan kesalahan ketidaksesuaian email selama alur autentikasi.


Bagaimana ini terjadi

Profil pengguna Okta berisi beberapa bidang yang mewakili identitas. Penyediaan SCIM (di bawah Provisioning → To App) dan SSO SAML/OIDC (di bawah Sign On) dikonfigurasi secara independen.

Atribut Okta

Nilai tipikal

Biasanya digunakan oleh

user.login

testuser1 atau [email protected]

Pemetaan userName SCIM default; kadang-kadang NameID

user.email

Klaim email SAML/OIDC (direkomendasikan)

appuser.email

Penggantian tingkat aplikasi dari email pengguna

Pemetaan atribut tingkat aplikasi khusus

Ketidaksesuaian umum: SCIM menggunakan user.login sementara SAML mengirim user.email. Claude memerlukan kecocokan string yang tepat.

Kebingungan umum: Pemetaan atribut SCIM Okta dan pernyataan atribut SAML berada di dua tab berbeda — Provisioning → To App untuk SCIM, dan Sign On untuk SSO.


Langkah diagnostik

Langkah 1 — Konfirmasi ketidaksesuaian

  1. Periksa email SCIM: Navigasikan ke Applications → [Claude App] → Provisioning → To App → Attribute Mappings. Temukan baris email (atau userName). Kolom Value menunjukkan ekspresi Okta yang dikirim.

  2. Periksa email SSO (SAML): Buka Applications → [Claude App] → Sign On → SAML Settings → Edit → Attribute Statements. Temukan atribut email. Kolom Value menunjukkan bidang Okta mana yang ditegaskan.

  3. Periksa email SSO (OIDC): Buka Applications → [Claude App] → Sign On → OpenID Connect ID Token dan tinjau bagian Claims untuk email.

  4. Jika nilai SCIM dan SSO mereferensikan bidang Okta yang berbeda, ketidaksesuaian dikonfirmasi.

Langkah 2 — Identifikasi ruang lingkup masalah

  • Sebagian besar atau semua orang yang disediakan terpengaruh: Ini adalah masalah pemetaan atribut sistemik. Perbaikannya ada di pemetaan atribut SCIM IdP Anda.

  • Satu atau dua orang terpengaruh: Masalahnya spesifik untuk akun tersebut. Periksa profil pengguna mereka secara langsung.

Langkah 3 — Verifikasi profil pengguna Okta secara langsung

  1. Buka Directory → People → [User] → Profile.

  2. Bandingkan nilai bidang Login dan Email. Perbedaan antara bidang-bidang ini akan menghasilkan ketidaksesuaian pemetaan.


Resolusi

Selaraskan kedua pemetaan dengan bidang Okta yang sama

Perbaikan teraman adalah menggunakan user.email untuk SCIM dan SSO, karena bidang ini berisi alamat email kanonis di Okta.

  1. Perbarui pemetaan SCIM: Di Provisioning → To App → Attribute Mappings, ubah sumber email (atau userName) menjadi user.email.

  2. Perbarui klaim SSO (SAML): Di Sign On → SAML Settings → Attribute Statements, ubah nilai atribut email menjadi user.email.

  3. Perbarui klaim SSO (OIDC): Di Sign On → OpenID Connect ID Token → Claims, perbarui klaim email untuk memetakan ke user.email.

  4. Klik “Simpan.”

Paksa sinkronisasi penuh

Kritis — Sinkronisasi penuh diperlukan: Sinkronisasi inkremental tidak akan memperbarui catatan yang ada setelah Anda mengubah pemetaan atribut.

  1. Di Provisioning → To App, klik “Force Sync” untuk memicu penilaian ulang penuh semua orang yang ditugaskan.

  2. Alternatifnya, untuk orang tertentu: Provisioning → Push Users → pilih orang yang terpengaruh → Push Now.

  3. Periksa Okta System Log (Reports → System Log) untuk kesalahan penyediaan.

  4. Verifikasi nilai email yang diperbarui muncul dalam log penyediaan sebelum orang 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 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 pemberhentian penyediaan.

  • 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 penghapusan akun hantu, orang dengan email yang diperbaiki mungkin perlu diundang ulang atau disediakan ulang.

  • Cegah kejadian di masa depan: Aktifkan “Batasi pembuatan organisasi” di pengaturan Identitas dan akses organisasi Anda untuk mencegah orang yang tidak disediakan membuat akun gratis.


Verifikasi

Setelah menyelesaikan perbaikan dan pembersihan apa pun:

  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. Mereka harus mendarat langsung di ruang kerja organisasi Anda tanpa kesalahan.

  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

Admin memperbarui klaim SAML tetapi lupa pemetaan atribut SCIM (atau sebaliknya)

Keduanya harus diperbarui. Pemetaan SCIM di bawah Provisioning → To App; klaim SAML di bawah Sign On → SAML Settings.

user.login berisi nama pengguna (bukan email) untuk beberapa orang

Beralih keduanya ke user.email dan verifikasi bidang email diisi untuk semua orang.

Sinkronisasi inkremental berjalan tetapi email tidak diperbarui

Force Sync atau Push Users diperlukan setelah perubahan pemetaan atribut.

Atribut profil tingkat aplikasi (appuser.email) berbeda dari profil pengguna (user.email)

Periksa apakah pemetaan atribut tingkat aplikasi mengganti nilai profil pengguna.

Email diperbarui tetapi orang masih tidak dapat login

Cari organisasi gratis nakal atau akun hantu. Hapus cookie browser dan coba lagi. Hubungi Dukungan jika terus berlanjut.

Aplikasi OIDC dan SAML adalah aplikasi Okta terpisah untuk Claude

Beberapa organisasi mengonfigurasi keduanya. Pastikan penyelarasan atribut di kedua aplikasi.


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 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?