Zum Inhalt springen

Supabase Google Login – Allgemeines Setup

GitHub

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.

Bevor du startest, stelle sicher, dass du:

  1. Ein Supabase-Projekt erstellt hast

  2. Lies die Google Login: Allgemeines Setup Anleitung zum Setup der Google OAuth-Credentials

  3. Die jeweiligen plattformspezifischen Guides zum Setup der Google OAuth-Credentials für deine Zielplattform befolgt hast:

  1. Gehe zu deinem Supabase-Dashboard

  2. Klicke auf dein Projekt

    Supabase-Projektauswahl
  3. Navigiere zum Authentication Menü

    Supabase Authentication-Menü
  4. Klicke auf die Providers Tab

    Supabase-Provider-Tab
  5. Suche nach Google Provider

    Supabase Google Provider
  6. Provider aktivieren

    Supabase Google Provider aktivieren
  7. Füge die Client-IDs für die Plattformen hinzu, die du verwenden möchtest

    Supabase Google Provider Client-IDs hinzufügen
  8. Klicke auf die Save Button

    Supabase Google Provider speichern

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.

Die Implementierung erzeugt ein sicheres Nonce-Paar gemäß den Supabase-Nonce-Anforderungen:

// 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 };
}

Ablauf:

  • rawNonce: URL-sichere zufällige Zeichenfolge (64 Hex-Zeichen)
  • nonceDigest: SHA-256-Hash von rawNonce (hex-kodiert)
  • nonceDigest wird an Google Sign-In übergeben → Google fügt den Nonce-Digest in den ID-Token ein
  • rawNonce wird an Supabase übergeben → Supabase hash den rohen Nonce und vergleicht ihn mit dem Nonce im Token

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
},
});

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:

  1. 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.

  2. 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.

  3. 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.

  4. 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:

  1. Logout bei Google (löscht gecachte Tokens – kritisch unter iOS)
  2. Wiederholt die Authentifizierung einmal (erzwingt frische Token-Generierung mit korrektem Nonce)
  3. Gibt bei erneutem Fehlschlagen einen Fehler zurück

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
});

Die vollständige Implementierung findest du im der Beispiel-App supabaseAuthUtils.ts Datei, die Folgendes enthält:

  • getUrlSafeNonce() - Erzeugt einen URL-sicheren zufälligen Nonce
  • sha256Hash() - Hasht einen String mit SHA-256
  • getNonce() - Erzeugt ein Nonce-Paar
  • decodeJWT() - Dekodiert ein JWT-Token
  • validateJWTToken() - Validiert JWT-Audience und Nonce
  • authenticateWithGoogleSupabase() - Hauptauthentifizierungsfunktion mit automatischem Retry

Bitte folge der plattformspezifischen Setup-Anleitung für deine Zielplattform:

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.