Supabase Google Login - Configuración general
Copia un prompt de configuración con los pasos de instalación y la guía completa en markdown para este plugin.
Introducción
Sección titulada “Introducción”Esta guía te guiará paso a paso para integrar Google Sign-In con Supabase Authentication usando el plugin Social Login de Capacitor. Esta configuración te permite usar Google Sign-In nativo en plataformas móviles mientras aprovechas Supabase Auth para la autenticación del backend.
Requisitos
Sección titulada “Prerrequisitos”Antes de empezar, asegúrate de tener:
-
Lee la Configuración general de Google Login Guía para configurar las credenciales de Google OAuth
-
Sigue las guías específicas de cada plataforma para configurar las credenciales de Google OAuth en tu plataforma de destino:
Habilitar el proveedor de Google OAuth en Supabase
Sección titulada “Habilitar el proveedor de OAuth de Google en Supabase”-
Ve a tu Panel de Supabase
-
Haz clic en tu proyecto
-
No vayas a
Authenticationmenú
-
Haz clic en el
Providerspestaña
-
Busca el
Googleproveedor
-
Habilitar el proveedor
-
Añade los client IDs de las plataformas que planeas usar
-
Haz clic en el
Savebotón
¡Listo! Ya has habilitado Google Sign-In con Supabase Authentication 🎉
Cómo funciona Google Sign-In con Supabase Authentication Helper
Sección titulada «Cómo funciona Google Sign-In con el helper de autenticación de Supabase»Esta sección explica cómo funciona internamente la integración de Google Sign-In con Supabase. Entender este flujo te ayudará a implementar y solucionar problemas del proceso de autenticación.
1. Generación de nonce
Sección titulada «1. Generación de nonce»La implementación genera un par de nonces seguro siguiendo los requisitos de nonce de Supabase:
// Generate URL-safe random noncefunction getUrlSafeNonce(): string { const array = new Uint8Array(32); crypto.getRandomValues(array); return Array.from(array, (byte) => byte.toString(16).padStart(2, '0')).join('');}
// Hash the nonce with SHA-256async function sha256Hash(message: string): Promise<string> { const encoder = new TextEncoder(); const data = encoder.encode(message); const hashBuffer = await crypto.subtle.digest('SHA-256', data); const hashArray = Array.from(new Uint8Array(hashBuffer)); return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');}
// Generate nonce pairasync function getNonce(): Promise<{ rawNonce: string; nonceDigest: string }> { const rawNonce = getUrlSafeNonce(); const nonceDigest = await sha256Hash(rawNonce); return { rawNonce, nonceDigest };}Flujo:
rawNonce: cadena aleatoria segura para URL (64 caracteres hexadecimales)nonceDigest: hash SHA-256 derawNonce(hex-encoded)nonceDigestse pasa a Google Sign-In → Google incluye el digest del nonce en el ID tokenrawNoncese pasa a Supabase → Supabase hace el hash del nonce original y lo compara con el nonce del token
2. Inicio de sesión con Google
Sección titulada “2. Google Sign-In”La función inicializa el plugin e inicia sesión con Google:
await SocialLogin.initialize({ google: { webClientId: 'YOUR_WEB_CLIENT_ID.apps.googleusercontent.com', // iOS only: iOSClientId: 'YOUR_IOS_CLIENT_ID.apps.googleusercontent.com', mode: 'online', // Required to get idToken },});
const response = await SocialLogin.login({ provider: 'google', options: { scopes: ['email', 'profile'], nonce: nonceDigest, // Pass the SHA-256 hashed nonce },});3. Validación de JWT
Sección titulada “3. Validación de JWT”Antes de enviar el token a Supabase, la implementación valida el token JWT:
function validateJWTToken(idToken: string, expectedNonceDigest: string): { valid: boolean; error?: string } { const decodedToken = decodeJWT(idToken);
// Check audience matches your Google Client IDs const audience = decodedToken.aud; if (!VALID_GOOGLE_CLIENT_IDS.includes(audience)) { return { valid: false, error: 'Invalid audience' }; }
// Check nonce matches const tokenNonce = decodedToken.nonce; if (tokenNonce && tokenNonce !== expectedNonceDigest) { return { valid: false, error: 'Nonce mismatch' }; }
return { valid: true };}¿Por qué validar antes de Supabase?
Validar el token JWT antes de enviarlo a Supabase cumple varios propósitos importantes:
-
Prevenir solicitudes inválidas: Si el token tiene una audiencia incorrecta o un nonce que no coincide, Supabase lo rechazará de todos modos. Validar primero evita llamadas innecesarias a API y proporciona mensajes de error más claros.
-
Problemas de caché de tokens: En algunas plataformas (especialmente iOS), Google Sign-In SDK puede cachear tokens por rendimiento. Cuando se devuelve un token en caché, este pudo haberse generado con un nonce diferente (o sin nonce), lo que provoca que Supabase rechace el token con un error de “nonce mismatch”. Al validar antes de enviar a Supabase, podemos detectar este problema temprano y reintentar automáticamente con un token nuevo.
-
Seguridad (iOS): En iOS, la validación asegura que el token fue emitido para tus Client IDs de Google específicos, previniendo posibles problemas de seguridad al usar tokens destinados a otras aplicaciones.
-
Mejor manejo de errores: Detectar problemas antes de Supabase permite una lógica de reintento automático, esencial para manejar los problemas de caché de iOS de forma transparente.
Si la validación falla, la función automáticamente:
- Cierra la sesión en Google (limpia los tokens en caché; crítico en iOS)
- Reintenta la autenticación una vez (fuerza la generación de un nuevo token con el nonce correcto)
- Si el reintento también falla, devuelve un error
4. Inicio de sesión en Supabase
Sección titulada “4. Inicio de sesión con Supabase”Finalmente, el token validado se envía a Supabase:
const { data, error } = await supabase.auth.signInWithIdToken({ provider: 'google', token: googleResponse.idToken, nonce: rawNonce, // Pass the raw (unhashed) nonce});Referencia completa de Code
Sección titulada “Referencia completa de Code”La implementación completa está disponible en la de la app de ejemplo supabaseAuthUtils.ts archivo, que incluye:
getUrlSafeNonce()- Genera un nonce aleatorio apto para URLsha256Hash()- Hashea el string con SHA-256getNonce()- Genera un par de noncesdecodeJWT()- Decodifica el token JWTvalidateJWTToken()- Valida el audience y el nonce del JWTauthenticateWithGoogleSupabase()- Función principal de autenticación con reintento automático
Archivos de ejemplo adicionales
Sección titulada “Archivos de ejemplo adicionales”- SupabasePage.tsx - Componente de ejemplo con manejo de redirección (Web)
- SupabaseCreateAccountPage.tsx - Ejemplo de página de creación de cuenta
Próximos pasos
Sección titulada “Próximos pasos”Continúa con la guía de configuración específica de tu plataforma de destino:
Continuar desde Supabase Google Login - Configuración general
Sección titulada “Continuar desde Supabase Google Login - Configuración general”Si estás usando Supabase Google Login - Configuración general para planificar los flujos de autenticación y de cuenta, conéctalo con Uso de @capgo/capacitor-social-login para la capacidad nativa en el uso de @capgo/capacitor-social-login, @capgo/capacitor-social-login para los detalles de implementación en @capgo/capacitor-social-login, @capgo/capacitor-passkey para el detalle de implementación en @capgo/capacitor-passkey, @capgo/capacitor-native-biometric para el detalle de implementación en @capgo/capacitor-native-biometric, y Autenticación de dos factores para el detalle de implementación en la autenticación de dos factores.