Zum Inhalt springen

Supabase Google Login im Web

GitHub

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:

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.

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

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.

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.

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:

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.

Die Nonce-Implementierung folgt dem Muster aus der React Native Google Sign In Dokumentation:

  • rawNonce geht an Supabase signInWithIdToken()
  • Supabase erstellt einen Hash von rawNonce und vergleicht ihn mit dem nonceDigest der im ID-Token von Google Sign-In enthalten ist
  • nonceDigest (SHA-256 Hash, hex-kodiert) geht an den nonce Parameter in den Google Sign-In APIs

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

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

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.