Supabase Google Login en Web
Copia un prompt 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 la autenticación de Google con Supabase en la web. Se asume que ya has completado:
- el Configuración de inicio de sesión de Google en la 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 la aplicación de ejemplo supabaseAuthUtils.ts archivo. 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 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 complemento cuando suceda la redirección para inicializar el complemento para que pueda manejar la redirección y cerrar la ventana emergente. Puede llamar a cualquiera de isLoggedIn() O initialize() - Ambas activarán el manejo de la redirección.
Esta es esencial para que el flujo de inicio de sesión de 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 de 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 obtener un ejemplo completo.
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 en Supabase, consulte la sección de "Cómo funciona" en la guía de configuración general.
Para la referencia completa del code, consulte la sección de "Referencia completa del Code" en la guía de configuración general.
También consulte:
- SupabasePage.tsx - Ejemplo de componente con manejo de redirección
- SupabaseCreateAccountPage.tsx - Ejemplo de página de registro de cuenta
Observaciones importantes
Sección titulada "Observaciones importantes"Manejo de redirecciones
Sección titulada “Gestión de Redirecciones”Cuando utilices el inicio de sesión de Google en la web, debes 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. Puedes llamar a isLoggedIn() O initialize() - ambas desencadenarán la gestión de redirecciones.
Esto es fundamental 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 Nuevos Códigos
Sección titulada “Gestión de Nuevos Códigos”La implementación de nonce sigue el patrón de la documentación de React Native Google Sign In:
rawNonceva a Supabase’ssignInWithIdToken()- Supabase crea una huella de este
rawNoncey la compara con lanonceDigestque se incluye en el token de ID de Google Sign-In nonceDigest(huella SHA-256, codificada en hexadecimal) se envía alnonceparámetro en las API de Google Sign-In
Reintentos automáticos
Título de la sección “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 incorrectas
- Si el reintento también falla, se devuelve un error
Solución de problemas
Sección titulada “Solución de problemas”Si falla la autenticación:
- No funciona la redirecciónAsegúrate de que estés llamando a
isLoggedIn()en el montaje del componente (consulte el ejemplo anterior) - Público inválido: Verifica que los identificadores de cliente de Google coincidan en tanto en la consola de Google Cloud como en Supabase
- URLs de redirección autorizadas: Verifica que las URLs de redirección autorizadas estén configuradas tanto en la consola de Google Cloud como en Supabase
- Diferencia en el nonce: Verifica los registros del console - la función se repetirá automáticamente, pero puedes cerrar sesión manualmente si es necesario
- Fallo en la validación del tokenAsegúrate de utilizar
mode: 'online'en la llamada de inicialización para obtener un idToken - Revisa el ejemplo de aplicación code para referencia
Sigue adelante desde Supabase Google Login en Web
Título de la sección “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-login social para el detalle de implementación en @capgo/capacitor-login social @capgo/capacitor-clave de acceso para el detalle de implementación en @capgo/capacitor-clave de acceso @capgo/capacitor-autenticación biométrica nativa para el detalle de implementación en @capgo/capacitor-autenticación biométrica nativa, y Autenticación en dos factores para el detalle de implementación en Autenticación en dos factores.