Supabase Google Login auf iOS
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 dabei, Google Sign-In mit Supabase Authentication unter iOS zu integrieren. Wir gehen davon aus, dass du bereits Folgendes abgeschlossen 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);}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.
Wichtige Hinweise
Abschnitt mit dem Titel „Wichtige Hinweise“iOS-Token-Caching und Nonce-Probleme
Abschnitt mit dem Titel „iOS-Token-Caching und Nonce-Probleme“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:
- Automatische Erkennung: Die Funktion prüft, ob die Nonce im Token mit der erwarteten
nonceDigest - Automatischer Retry: Wenn die Validierung fehlschlägt, wird automatisch von Google abgemeldet und einmal erneut versucht
- 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 tokensawait SocialLogin.logout({ provider: 'google' });
// Then authenticateconst 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.
Wichtige Hinweise
Abschnitt mit dem Titel „Wichtige Hinweise“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-Mechanismus
Abschnitt mit dem Titel „Automatischer Retry-Mechanismus“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.
Fehlerbehebung
Abschnitt mit dem Titel „Troubleshooting“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.