Supabase Google Login im Web
Kopiere einen Setup-Prompt mit den Installationsschritten und dem vollständigen Markdown-Guide für dieses Plugin.
Einführung
Abschnitt „Einführung“Diese Anleitung hilft dir bei der Integration von Google Sign-In mit Supabase Authentication im Web. Wir gehen davon aus, dass du Folgendes bereits erledigt hast:
Implementierung
Abschnitt „Implementierung“Die vollständige Implementierung findest du im der Beispiel-App supabaseAuthUtils.ts Datei. Dieser Guide erklärt die wichtigsten Konzepte und wie du sie verwendest.
Verwendung des Authentication Helpers
Abschnitt mit dem Titel „Verwendung des Authentication Helpers“Der authenticateWithGoogleSupabase Funktion übernimmt den gesamten Authentication-Flow:
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);}Kritisch: Redirect-Handling
Abschnitt: „Wichtig: Redirect-Handling“Kritisch: Redirect-Handling
Wenn du Google Login im Web nutzt, musst du UNBEDINGT eine Funktion des Plugins aufrufen, sobald der Redirect erfolgt. Nur so wird das Plugin initialisiert, damit es den Redirect verarbeiten und das Popup-Fenster schließen kann. Du kannst entweder isLoggedIn() ODER initialize() - beide lösen das Redirect-Handling aus.
Dies ist essenziell, damit der OAuth-Popup-Flow korrekt funktioniert.
Implementierungsbeispiel
Abschnitt mit dem Titel „Implementierungsbeispiel“Füge dies deiner Komponente hinzu, die das Google Sign-In verarbeitet:
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}Siehe den SupabasePage.tsx für ein vollständiges Beispiel.
So funktioniert es
Abschnitt „So funktioniert es“Für eine detaillierte Erklärung des Authentifizierungs-Flows, einschließlich Nonce-Generierung, JWT-Validierung und Supabase Sign-in, siehe den Abschnitt „Funktionsweise“ im General-Setup-Guide.
Die vollständige code-Referenz findest du im Abschnitt „Complete Code Reference“ im General Setup Guide.
Siehe auch:
- SupabasePage.tsx - Beispielkomponente mit Redirect-Handling
- SupabaseCreateAccountPage.tsx - Beispiel: Registrierungsseite
Wichtige Hinweise
Abschnitt mit dem Titel „Wichtige Hinweise“Redirect-Handling
Abschnitt mit dem Titel „Redirect Handling“Wenn du Google Login im Web nutzt, musst du UNBEDINGT beim Redirect eine Funktion des Plugins aufrufen, um das Plugin zu initialisieren. Nur so kann es den Redirect verarbeiten und das Popup-Fenster schließen. Du kannst entweder isLoggedIn() ODER initialize() - beide lösen das Redirect-Handling aus.
Dies ist entscheidend, damit der OAuth-Popup-Flow korrekt funktioniert. Ohne dies schließt sich das Popup-Fenster nach der Authentifizierung nicht.
Nonce-Handling
Abschnitt mit dem Titel „Nonce-Handling“Die Nonce-Implementierung folgt dem Muster aus der React Native Google Sign In Dokumentation:
rawNoncegeht an SupabasesignInWithIdToken()- Supabase erstellt einen Hash von
rawNonceund vergleicht ihn mit demnonceDigestder im ID-Token von Google Sign-In enthalten ist nonceDigest(SHA-256 Hash, hex-kodiert) geht an dennonceParameter in den Google Sign-In APIs
Automatischer Retry
Abschnitt „Automatic Retry“Die Implementierung enthält eine automatische Retry-Logik:
- Schlägt die JWT-Validierung beim ersten Versuch fehl, erfolgt ein Logout und ein erneuter Versuch
- Dies fängt Fälle ab, in denen gecachte Tokens falsche Nonces enthalten könnten
- Falls auch der Retry fehlschlägt, wird ein Error zurückgegeben
Fehlerbehebung
Abschnitt mit dem Titel „Troubleshooting“Falls die Authentifizierung fehlschlägt:
- Redirect funktioniert nicht: Ensure you’re calling
isLoggedIn()beim Mount der Komponente (siehe Beispiel oben) - Ungültige Audience: Überprüfe, ob deine Google Client IDs in der Google Cloud Console und in Supabase übereinstimmen
- Autorisierte Redirect-URLsStelle sicher, dass die autorisierten Redirect-URLs sowohl in der Google Cloud Console als auch in Supabase konfiguriert sind
- Nonce-Mismatch: Prüfe die Console-Logs – die Funktion versucht es automatisch erneut, du kannst dich bei Bedarf aber vorher manuell ausloggen
- Token-Validierung schlägt fehl: Stelle sicher, dass du
mode: 'online'im initialize-Aufruf, um ein idToken zu erhalten - Überprüfe die Beispiel-App code als Referenz
Weiter mit Supabase Google Login im Web
Abschnitt mit dem Titel „Weiter mit Supabase Google Login im Web“Wenn du es nutzt Supabase Google Login im Web 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.