Supabase Google Login en Web
Copie una solicitud de configuración con los pasos de instalación y la guía de markdown completa para este plugin.
Introducción
Sección titulada “Introducción”Esta guía te ayudará a integrar el inicio de sesión de Google con la autenticación de Supabase en Web. Se asume que ya has completado:
- el Configuración de inicio de sesión de Google en Web
- la Configuración general de inicio de sesión de Google de Supabase.
Implementación
Sección titulada “Implementación”La implementación completa está disponible en el archivo del supabaseAuthUtils.ts aplicación de ejemplo. Esta guía explica los conceptos clave y cómo utilizarlo.
Usando la Ayuda de Autenticación
Sección titulada “Usando la Ayuda de Autenticación”El authenticateWithGoogleSupabase La función maneja todo el flujo de autenticación:
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);}Crítico: Manejo de Redirecciones
Sección titulada “Crítico: Manejo de Redirecciones”Crítico: Manejo de Redirecciones
Cuando se utiliza el inicio de sesión de Google en web, usted DEBE llamar a cualquier función del plugin cuando suceda la redirección para inicializar el plugin para que pueda manejar la redirección y cerrar la ventana de popup. Puede llamar a isLoggedIn() O initialize() - Ambas activarán el manejo de redirección.
Esta es esencial para que el flujo de inicio de sesión con OAuth funcione correctamente.
Ejemplo de implementación
Sección titulada “Ejemplo de implementación”Agregue esto a su componente que maneja el inicio de sesión con 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}Consulte el SupabasePage.tsx para un ejemplo completo.
¿Cómo funciona?
Sección titulada “¿Cómo funciona?”Para una explicación detallada de cómo funciona el flujo de autenticación, incluyendo la generación de nonce, la validación de JWT y el inicio de sesión con Supabase, consulte el Sección de cómo funciona en la guía de configuración general.
Para la referencia completa code, consulte la Sección de referencia completa Code en la guía de configuración general.
También consulte:
- SupabasePage.tsx - Ejemplo de componente con manejo de redirecciones
- SupabaseCreateAccountPage.tsx - Ejemplo de página de registro
Notas importantes
Sección titulada “Notas importantes”Manejo de redirecciones
Sección titulada “Manejo de redirecciones”Cuando utilices el inicio de sesión de Google en la web, usted __CAPGO_KEEP_0__ debe llamar a cualquier función del complemento cuando ocurra la redirección para inicializar el complemento para que pueda manejar la redirección y cerrar la ventana emergente. Puede llamar a isLoggedIn() __CAPGO_KEEP_1__ initialize() - ambas desencadenarán el manejo de la redirección.
Esto es esencial para que el flujo de inicio de sesión de OAuth funcione correctamente. Sin esto, la ventana emergente no se cerrará después de la autenticación.
Gestión de nonce
Sección titulada “Gestión de nonce”La implementación de nonce sigue el patrón del documento de React Native Google Sign In:
rawNonceva a Supabase’ssignInWithIdToken()- Supabase hace una función de hash de
rawNoncey la compara con elnonceDigestque se incluye en el token de ID de Google Sign-In nonceDigest(hash SHA-256, codificado en hexadecimal) se envía a lanonceparámetro en las API de Google Sign-In
Reintentos Automáticos
Sección titulada “Reintentos Automáticos”La implementación incluye lógica de reintentos automáticos:
- Si la validación de JWT falla en el primer intento, se cierra sesión y se vuelve a intentar una vez
- Esto maneja casos donde los tokens en caché pueden tener noches incorrectos
- Si el reintento también falla, se devuelve un error
Solución de Problemas
Sección titulada “Solución de Problemas”If authentication fails:
- No funciona la redirección: Asegúrate de llamar a
isLoggedIn()on component mount (see example above) - : Verifica que los identificadores de cliente de Google coincidan en ambos Google Cloud Console y SupabaseAudencia inválida
- : Verifica que las URL de redirección autorizadas estén configuradas en ambos Google Cloud Console y SupabaseDesacuerdo de nonce
- : Revisa los registros del console - la función se repetirá automáticamente, pero puedes cerrar sesión manualmente si es necesarioFalló la validación del token
- : Asegúrate de que estás utilizando__CAPGO_KEEP_0__
mode: 'online'en el llamado de inicialización para obtener un idToken - Revisa el ejemplo de aplicación code para referencia
Sigue adelante desde Supabase Google Login en Web
Sección titulada “Sigue adelante desde Supabase Google Login en Web”Si estás utilizando Supabase Google Login en Web para planificar la autenticación y los flujos de cuenta, conecta con Usando @capgo/capacitor-social-login para la capacidad nativa en Usando @capgo/capacitor-social-login, @capgo/capacitor-social-login para el detalle de implementación en @capgo/capacitor-login-social @capgo/capacitor-clave-de-llave para el detalle de implementación en @capgo/capacitor-clave-de-llave @capgo/capacitor-biometría-nativa para el detalle de implementación en @capgo/capacitor-biometría-nativa, y Autenticación de dos factores para el detalle de implementación en Autenticación de dos factores.