Connexion Google via Supabase sur le web
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 Web. Il est supposé que vous avez déjà terminé :
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);}Critique : gestion des redirections
Section intitulée « Critique : gestion des redirections »Critique : gestion des redirections
Lorsque vous utilisez Google Login sur le web, vous DEVEZ appeler une fonction du plugin lorsque la redirection se produit pour l’initialiser, afin qu’il puisse gérer la redirection et fermer la fenêtre popup. Vous pouvez appeler l’une ou l’autre. isLoggedIn() OU initialize() - les deux déclencheront la gestion de la redirection.
C'est indispensable pour que le flux OAuth avec popup fonctionne correctement.
Exemple d'implémentation
Section intitulée « Exemple d’implémentation »Ajoutez ceci à votre composant qui gère la connexion Google :
import { useEffect } from 'react';import { SocialLogin } from '@capgo/capacitor-social-login';
function SupabasePage() { // Check Google login status on mount to invoke redirect handling // This doesn't serve any functional purpose in the UI but ensures // that any pending OAuth redirects are properly processed useEffect(() => { const checkGoogleLoginStatus = async () => { try { await SocialLogin.isLoggedIn({ provider: 'google' }); // We don't use the result, this is just to trigger redirect handling } catch (error) { // Ignore errors - this is just for redirect handling console.log('Google login status check completed (redirect handling)'); } };
checkGoogleLoginStatus(); }, []);
// ... rest of your component}Consultez le SupabasePage.tsx pour un exemple complet.
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.
Pour la référence code complète, consultez la section « Référence Code complète » du guide de configuration générale.
Voir aussi :
- SupabasePage.tsx - Exemple de composant avec gestion de la redirection
- SupabaseCreateAccountPage.tsx - Exemple de page de création de compte
Notes importantes
Section intitulée « Notes importantes »Gestion des redirections
Section intitulée « Gestion de la redirection »Lorsque vous utilisez Google Login sur le web, vous DEVEZ appeler une fonction du plugin lorsque la redirection se produit pour l’initialiser, afin qu’il puisse gérer la redirection et fermer la fenêtre popup. Vous pouvez appeler l’une ou l’autre. isLoggedIn() OU initialize() - les deux déclencheront la gestion de la redirection.
C'est essentiel pour que le flux de la popup OAuth fonctionne correctement. Sans cela, la fenêtre popup ne se fermera pas après l'authentification.
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
Réessai automatique
Section intitulée « Nouvelle tentative automatique »L'implémentation inclut une logique de nouvelle tentative automatique :
- Si la validation JWT échoue au premier essai, déconnexion puis une seule nouvelle tentative.
- Cela gère les cas où les tokens en cache pourraient avoir des nonces incorrects.
- Si la nouvelle tentative échoue aussi, une erreur est renvoyée.
Troubleshooting
Section intitulée « Dépannage »Si l'authentification échoue :
- La redirection ne fonctionne pas : Assurez-vous d'appeler
isLoggedIn()au montage du composant (voir l'exemple ci-dessus) - Audience invalide : Vérifiez que vos Google Client IDs sont identiques dans Google Cloud Console et dans Supabase
- URL de redirection autorisées: Vérifiez que les URL de redirection autorisées sont configurées dans Google Cloud Console et Supabase
- Nonce non concordant: Vérifiez les logs de la console - la fonction réessaiera automatiquement, mais vous pouvez d’abord vous déconnecter manuellement si nécessaire
- Échec de la validation du token: Assurez-vous d’utiliser
mode: 'online'dans l’appel initialize pour obtenir un idToken - Consultez l’ exemple d’application code pour référence
Continuer depuis Supabase Google Login sur le Web
Section intitulée « Continuer après Supabase Google Login sur le web »Si vous utilisez Connexion Google via Supabase sur le web 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.