Supabase Google Login sur iOS
Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.
Introduction
Section intitulée « Introduction »Ce guide vous aide à intégrer Google Sign-In avec l’authentification Supabase sur iOS. Il est supposé que vous avez déjà effectué les étapes suivantes :
Implémentation
Section intitulée « Implémentation »L'implémentation complète est disponible dans le fichier de l'application d'exemple. supabaseAuthUtils.ts Ce guide explique les concepts clés et comment l'utiliser.
Utilisation de l'Authentication Helper
Section intitulée « Utilisation de l'Authentication Helper »Le authenticateWithGoogleSupabase la fonction gère l'intégralité du flux d'authentification :
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);}Comment ça marche
Section « Comment ça marche »Pour une explication détaillée du flux d'authentification, incluant la génération de nonce, la validation JWT et la connexion Supabase, consultez la section « Comment ça marche » du guide de configuration générale.
Avertissements importants
Section intitulée « Avertissements importants »Problèmes de cache de token et de nonce sur iOS
Section intitulée « Problèmes de cache de token et de nonce sur iOS »Problème de cache du nonce sur iOS
Sur iOS, Google Sign-In peut mettre les tokens en cache, ce qui peut faire échouer la validation du nonce. La validateJWTToken fonction détecte ce cas et le gère automatiquement :
- Détection automatique: La fonction vérifie si le nonce du token correspond à celui attendu
nonceDigest - Réessai automatique: En cas d’échec de la validation, il se déconnecte automatiquement de Google et réessaie une fois
- Gestion des erreurs: Si la nouvelle tentative échoue également, une erreur est renvoyée
Pourquoi cela arrive: Sur iOS, Google Sign-In SDK met les tokens en cache pour des raisons de performance. Lorsqu'un token en cache est renvoyé, il a peut-être été généré avec un nonce différent (ou sans nonce), ce qui provoque une incohérence.
La solution: l’implémentation gère automatiquement ce cas en déconnectant l’utilisateur et en relançant la requête, ce qui force Google à générer un nouveau token avec le bon nonce.
Contournement manuel (if automatic retry doesn’t work):
// Logout first to clear cached tokensawait SocialLogin.logout({ provider: 'google' });
// Then authenticateconst result = await authenticateWithGoogleSupabase();Cela garantit l’obtention d’un nouveau token avec le nonce correct.
Pour la référence code complète, consultez la section « Référence Code complète » du guide de configuration générale.
Notes importantes
Section intitulée « Notes importantes »Gestion du nonce
Section intitulée « Gestion du nonce »L'implémentation du nonce suit le modèle de la documentation React Native Google Sign In:
rawNonceest envoyé à celui de SupabasesignInWithIdToken()- Supabase calcule un hash de
rawNonceet le compare avec lenonceDigestqui est inclus dans l'ID token de Google Sign-In nonceDigest(hash SHA-256, encodé en hex) est envoyé aunonceparamètre des API Google Sign-In
Mécanisme de retry automatique
Section titled “Automatic Retry Mechanism”Le authenticateWithGoogleSupabase la fonction inclut un retry paramètre :
- Premier appel (
retry=false) : si la validation échoue, déconnexion automatique et une nouvelle tentative - Nouvel appel (
retry=true) : si la validation échoue à nouveau, renvoie immédiatement une erreur
Cela gère automatiquement le problème de mise en cache du token sur iOS.
Troubleshooting
Section intitulée « Dépannage »Si l'authentification échoue :
- Nonce non concordant: la fonction réessaie automatiquement — consultez les logs de la console pour en savoir plus. Si le problème persiste, déconnectez-vous d'abord manuellement
- Audience invalide : vérifiez que vos Google Client IDs sont identiques dans Google Cloud Console et dans Supabase (client IDs iOS et Web)
- Échec de la validation du token: Assurez-vous d’utiliser
mode: 'online'dans l’appel initialize pour obtenir un idToken - Configuration de l'Info.plist : assurez-vous que l'Info.plist contient les bons URL schemes et le bon GIDClientID
- Consultez l’ exemple d’application code pour référence
Continuer après Supabase Google Login sur iOS
Section intitulée « Continuer après Supabase Google Login sur iOS »Si vous utilisez Supabase Google Login sur iOS pour planifier les flux d'authentification et de compte, le connecter à Utiliser @capgo/capacitor-social-login pour la capacité native dans Utiliser @capgo/capacitor-social-login @capgo/capacitor-social-login pour les détails d'implémentation dans @capgo/capacitor-social-login @capgo/capacitor-passkey pour les détails d'implémentation dans @capgo/capacitor-passkey @capgo/capacitor-native-biometric pour les détails d'implémentation dans @capgo/capacitor-native-biometric, et Authentification à deux facteurs pour les détails d'implémentation de l'authentification à deux facteurs.