Supabase Google Login di Web
Salin prompt setup yang berisi langkah install dan panduan markdown lengkap untuk plugin ini.
Pendahuluan
Bagian berjudul “Pendahuluan”Panduan ini membantu Anda mengintegrasikan Google Sign-In dengan Supabase Authentication di Web. Asumsi Anda sudah menyelesaikan:
- halaman Setup Google Login Web
- halaman Supabase Google Login - Setup Umum.
Implementasi
Bagian berjudul “Implementasi”Implementasi lengkapnya tersedia di aplikasi contoh supabaseAuthUtils.ts file. Panduan ini menjelaskan konsep utama dan cara menggunakannya.
Menggunakan Authentication Helper
Bagian berjudul “Menggunakan Helper Autentikasi”Panduan authenticateWithGoogleSupabase fungsi menangani seluruh alur autentikasi:
import { authenticateWithGoogleSupabase } from './supabaseAuthUtils';
const result = await authenticateWithGoogleSupabase();if (result.success) { console.log('Signed in:', result.user); // Navigate to your authenticated area} else { console.error('Error:', result.error);}Kritis: Penanganan Redirect
Bagian berjudul “Kritis: Penanganan Redirect”Kritis: Penanganan Redirect
Saat menggunakan login Google di web, Anda WAJIB memanggil fungsi apa pun dari plugin saat redirect terjadi untuk menginisialisasi plugin agar dapat menangani redirect dan menutup jendela popup. Anda bisa memanggil salah satu dari isLoggedIn() ATAU initialize() - keduanya akan memicu penanganan redirect.
Ini sangat penting agar alur popup OAuth berjalan dengan benar.
Contoh Implementasi
Bagian berjudul “Contoh Implementasi”Tambahkan ini ke komponen Anda yang menangani Google Sign-In:
import { useEffect } from 'react';import { SocialLogin } from '@capgo/capacitor-social-login';
function SupabasePage() { // Check Google login status on mount to invoke redirect handling // This doesn't serve any functional purpose in the UI but ensures // that any pending OAuth redirects are properly processed useEffect(() => { const checkGoogleLoginStatus = async () => { try { await SocialLogin.isLoggedIn({ provider: 'google' }); // We don't use the result, this is just to trigger redirect handling } catch (error) { // Ignore errors - this is just for redirect handling console.log('Google login status check completed (redirect handling)'); } };
checkGoogleLoginStatus(); }, []);
// ... rest of your component}Lihat SupabasePage.tsx untuk contoh lengkapnya.
Cara Kerjanya
Bagian berjudul “Cara Kerja”Untuk penjelasan detail mengenai alur autentikasi, termasuk pembuatan nonce, validasi JWT, dan login Supabase, lihat “Cara Kerja” di panduan General Setup.
Untuk referensi lengkap code, lihat Selesaikan bagian Referensi Code di panduan General Setup.
Lihat juga:
- SupabasePage.tsx - Contoh komponen dengan penanganan redirect
- SupabaseCreateAccountPage.tsx - Contoh halaman buat akun
Catatan Penting
Bagian berjudul “Catatan Penting”Penanganan Redirect
Bagian berjudul “Penanganan Redirect”Saat menggunakan login Google di web, Anda WAJIB memanggil fungsi apa pun dari plugin saat redirect terjadi untuk menginisialisasi plugin agar dapat menangani redirect dan menutup jendela popup. Anda bisa memanggil salah satu dari isLoggedIn() ATAU initialize() - keduanya akan memicu penanganan redirect.
Ini penting agar alur popup OAuth berfungsi dengan benar. Tanpa ini, jendela popup tidak akan tertutup setelah autentikasi.
Penanganan Nonce
Bagian berjudul “Penanganan Nonce”Implementasi nonce mengikuti pola dari dokumentasi React Native Google Sign In:
rawNoncedikirim ke SupabasesignInWithIdToken()- Supabase membuat hash dari
rawNoncedan membandingkannya dengannonceDigestyang disertakan dalam ID token dari Google Sign-In nonceDigest(hash SHA-256, hex-encoded) dikirim kenonceparameter di Google Sign-In API
Coba Lagi Otomatis
Bagian berjudul “Retry Otomatis”Implementasinya mencakup logika retry otomatis:
- Jika validasi JWT gagal pada percobaan pertama, sistem akan logout dan mencoba ulang sekali
- Ini menangani kasus di mana token yang di-cache mungkin memiliki nonce yang salah
- Jika retry juga gagal, error akan dikembalikan
Pemecahan Masalah
Bagian berjudul “Troubleshooting”Jika autentikasi gagal:
- Redirect tidak berfungsi: Pastikan Anda memanggil
isLoggedIn()saat komponen mount (lihat contoh di atas) - Audience tidak valid: Pastikan Google Client IDs Anda sudah sesuai di Google Cloud Console dan Supabase
- URL redirect yang diotorisasi: Pastikan URL redirect yang diotorisasi sudah dikonfigurasi di Google Cloud Console dan Supabase
- Nonce tidak cocok: Periksa console logs - fungsi ini akan otomatis retry, tetapi Anda bisa logout manual terlebih dahulu jika diperlukan
- Validasi token gagal: Pastikan Anda menggunakan
mode: 'online'pada pemanggilan initialize untuk mendapatkan idToken - Tinjau aplikasi contoh code sebagai referensi
Lanjutkan dari Supabase Google Login di Web
Bagian berjudul “Lanjutkan dari Supabase Google Login di Web”Jika Anda menggunakan Supabase Google Login di Web untuk merencanakan alur autentikasi dan akun, hubungkan dengan Menggunakan @capgo/capacitor-social-login untuk kapabilitas native di Menggunakan @capgo/capacitor-social-login, @capgo/capacitor-social-login untuk detail implementasi di @capgo/capacitor-social-login, @capgo/capacitor-passkey untuk detail implementasi di @capgo/capacitor-passkey, @capgo/capacitor-native-biometric untuk detail implementasi di @capgo/capacitor-native-biometric, dan Autentikasi dua faktor untuk detail implementasi di autentikasi dua faktor.