Langsung ke konten

Supabase Google Login - Setup Umum

GitHub

Panduan ini akan membantu Anda mengintegrasikan Google Sign-In dengan Supabase Authentication menggunakan plugin Capacitor Social Login. Setup ini memungkinkan Anda menggunakan native Google Sign-In di platform mobile sambil memanfaatkan Supabase Auth untuk autentikasi backend.

Sebelum memulai, pastikan Anda sudah:

  1. Membuat proyek Supabase

  2. Baca Setup Umum Google Login panduan setup kredensial Google OAuth

  3. Ikuti panduan spesifik platform masing-masing untuk setup kredensial Google OAuth pada platform target Anda:

Mengaktifkan provider Google OAuth di Supabase

Bagian berjudul “Mengaktifkan provider Google OAuth di Supabase”
  1. Buka Dashboard Supabase

  2. Klik proyek Anda

    Pemilih Proyek Supabase
  3. Silakan buka Authentication menu

    Menu Autentikasi Supabase
  4. Klik pada Providers tab

    Tab Provider Supabase
  5. Temukan Google provider

    Supabase Google Provider
  6. Aktifkan provider

    Aktifkan Supabase Google Provider
  7. Tambahkan client ID untuk platform yang akan digunakan

    Supabase Google Provider Tambah Client ID
  8. Klik pada Save tombol

    Simpan Supabase Google Provider

Selesai, Anda sekarang telah mengaktifkan Google Sign-In dengan Supabase Authentication 🎉

Cara Kerja Helper Google Sign-In dengan Supabase Authentication

Bagian berjudul “Cara Kerja Google Sign-In dengan Supabase Authentication Helper”

Bagian ini menjelaskan cara kerja integrasi Google Sign-In dengan Supabase di balik layar. Memahami alur ini akan membantu Anda mengimplementasikan dan melakukan troubleshooting pada proses autentikasi.

Implementasi ini menghasilkan pasangan nonce yang aman sesuai dengan persyaratan nonce Supabase:

// Generate URL-safe random nonce
function getUrlSafeNonce(): string {
const array = new Uint8Array(32);
crypto.getRandomValues(array);
return Array.from(array, (byte) => byte.toString(16).padStart(2, '0')).join('');
}
// Hash the nonce with SHA-256
async function sha256Hash(message: string): Promise<string> {
const encoder = new TextEncoder();
const data = encoder.encode(message);
const hashBuffer = await crypto.subtle.digest('SHA-256', data);
const hashArray = Array.from(new Uint8Array(hashBuffer));
return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');
}
// Generate nonce pair
async function getNonce(): Promise<{ rawNonce: string; nonceDigest: string }> {
const rawNonce = getUrlSafeNonce();
const nonceDigest = await sha256Hash(rawNonce);
return { rawNonce, nonceDigest };
}

Alur:

  • rawNonce: String acak URL-safe (64 karakter hex)
  • nonceDigest: Hash SHA-256 dari rawNonce (hex-encoded)
  • nonceDigest dikirim ke Google Sign-In → Google menyertakan digest nonce dalam ID token
  • rawNonce dikirim ke Supabase → Supabase melakukan hash pada nonce mentah dan membandingkannya dengan nonce token

Fungsi ini menginisialisasi plugin dan melakukan sign-in dengan Google:

await SocialLogin.initialize({
google: {
webClientId: 'YOUR_WEB_CLIENT_ID.apps.googleusercontent.com',
// iOS only:
iOSClientId: 'YOUR_IOS_CLIENT_ID.apps.googleusercontent.com',
mode: 'online', // Required to get idToken
},
});
const response = await SocialLogin.login({
provider: 'google',
options: {
scopes: ['email', 'profile'],
nonce: nonceDigest, // Pass the SHA-256 hashed nonce
},
});

Sebelum mengirim token ke Supabase, implementasi memvalidasi token JWT:

function validateJWTToken(idToken: string, expectedNonceDigest: string): { valid: boolean; error?: string } {
const decodedToken = decodeJWT(idToken);
// Check audience matches your Google Client IDs
const audience = decodedToken.aud;
if (!VALID_GOOGLE_CLIENT_IDS.includes(audience)) {
return { valid: false, error: 'Invalid audience' };
}
// Check nonce matches
const tokenNonce = decodedToken.nonce;
if (tokenNonce && tokenNonce !== expectedNonceDigest) {
return { valid: false, error: 'Nonce mismatch' };
}
return { valid: true };
}

Mengapa validasi sebelum ke Supabase?

Memvalidasi token JWT sebelum dikirim ke Supabase punya beberapa tujuan penting:

  1. Mencegah Request Tidak Valid: Jika token punya audience yang salah atau nonce tidak cocok, Supabase tetap akan menolak token tersebut. Validasi di awal menghindari call API yang tidak perlu dan memberikan pesan error yang lebih jelas.

  2. Masalah Caching Token: Di beberapa platform (terutama iOS), SDK Google Sign-In bisa meng-cache token demi performa. Saat token yang di-cache dikembalikan, token itu mungkin dibuat dengan nonce berbeda (atau tanpa nonce), sehingga Supabase menolak token dengan error “nonce mismatch”. Dengan validasi sebelum dikirim ke Supabase, kita bisa mendeteksi masalah ini lebih awal dan otomatis mencoba lagi dengan token baru.

  3. Keamanan (iOS): Di iOS, validasi memastikan token diterbitkan untuk Google Client ID spesifik milik Anda, sehingga mencegah potensi masalah keamanan akibat memakai token yang ditujukan untuk aplikasi lain.

  4. Error Handling yang Lebih Baik: Mendeteksi masalah sebelum dikirim ke Supabase memungkinkan logika retry otomatis, yang penting untuk menangani masalah caching iOS secara transparan.

Jika validasi gagal, fungsi otomatis akan:

  1. Logout dari Google (menghapus token yang di-cache - krusial di iOS)
  2. Mengulang autentikasi sekali (memaksa pembuatan token baru dengan nonce yang benar)
  3. If retry also fails, returns an error

Terakhir, token yang sudah divalidasi dikirim ke Supabase:

const { data, error } = await supabase.auth.signInWithIdToken({
provider: 'google',
token: googleResponse.idToken,
nonce: rawNonce, // Pass the raw (unhashed) nonce
});

Implementasi lengkapnya tersedia di aplikasi contoh supabaseAuthUtils.ts file, yang mencakup:

  • getUrlSafeNonce() - Membuat nonce acak yang URL-safe
  • sha256Hash() - Melakukan hashing string dengan SHA-256
  • getNonce() - Membuat pasangan nonce
  • decodeJWT() - Mendecode JWT token
  • validateJWTToken() - Memvalidasi JWT audience dan nonce
  • authenticateWithGoogleSupabase() - Fungsi autentikasi utama dengan retry otomatis

Silakan lanjut ke panduan setup khusus platform untuk platform target Anda:

Lanjutkan dari Supabase Google Login - General Setup

Bagian berjudul “Lanjutkan dari Supabase Google Login - Setup Umum”

Jika Anda menggunakan Supabase Google Login - Setup Umum 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.