Supabase Google Login sur Web

Installez

Introduction

Ce guide vous aidera à intégrer l'authentification Google Sign-In avec Supabase sur Web. Il est supposé que vous avez déjà terminé:

Mise en œuvre

La mise en œuvre complète est disponible dans l' application d'exemple supabaseAuthUtils.ts Ce guide explique les principaux concepts et comment l'utiliser.

Utilisation de l'assistant d'authentification

Le authenticateWithGoogleSupabase fonction gère l'ensemble 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

Lors de l'utilisation de la connexion Google sur le web, vous DEVEZ appeler toute fonction du plugin lors de la redirection pour initialiser le plugin afin qu'il puisse gérer la redirection et fermer la fenêtre de popup. Vous pouvez appeler soit isLoggedIn() OU initialize() - les deux déclenchent la gestion de la redirection.

Cela est essentiel pour que le flux de popup OAuth fonctionne correctement.

Exemple d'implémentation

Ajoutez ceci à votre composant qui gère l'inscription 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
}

Voir le SupabasePage.tsx pour un exemple complet.

Comment ça marche

Pour une explication détaillée de la façon dont le flux d'authentification fonctionne, y compris la génération de nonce, la validation de JWT et la connexion à Supabase, voir la section « Comment ça marche » du guide de configuration générale.

Pour la référence complète code, voir la section « Référence complète Code » du guide de configuration générale.

Voir également :

SupabasePage.tsx - Exemple de composant avec gestion de redirection
SupabaseCreateAccountPage.tsx - Exemple de page de création de compte

Notes importantes

Gestion de redirection

Lorsque vous utilisez l'authentification Google sur le web, vous devez DEVEZ appeler toute fonction du plugin lorsque la redirection se produit pour initialiser le plugin afin qu'il puisse gérer la redirection et fermer la fenêtre de popup. Vous pouvez appeler soit isLoggedIn() OU initialize() - les deux déclencheront la gestion de la redirection.

Cela est essentiel pour que le flux de popup OAuth fonctionne correctement. Sans cela, la fenêtre de popup ne se fermera pas après l'authentification.

Gestion de la noncence

La mise en œuvre de la noncence suit le modèle de la documentation de l'authentification Google Sign In React Native se rend à Supabase:

rawNonce Gestion de la noncence suit le modèle de la documentation de l'authentification Google Sign In React Native et se rend à Supabase signInWithIdToken()
Supabase fait une hachage de rawNonce et le compare avec le nonceDigest qui est inclus dans le jeton ID de Google Sign-In
nonceDigest (hachage SHA-256, encodé en hexadécimal) va dans le nonce paramètre des API de Google Sign-In

Réessayer automatiquement

La mise en œuvre comprend une logique de réessai automatique :

Si la validation du JWT échoue à la première tentative, il se déconnecte et réessaye une fois
Cela gère les cas où les jetons stockés dans la cache peuvent avoir des nonces incorrects
Si la réessai échoue également, une erreur est renvoyée

Résoudre les problèmes

Si l'authentification échoue :

Le redirigeement ne fonctionne pasAssurez-vous d'appeler isLoggedIn() à la montée du composant (voir l'exemple ci-dessus)
Audience non valideVérifiez que vos identifiants Client Google correspondent dans les deux Google Cloud Console et Supabase
URLs de redirigeement autoriséesVérifiez que les URLs de redirigeement autorisées sont configurées dans les deux Google Cloud Console et Supabase
Mauvaise correspondance de nonceVérifiez les journaux de console - la fonction se réessayera automatiquement, mais vous pouvez vous déconnecter manuellement si nécessaire
Échec de la validation du jeton: Assurez-vous d'utiliser mode: 'online' à l'appel d'initialisation pour obtenir un idToken
Examinez le exemple d'application code en tant que référence

Si vous utilisez Supabase Google Login sur le Web pour planifier l'authentification et les flux de compte, connectez-l’avec En utilisant @capgo/capacitor-social-login pour la capacité native dans En utilisant @capgo/capacitor-social-login, @capgo/capacitor-connexion sociale pour les détails d'implémentation dans @capgo/capacitor-connexion sociale, @capgo/capacitor-passkey pour les détails d'implémentation dans @capgo/capacitor-passkey, @capgo/capacitor-authentification native pour les détails d'implémentation dans @capgo/capacitor-authentification native, et L'authentification à deux facteurs pour les détails d'implémentation dans L'authentification à deux facteurs.