Saltar al contenido

Supabase Google Login - Configuración general

GitHub

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.

Antes de empezar, asegúrate de tener:

  1. Proyecto de Supabase creado

  2. Lee la Configuración general de Google Login Guía para configurar las credenciales de Google OAuth

  3. Sigue las guías específicas de cada plataforma para configurar las credenciales de Google OAuth en tu plataforma de destino:

  1. Ve a tu Panel de Supabase

  2. Haz clic en tu proyecto

    Selector de proyecto de Supabase
  3. No vayas a Authentication menú

    Menú de autenticación de Supabase
  4. Haz clic en el Providers pestaña

    Pestaña de proveedores de Supabase
  5. Busca el Google proveedor

    Proveedor de Google de Supabase
  6. Habilitar el proveedor

    Habilitar el proveedor de Google de Supabase
  7. Añade los client IDs de las plataformas que planeas usar

    Añadir client IDs al proveedor de Google de Supabase
  8. Haz clic en el Save botón

    Guardar proveedor de Google en Supabase

¡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.

La implementación genera un par de nonces seguro siguiendo los requisitos de nonce de Supabase:

// Generate URL-safe random nonce
function 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-256
async 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 pair
async 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 de rawNonce (hex-encoded)
  • nonceDigest se pasa a Google Sign-In → Google incluye el digest del nonce en el ID token
  • rawNonce se 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
},
});

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:

  1. 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.

  2. 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.

  3. 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.

  4. 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:

  1. Cierra la sesión en Google (limpia los tokens en caché; crítico en iOS)
  2. Reintenta la autenticación una vez (fuerza la generación de un nuevo token con el nonce correcto)
  3. Si el reintento también falla, devuelve un error

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
});

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 URL
  • sha256Hash() - Hashea el string con SHA-256
  • getNonce() - Genera un par de nonces
  • decodeJWT() - Decodifica el token JWT
  • validateJWTToken() - Valida el audience y el nonce del JWT
  • authenticateWithGoogleSupabase() - Función principal de autenticación con reintento automático

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.