Memecahkan masalah akun duplikat saat mengubah email

Panduan ini membantu Anda memecahkan masalah dan mengatasi akun pengguna duplikat yang dibuat Looker saat alamat email utama pengguna yang ada berubah di Penyedia Identitas (IdP), seperti Azure Active Directory (Azure AD).

Sebelum mulai memecahkan masalah, Anda harus menentukan apakah instance Anda adalah instance Looker (asli) (dihosting atau dihosting sendiri) atau instance Looker (Google Cloud core), karena keduanya mendukung opsi penggabungan pengguna yang berbeda:

  • Looker (asli): Mendukung kredensial email dan sandi lokal. Opsi ini memungkinkan Anda menggabungkan pengguna dengan pencocokan email saat ID unik IdP berubah.
  • Looker (Google Cloud core): Tidak mendukung login email dan sandi lokal atau kredensial email. Oleh karena itu, Anda tidak dapat menggabungkan pengguna menggunakan opsi kredensial email dan sandi di Looker (Google Cloud core).

Instance Looker (asli)

Gunakan pohon keputusan berikut untuk memecahkan masalah perubahan email di instance Looker (asli):

Bagian berikut menjelaskan skenario dalam pohon secara lebih mendetail.

Mengonfigurasi setelan penyedia identitas

Untuk mencegah akun duplikat saat alamat email pengguna berubah, Anda dapat mengonfigurasi IdP untuk menegaskan ID unik yang tidak dapat diubah:

  1. Di IdP Anda (seperti Azure AD), temukan setelan pemetaan ID unik (misalnya, atribut Unique User Identifier (Name ID) untuk SAML atau klaim sub untuk OIDC).
  2. Konfigurasi atribut ini untuk dipetakan ke atribut pengguna yang tidak dapat diubah (seperti ID karyawan atau UUID database), bukan alamat email yang dapat diubah.
  3. Simpan konfigurasi. Karena ID unik tetap konstan saat alamat email berubah, Looker akan mengenali pengguna yang ada dan otomatis memperbarui emailnya pada login berikutnya tanpa membuat akun duplikat.

Mencegah duplikat

Jika Anda menggunakan alamat email yang dapat diubah sebagai ID unik di Looker (asli), dan Anda tidak dapat mengubahnya menjadi atribut yang tidak dapat diubah, Anda harus mengikuti langkah-langkah berikut untuk mengonfigurasi Looker agar menggabungkan pengguna berdasarkan pencocokan email:

  1. Di panel Admin Looker, buka Admin > SAML atau Admin > OpenID Connect.
  2. Buka opsi Merge Users Using dan centang kotak untuk Looker Email/Password.
  3. Sebelum pengguna login dengan alamat email barunya, Anda harus membuat kredensial email Looker di akun pengguna yang ada yang cocok dengan alamat email baru. Gunakan endpoint Looker API create_user_credentials_email: POST /api/4.0/users/<var>USER_ID</var>/credentials_email Tentukan alamat email baru di isi permintaan.
  4. Minta pengguna untuk login. Looker akan mencocokkan email baru yang dideklarasikan oleh IdP dengan kredensial email yang telah dibuat sebelumnya dan menggabungkan akunnya.

Membersihkan duplikat

Jika alamat email sudah berubah dan akun pengguna duplikat ada, ikuti langkah-langkah berikut untuk membersihkan dan menggabungkan akun:

  1. Di panel Admin Looker, buka Admin > Users dan identifikasi akun asli pengguna dan akun duplikat.
  2. Tentukan apakah akun duplikat memiliki konten buatan pengguna atau jadwal yang perlu Anda pertahankan. Jika ya, ikuti langkah-langkah di bagian Memigrasikan konten duplikat.
  3. Di setelan SAML atau OIDC Looker, pastikan Merge Users Using telah mengaktifkan Looker Email/Password.
  4. Hapus akun pengguna duplikat.
  5. Di Looker API, buat kredensial email Looker di akun pengguna asli yang menggunakan alamat email baru: POST /api/4.0/users/<var>USER_ID</var>/credentials_email
  6. Minta pengguna untuk login menggunakan SAML atau OIDC. Looker akan menggabungkan kredensial login mereka ke akun pengguna asli.

Memigrasikan konten duplikat

Jika akun duplikat berisi konten buatan pengguna, item folder pribadi, Look, dasbor, atau jadwal, Anda dapat memigrasikannya ke akun asli sebelum menghapus duplikat:

  1. Gunakan Looker API untuk mengambil daftar konten dan jadwal yang terkait dengan ID pengguna duplikat.
  2. Panggil endpoint update (seperti update_dashboard, update_look, atau update_schedule_plan) untuk mengubah pemilik resource ini ke ID pengguna asli.
  3. Atau, Anda dapat menggunakan alat seperti Admin Power Pack open source Looker untuk melakukan migrasi massal konten pengguna.
  4. Setelah Anda mentransfer konten, lanjutkan dengan menghapus akun pengguna duplikat.

Instance Looker (Google Cloud core)

Looker (Google Cloud core) tidak mendukung kredensial email atau penggabungan email dan sandi. Gunakan pohon keputusan berikut untuk menangani perubahan email di Looker (Google Cloud core):

Bagian berikut menjelaskan skenario dalam pohon secara lebih mendetail.

Langkah-langkah pra-migrasi

Jika Anda bersiap untuk bermigrasi dari instance Looker (asli) ke Looker (Google Cloud core), Anda harus mengikuti langkah-langkah berikut untuk mengonversi pengguna ke metode autentikasi yang didukung Core (seperti Google OAuth) terlebih dahulu:

  1. Aktifkan Google OAuth di instance Looker (asli).
  2. Aktifkan Merge Users Using dengan Looker Email/Password diaktifkan di setelan Google OAuth.
  3. Minta semua pengguna untuk login menggunakan Google OAuth di instance Looker (asli) untuk menggabungkan akun mereka sebelum migrasi.
  4. Lakukan migrasi ke Looker (Google Cloud core).

Langkah-langkah pascamigrasi

Jika migrasi ke Looker (Google Cloud core) telah selesai dan akun duplikat masih ada, lakukan salah satu tugas berikut:

  • Jika instance Looker (asli) masih dapat diakses: Hubungi Google Cloud Dukungan untuk memulihkan instance, lakukan langkah-langkah penggabungan Google OAuth di instance asli, lalu lakukan kembali migrasi ke Looker (Google Cloud core).
  • Jika instance Looker (asli) tidak dapat diakses: Anda harus memigrasikan konten buatan pengguna secara manual menggunakan skrip Looker API dari akun lama pengguna ke akun baru mereka, lalu menghapus akun lama atau duplikat.

Peninjauan dan dukungan akhir

Jika Anda masih tidak dapat mengatasi masalah akun duplikat, hubungi Dukungan.