Langsung ke konten

Supabase Google Login di Web

GitHub

Panduan ini membantu Anda mengintegrasikan Google Sign-In dengan Supabase Authentication di Web. Asumsi Anda sudah menyelesaikan:

Implementasi lengkapnya tersedia di aplikasi contoh supabaseAuthUtils.ts file. Panduan ini menjelaskan konsep utama dan cara menggunakannya.

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

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.

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.

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:

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.

Implementasi nonce mengikuti pola dari dokumentasi React Native Google Sign In:

  • rawNonce dikirim ke Supabase signInWithIdToken()
  • Supabase membuat hash dari rawNonce dan membandingkannya dengan nonceDigest yang disertakan dalam ID token dari Google Sign-In
  • nonceDigest (hash SHA-256, hex-encoded) dikirim ke nonce parameter di Google Sign-In API

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

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

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.