Lewati ke konten utama

Ketidaksesuaian email Google Workspace SSO/SCIM

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

primaryEmail

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

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

  2. Periksa email SAML: Di aplikasi yang sama, buka bagian pemetaan atribut SAML. Temukan atribut yang dipetakan ke email dan catat sumbernya.

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

  1. Di pengaturan aplikasi, buka SAML → Detail penyedia layanan.

  2. Konfirmasi bahwa Name ID diatur ke Informasi Dasar → Email utama.

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

  1. Perbarui penyediaan SCIM: Di Aplikasi → Aplikasi web dan mobile → [Aplikasi Claude] → Penyediaan otomatis → Pemetaan atribut, pastikan atribut email dipetakan ke primaryEmail.

  2. Perbarui Name ID SAML: Di SAML → Detail penyedia layanan, atur Name ID ke Informasi Dasar → Email utama.

  3. Perbarui pemetaan atribut SAML: Di langkah Pemetaan atribut, pastikan atribut email dipetakan ke Informasi Dasar → Email utama.

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

  1. Di konsol Admin Google, buka pengaturan Penyediaan otomatis aplikasi.

  2. Sementara waktu hentikan penyediaan, lalu aktifkan kembali. Ini memicu sinkronisasi penuh semua orang yang ditugaskan.

  3. Alternatifnya, hapus dan tambahkan kembali orang yang terpengaruh dari penugasan aplikasi untuk memaksa catatan individual mereka disediakan ulang.

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

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

  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 tanpa kesalahan apa pun.

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

  4. Jika Claude Code terpengaruh, minta orang menjalankan kembali claude auth login --enterprise dan konfirmasi email cocok dengan kursi yang disediakan mereka.


Masalah umum

Masalah

Solusi

SCIM mengirimkan alias sementara SAML mengirimkan email utama

Selalu gunakan primaryEmail untuk keduanya.

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

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.

Apakah pertanyaan Anda terjawab?