Claude menggunakan email sebagai pengidentifikasi utama untuk mencocokkan login SSO dengan kursi yang disediakan. Di Google Workspace, penyediaan otomatis SCIM dan SSO SAML dapat mengirimkan nilai email yang berbeda—terutama ketika orang memiliki alias email—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 membatasi pembuatan organisasi (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, mencegah orang terhubung ke organisasi Anda.
Bagaimana ini terjadi
Akun Google Workspace memiliki email utama dan mungkin memiliki beberapa alias. Penyediaan SCIM dan SSO SAML dikonfigurasi secara terpisah di konsol Admin Google dan dapat menarik dari bidang alamat yang berbeda:
Atribut Google | Nilai tipikal | Biasanya digunakan oleh |
| Direkomendasikan untuk SCIM dan SAML | |
Alias email | Kadang-kadang dipetakan secara keliru di SCIM | |
Bidang skema kustom | Atribut kustom yang ditentukan per organisasi | Pemetaan atribut lanjutan |
Email unit organisasi | Varian alamat yang berasal dari OU | Jarang, dalam struktur organisasi yang kompleks |
Ketidaksesuaian paling umum: SCIM dikonfigurasi untuk mengirimkan alamat alias sementara SAML mengirimkan email utama (atau sebaliknya). Karena alias dan email utama adalah string yang berbeda, Claude tidak dapat mencocokkannya. Claude memerlukan kecocokan string yang tepat.
Kebingungan umum: Di Admin Google, pengaturan penyediaan otomatis SCIM dan pemetaan atribut SAML berada di tab terpisah dalam aplikasi yang sama. Admin terkadang memperbarui satu dan melewatkan yang lain. Verifikasi kedua lokasi.
Langkah diagnostik
Langkah 1 — Konfirmasi ketidaksesuaian
Periksa email SCIM: Di konsol Admin Google, buka Aplikasi → Aplikasi web dan mobile → [Aplikasi Claude] → Penyediaan otomatis. Periksa atribut mana yang dipetakan ke bidang email yang dikirim ke Claude.
Periksa email SAML: Di aplikasi yang sama, buka bagian pemetaan atribut SAML. Temukan atribut yang dipetakan ke email dan catat sumbernya.
Periksa orang tertentu: Di Direktori → Pengguna → [Pengguna], bandingkan Email utama dengan Email alias yang terdaftar.
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 mungkin spesifik untuk akun tersebut. Periksa profil mereka secara langsung.
Langkah 3 — Periksa Name ID dalam konfigurasi SAML
Di pengaturan aplikasi, buka SAML → Detail penyedia layanan.
Konfirmasi bahwa Name ID diatur ke Informasi Dasar → Email utama.
Jika Name ID diatur ke bidang skema kustom atau alias, mungkin mengirimkan nilai yang berbeda dari SCIM.
Resolusi
Selaraskan kedua pemetaan ke primaryEmail
primaryEmail Google Workspace adalah sumber paling andal untuk SCIM dan SAML.
Perbarui penyediaan SCIM: Di Aplikasi → Aplikasi web dan mobile → [Aplikasi Claude] → Penyediaan otomatis → Pemetaan atribut, pastikan atribut email dipetakan ke primaryEmail.
Perbarui Name ID SAML: Di SAML → Detail penyedia layanan, atur Name ID ke Informasi Dasar → Email utama.
Perbarui pemetaan atribut SAML: Di langkah Pemetaan atribut, pastikan atribut email dipetakan ke Informasi Dasar → Email utama.
Simpan semua perubahan.
Picu sinkronisasi ulang 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.
Di konsol Admin Google, buka pengaturan Penyediaan otomatis aplikasi.
Sementara waktu hentikan penyediaan, lalu aktifkan kembali. Ini memicu sinkronisasi penuh semua orang yang ditugaskan.
Alternatifnya, hapus dan tambahkan kembali orang yang terpengaruh dari penugasan aplikasi untuk memaksa catatan individual mereka disediakan ulang.
Pantau log penyediaan untuk kesalahan dan konfirmasi email diperbarui agar sesuai dengan format SAML sebelum meminta orang untuk mencoba 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. 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. Membatalkan penyediaan akun hantu membebaskan kursi tersebut.
Menambahkan kembali orang yang terpengaruh: Setelah akun hantu dihapus, 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. Ini mencegah orang yang belum disediakan dari secara tidak sengaja membuat akun pribadi gratis.
Verifikasi
Periksa sampel orang yang disediakan—konfirmasi email mereka di log penyediaan cocok dengan format email yang dikirim SSO.
Minta orang yang terpengaruh untuk menghapus cookie browser untuk claude.ai, lalu masuk melalui SSO. Mereka harus mendarat langsung di ruang kerja organisasi Anda tanpa kesalahan apa pun.
Konfirmasi orang tidak membuat akun gratis—dengan pembuatan organisasi dibatasi, orang yang diblokir melihat kesalahan yang jelas daripada mendarat di akun pribadi.
Jika Claude Code terpengaruh, minta orang menjalankan kembali
claude auth login --enterprisedan konfirmasi email cocok dengan kursi yang disediakan mereka.
Masalah umum
Masalah | Solusi |
SCIM mengirimkan alias sementara SAML mengirimkan email utama | Selalu gunakan |
Name ID dalam pengaturan SAML tidak diperiksa | Bidang Name ID menentukan email yang dikirim saat login. Ini terpisah dari bagian pemetaan atribut. Periksa keduanya. |
Bidang skema kustom kosong untuk beberapa orang | Tetap gunakan atribut Google standar seperti |
Penyediaan ulang tidak dipicu secara otomatis setelah perubahan pemetaan | Anda mungkin perlu menghentikan dan mengaktifkan kembali penyediaan secara manual untuk memaksa sinkronisasi penuh. |
Email utama seseorang berubah tetapi email lama masih muncul di Claude | Sinkronisasi ulang penuh diperlukan setelah perubahan email utama. |
Email diperbarui di SCIM tetapi orang masih tidak dapat masuk | 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.
