Zum Inhalt springen

Supabase Google Login auf iOS

GitHub

Diese Anleitung hilft dir dabei, Google Sign-In mit Supabase Authentication unter iOS zu integrieren. Wir gehen davon aus, dass du bereits Folgendes abgeschlossen 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);
}

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.

iOS-Nonce-Caching-Problem

Unter iOS kann Google Sign-In Tokens cachen, was die Nonce-Validierung fehlschlagen lassen kann. Die validateJWTToken Funktion erkennt dies und behandelt es automatisch:

  1. Automatische Erkennung: Die Funktion prüft, ob die Nonce im Token mit der erwarteten nonceDigest
  2. Automatischer Retry: Wenn die Validierung fehlschlägt, wird automatisch von Google abgemeldet und einmal erneut versucht
  3. Fehlerbehandlung: If the retry also fails, an error is returned

Warum das passiert: iOS Google Sign-In SDK cached Tokens für bessere Performance. Wenn ein gecachter Token zurückgegeben wird, wurde er möglicherweise mit einem anderen Nonce (oder ohne Nonce) generiert, was zu einer Abweichung führt.

Die Lösung: Die Implementierung behandelt dies automatisch, indem sie abmeldet und erneut versucht, was Google zwingt, einen frischen Token mit dem korrekten Nonce zu generieren.

Manueller Workaround (falls der automatische Retry nicht funktioniert):

// Logout first to clear cached tokens
await SocialLogin.logout({ provider: 'google' });
// Then authenticate
const result = await authenticateWithGoogleSupabase();

So wird sichergestellt, dass ein frischer Token mit dem korrekten Nonce abgerufen wird.

Die vollständige code-Referenz findest du im Abschnitt „Complete Code Reference“ im General Setup Guide.

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

Der authenticateWithGoogleSupabase function enthält eine retry parameter:

  • Erster Aufruf (retry=false): Wenn die Validierung fehlschlägt, wird automatisch abgemeldet und einmal erneut versucht
  • Retry-Aufruf (retry=true): Wenn die Validierung erneut fehlschlägt, wird sofort ein Fehler zurückgegeben

Dies behandelt das iOS-Token-Caching-Problem automatisch.

Falls die Authentifizierung fehlschlägt:

  • Nonce-Mismatch: Die Funktion versucht automatisch erneut – Details findest du in den Konsolen-Logs. Falls das Problem weiterhin besteht, melde dich manuell ab.
  • Ungültige Audience: Stelle sicher, dass deine Google Client IDs in der Google Cloud Console und in Supabase übereinstimmen (sowohl iOS- als auch Web-Client-IDs).
  • Token-Validierung schlägt fehl: Stelle sicher, dass du Folgendes verwendest: mode: 'online' im initialize-Aufruf, um ein idToken zu erhalten
  • Info.plist-Konfiguration: Stelle sicher, dass die Info.plist die korrekten URL-Schemes und GIDClientID enthält.
  • Überprüfe die Beispiel-App code als Referenz

Nach Supabase Google Login auf iOS weitermachen

Abschnitt mit dem Titel „Weiter mit Supabase Google Login auf iOS“

Wenn du es nutzt Supabase Google Login auf iOS 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.