Aller au contenu

Supabase Google Login sur iOS

GitHub

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 :

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.

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

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.

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 :

  1. Détection automatique: La fonction vérifie si le nonce du token correspond à celui attendu nonceDigest
  2. Réessai automatique: En cas d’échec de la validation, il se déconnecte automatiquement de Google et réessaie une fois
  3. 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 tokens
await SocialLogin.logout({ provider: 'google' });
// Then authenticate
const 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.

L'implémentation du nonce suit le modèle de la documentation React Native Google Sign In:

  • rawNonce est envoyé à celui de Supabase signInWithIdToken()
  • Supabase calcule un hash de rawNonce et le compare avec le nonceDigest qui est inclus dans l'ID token de Google Sign-In
  • nonceDigest (hash SHA-256, encodé en hex) est envoyé au nonce paramè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.

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

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.