Supabase Google Login – Allgemeines Setup
Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.
Einführung
Abschnitt „Einführung“Dieser Leitfaden führt Sie durch die Integration von Google Sign-In mit Supabase Authentication über das Capacitor Social Login Plugin. Diese Konfiguration ermöglicht es Ihnen, natives Google Sign-In auf mobilen Plattformen zu nutzen und gleichzeitig Supabase Auth für die Backend-Authentifizierung zu verwenden.
Voraussetzungen
Abschnitt: „Voraussetzungen“Bevor du startest, stelle sicher, dass du:
-
Lies die Google Login: Allgemeines Setup Anleitung zum Setup der Google OAuth-Credentials
-
Die jeweiligen plattformspezifischen Guides zum Setup der Google OAuth-Credentials für deine Zielplattform befolgt hast:
Google OAuth Provider in Supabase aktivieren
Abschnitt mit dem Titel „Google OAuth Provider in Supabase aktivieren“-
Gehe zu deinem Supabase-Dashboard
-
Klicke auf dein Projekt
-
Navigiere zum
AuthenticationMenü
-
Klicke auf die
ProvidersTab
-
Suche nach
GoogleProvider
-
Provider aktivieren
-
Füge die Client-IDs für die Plattformen hinzu, die du verwenden möchtest
-
Klicke auf die
SaveButton
Fertig, du hast jetzt Google Sign-In mit Supabase Authentication aktiviert 🎉
So funktioniert Google Sign-In mit dem Supabase Authentication Helper
Abschnitt mit dem Titel „So funktioniert Google Sign-In mit Supabase Authentication Helper“Dieser Abschnitt erklärt, wie die Google Sign-In-Integration mit Supabase unter der Haube funktioniert. Das Verständnis dieses Flows hilft dir, den Authentifizierungsprozess zu implementieren und Fehler zu beheben.
1. Nonce-Generierung
Abschnitt mit dem Titel „1. Nonce-Generierung“Die Implementierung erzeugt ein sicheres Nonce-Paar gemäß den Supabase-Nonce-Anforderungen:
// Generate URL-safe random noncefunction 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-256async 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 pairasync function getNonce(): Promise<{ rawNonce: string; nonceDigest: string }> { const rawNonce = getUrlSafeNonce(); const nonceDigest = await sha256Hash(rawNonce); return { rawNonce, nonceDigest };}Ablauf:
rawNonce: URL-sichere zufällige Zeichenfolge (64 Hex-Zeichen)nonceDigest: SHA-256-Hash vonrawNonce(hex-kodiert)nonceDigestwird an Google Sign-In übergeben → Google fügt den Nonce-Digest in den ID-Token einrawNoncewird an Supabase übergeben → Supabase hash den rohen Nonce und vergleicht ihn mit dem Nonce im Token
2. Google Sign-In
Abschnitt mit dem Titel „2. Google Sign-In“Die Funktion initialisiert das Plugin und meldet sich mit Google an:
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 },});3. JWT-Validierung
Abschnitt mit dem Titel „3. JWT-Validierung“Bevor der Token an Supabase gesendet wird, validiert die Implementierung den JWT-Token:
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 };}Warum vor Supabase validieren?
Die Validierung des JWT-Tokens vor dem Senden an Supabase dient mehreren wichtigen Zwecken:
-
Ungültige Requests verhindern: Wenn der Token eine falsche Audience oder einen Nonce-Mismatch hat, lehnt Supabase den Token ohnehin ab. Eine vorherige Validierung vermeidet unnötige API-Aufrufe und liefert klarere Fehlermeldungen.
-
Probleme beim Token-Caching: Auf einigen Plattformen (besonders iOS) kann das Google Sign-In SDK Tokens aus Performance-Gründen cachen. Wenn ein gecachter Token zurückgegeben wird, wurde dieser eventuell mit einem anderen Nonce (oder gar keinem) generiert, wodurch Supabase den Token mit einem „Nonce-Mismatch“-Fehler ablehnt. Durch die Validierung vor dem Senden an Supabase können wir dieses Problem frühzeitig erkennen und automatisch mit einem frischen Token erneut versuchen.
-
Sicherheit (iOS): Auf iOS stellt die Validierung sicher, dass der Token für deine spezifischen Google Client IDs ausgestellt wurde, um Sicherheitsrisiken durch die Verwendung von Tokens für andere Apps zu vermeiden.
-
Besseres Error Handling: Das Erkennen von Problemen vor Supabase ermöglicht eine automatische Retry-Logik, die essenziell ist, um iOS-Caching-Probleme transparent zu handhaben.
Schlägt die Validierung fehl, macht die Funktion automatisch Folgendes:
- Logout bei Google (löscht gecachte Tokens – kritisch unter iOS)
- Wiederholt die Authentifizierung einmal (erzwingt frische Token-Generierung mit korrektem Nonce)
- Gibt bei erneutem Fehlschlagen einen Fehler zurück
4. Supabase-Anmeldung
Abschnitt mit dem Titel „4. Supabase Sign-In“Zuletzt wird das validierte Token an Supabase gesendet:
const { data, error } = await supabase.auth.signInWithIdToken({ provider: 'google', token: googleResponse.idToken, nonce: rawNonce, // Pass the raw (unhashed) nonce});Vollständige Code-Referenz
Abschnitt mit dem Titel „Vollständige Code-Referenz“Die vollständige Implementierung findest du im der Beispiel-App supabaseAuthUtils.ts Datei, die Folgendes enthält:
getUrlSafeNonce()- Erzeugt einen URL-sicheren zufälligen Noncesha256Hash()- Hasht einen String mit SHA-256getNonce()- Erzeugt ein Nonce-PaardecodeJWT()- Dekodiert ein JWT-TokenvalidateJWTToken()- Validiert JWT-Audience und NonceauthenticateWithGoogleSupabase()- Hauptauthentifizierungsfunktion mit automatischem Retry
Zusätzliche Beispieldateien
Abschnitt „Zusätzliche Beispieldateien“- SupabasePage.tsx - Beispielkomponente mit Redirect-Handling (Web)
- SupabaseCreateAccountPage.tsx - Beispiel: Registrierungsseite
Nächste Schritte
Abschnitt „Nächste Schritte“Bitte folge der plattformspezifischen Setup-Anleitung für deine Zielplattform:
Weiter mit Supabase Google Login - General Setup
Abschnitt mit dem Titel „Weiter mit Supabase Google Login - General Setup“Wenn du es nutzt Supabase Google Login – Allgemeines Setup Um Authentifizierungs- und Account-Flows zu planen, verbinde es mit @capgo/capacitor-social-login verwenden für die native Funktion bei der Verwendung von @capgo/capacitor-social-login, @capgo/capacitor-social-login für die Implementierungsdetails in @capgo/capacitor-social-login, @capgo/capacitor-passkey für die Implementierungsdetails in @capgo/capacitor-passkey, @capgo/capacitor-native-biometric für die Implementierungsdetails in @capgo/capacitor-native-biometric, und Zwei-Faktor-Authentifizierung für die Implementierungsdetails zur Zwei-Faktor-Authentifizierung.