Configuración de autenticación de Supabase con Capacitor Plugin de inicio de sesión social

Configuración de autenticación en aplicaciones móviles puede ser compleja, pero combinando Supabase con el Capgo plugin de inicio de sesión social facilita esto. Este tutorial te guiará a través de la integración de la autenticación social (Google, Apple, Facebook) con Supabase en tu aplicación Capacitor.

Supabase proporciona un backend como servicio robusto con autenticación integrada, mientras que el plugin @capgo/capacitor-social-login ofrece autenticación social nativa en plataformas iOS, Android y web. Para una integración más estrecha de Supabase, @capgo/capacitor-supabase agrega ayudantes de autenticación nativos y acceso a JWT. Juntos, proporcionan:

Autenticación social sin problemas
Gestión de tokens seguros
Compatibilidad cruzada de plataformas
Integración de base de datos en tiempo real
Administración de usuarios integrada

Requisitos previos

Antes de empezar, asegúrese de tener:

Un proyecto Capacitor configurado
Una cuenta y proyecto de Supabase
Cuentas de desarrollador para tus proveedores sociales elegidos (Google, Apple, Facebook)

Primero, instale el plugin de inicio de sesión social Capgo:

npm install @capgo/capacitor-social-login
npx cap sync

Consulte el Inicio de sesión social contexto: Página/área: Página de productos y precios de Capgo. Rol: Etiqueta de UI corta o elemento de navegación. Visto en: página enterprise.astro. Clave de mensaje `enterprise_plugins_capgo_social_login` (Plugins de Capgo de la empresa Inicio de sesión social). y el Supabase páginas de plugins para la configuración específica de la plataforma.

Step 2: Configura el proyecto de Supabase

Crear y configurar tu proyecto de Supabase

Crear un proyecto de Supabase:
- Ve a supabase.com y regístrate/inicia sesión
- Haz clic “Nuevo Proyecto”
- Elige tu organización
- Ingresa un Nombre del Proyecto (por ejemplo, "Autenticación de MyApp")
- Establecer un Contraseña de Base de Datos (guarda esto de manera segura)
- Selecciona tu Región (elige la más cercana a tus usuarios)
- Haz clic en Crear nuevo proyecto"
Obtén tus credenciales de proyecto:
- Una vez creado, ve a Configuración > API
- Copia tu URL de proyecto (por ejemplo, https://your-project-ref.supabase.co)
- Copia tu clave pública anónima API
- Guarda esto para usarlo más tarde en tu aplicación

Configura ajustes de autenticación

Configura ajustes de autenticación generales:
- Ve a Autenticación > Ajustes
- Bajo Configuración general:
  - Establecer URL del sitio a la URL de tu aplicación (por ejemplo, https://yourdomain.com o http://localhost:3000 ¿Otra cosa? (e.g. configuración de alternativas de actualización en vivo de Capacitor).
  - para el desarrollo) Agregar direcciones URL adicionales si es necesario:
```
http://localhost:3000
https://yourdomain.com
capacitor://localhost (for mobile apps)
```
Configurar ajustes de correo electrónico (opcional pero recomendado):
- Bajo Configuración de SMTPConfigura tu proveedor de correo electrónico
- Esto habilita las confirmaciones de correo electrónico y los restablecimientos de contraseña
- Para el desarrollo, puedes utilizar el servicio de correo electrónico integrado

Accede a la sección de proveedores:
- Ve a Autenticación > Proveedores en tu panel de Supabase
- Verás una lista de proveedores sociales disponibles
- Cada proveedor tiene un Habilitar opciones de encendido y configuración

Ahora, configuraremos cada proveedor social en detalle:

Configuración de Autenticación de Google en Supabase

Primero, obtén tus credenciales de OAuth de Google:

Sigue nuestra guía de configuración de Google completa: Configuración de Autenticación de Google

Este manual cubre:

Crear un proyecto de Google Cloud
Configuración de credenciales de OAuth 2.0 para web, iOS y Android
Configuración de la pantalla de consentimiento
Obtener los IDs y secretos de cliente necesarios

After completar la configuración de Google, configúralo en Supabase:

Habilite el proveedor de Google en Supabase:
- En su panel de Supabase, vaya a Autenticación > Proveedores
- Encuentre Google y active el interruptor ACTIVADO
- Rellene la configuración:
  - ID de cliente: Su OAuth de Google Web ID del cliente (desde la Consola de Cloud Google)
  - Secreto del cliente: Su OAuth de Google Web Secreto del cliente
  - URL de redirección: https://your-project-ref.supabase.co/auth/v1/callback (rellenado automáticamente)
- Haga clic “Guardar”

ImportanteUse el ID del cliente Web y Secreto del Cliente Web en Supabase, incluso si estás construyendo una aplicación móvil. Los identificadores de cliente móviles se utilizan por separado en la configuración del complemento.

Configuración de Autenticación de Apple en Supabase

Obtén credenciales de Apple:

Sigue nuestra guía detallada de configuración de Apple: Configuración de Autenticación de Apple

Este manual cubre:

Configuración de tu cuenta de desarrollador de Apple
Creación de IDs de aplicación y IDs de servicio
Configuración de la capacidad de inicio de sesión con Apple
Generación de las claves privadas requeridas
Configuración específica de plataforma para iOS, Android y Web

Una vez completada la configuración de Apple, configúralo en Supabase:

Habilita el proveedor de Apple en Supabase:
- Vaya a Autenticación > Proveedores y active Apple ACTIVADO
- Rellene la configuración:
  - ID de cliente: Su identificador de Servicio ID (por ejemplo, com.yourapp.signin)
  - Secreto de clienteGenera este JWT utilizando tu clave privada de Apple (ver Documentación de Apple URL de redirección
  - (rellenada automáticamente): https://your-project-ref.supabase.co/auth/v1/callback Haz clic
- “Guardar” Nota

: La configuración de autenticación de Apple es la más compleja debido a los requisitos de Apple para IDs de Servicio, claves privadas y generación de JWT. Sigue nuestra documentación cuidadosamente para cada plataforma.Configuración de autenticación de Facebook en Supabase

Obtén credenciales de Facebook:

Sigue nuestra guía completa de configuración de Facebook:

Configuración de autenticación de Facebook en Supabase Configuración de autenticación de Facebook

Este tutorial cubre:

Crear una cuenta de desarrollador de Facebook y aplicación
Agregar el producto de inicio de sesión de Facebook
Configurar URIs de redirección OAuth
Obtener su ID de aplicación, secreto de aplicación y token de cliente
Configuración específica de plataforma para iOS y Android

Después de completar la configuración de Facebook, configúrela en Supabase:

Habilitar proveedor de Facebook en Supabase:
- Vaya a Autenticación > Proveedores y active Facebook ACTIVADO
- Rellene la configuración:
  - ID del cliente: Su ID de aplicación de Facebook
  - Secreto del cliente: Su secreto de aplicación de Facebook
  - URL de redirección: https://your-project-ref.supabase.co/auth/v1/callback (rellenado automáticamente)
- Haga clic “Guardar”

Importante: Asegúrese de agregar la URL de llamada de Supabase (https://your-project-ref.supabase.co/auth/v1/callback) a las URI de OAuth válidas de su aplicación de Facebook en los ajustes de inicio de sesión de Facebook. Ajustes importantes de configuración de Supabase Nivel de seguridad de fila (RLS):

Después de configurar la autenticación, habilite el RLS en sus tablas

Vaya a

Base de datos > Tablas
y active Habilitar RLS para cada tabla Vaya a Base de datos > Tablas
Crear políticas para controlar el acceso a los datos en función de usuarios autenticados

Administración de usuarios:

Ver usuarios autenticados en Autenticación > Usuarios
Monitorear eventos de autenticación en Autenticación > Registros
Configurar plantillas de correo electrónico en Autenticación > Plantillas de correo electrónico

Prueba de la configuración:

Utilizar la herramienta de prueba de autenticación integrada de Supabase
Ir a Autenticación > Usuarios Haga clic “Invitar a usuario” prueba flujos de correo electrónico
Verificar la Registro de actividad context: Página/área: Capgo Builder / producto de construcción nativa en la nube. Rol: Etiqueta de UI corta o elemento de navegación. Visto en: página native-build.astro. Mensaje clave `native_build_v2_trust_logs_lbl` (Native Build V2 Trust Logs Lbl).

Paso 4: Configurar el plugin de inicio de sesión social Ahora que Supabase está configurado, debes configurar el plugin de inicio de sesión social con las credenciales correspondientes.Importante context: Página/área: Página del programa de recompensa de bugs. Rol: Etiqueta de UI. Visto en: página bug-bounty.astro. Mensaje clave `bug_bounty_important_label` (Bug Bounty Important Label). : El plugin necesita las credenciales OAuth de los proveedores originales (no de Supabase), mientras que Supabase gestiona la autenticación en el lado del servidor.

How the Authentication Flow Works

Antes de sumergirse en la configuración, comprenda el flujo:

El plugin autentica con el proveedor social (Google/Apple/Facebook) de manera nativa
El plugin recibe tokens (token de acceso, token de ID) del proveedor
Su aplicación envía estos tokens a Supabase utilizando signInWithIdToken()
Supabase valida los tokens con el proveedor y crea una sesión de usuario
Supabase devuelve su propio token JWT para las solicitudes autenticadas de su aplicación

Configuración del plugin de Google

El plugin necesita tu ID de cliente web de Google para todas las plataformas y opcionalmente un ID de cliente iOS para características específicas de iOS:

import { SocialLogin } from '@capgo/capacitor-social-login';

await SocialLogin.initialize({
  google: {
    // Use the same Web Client ID you configured in Supabase
    webClientId: 'YOUR_WEB_CLIENT_ID.apps.googleusercontent.com',
    
    // Optional: iOS Client ID for iOS-specific features
    iOSClientId: 'YOUR_IOS_CLIENT_ID.apps.googleusercontent.com',
    
    // Optional: Request offline access for refresh tokens
    mode: 'offline'
  }
});

Puntos clave de Google:

Utiliza el ID de cliente web de Google (no los IDs de cliente Android/iOS) para el webClientId campo
El plugin funcionará en todas las plataformas con solo el ID de cliente web
El iOSClientId es opcional y solo se utiliza para características específicas de Google en iOS

Configuración del plugin de Apple

La configuración de Apple difiere entre iOS y Android:

Para iOS (iniciación nativa de Apple):

await SocialLogin.initialize({
  apple: {
    // No additional configuration needed for iOS
    // The plugin uses the native Apple Sign-In capability
  }
});

Para Android/Web (requiere ID de servicio):

await SocialLogin.initialize({
  apple: {
    clientId: 'YOUR_SERVICE_ID', // The Service ID from Apple Developer Portal
    redirectUrl: 'https://your-project-ref.supabase.co/auth/v1/callback'
  }
});

Puntos clave para Apple:

iOS utiliza la iniciación nativa con Apple (no se necesita configuración adicional)
Android/Web requiere el ID de servicio que creaste en el Portal de Desarrolladores de Apple
El redirectUrl debe coincidir con lo que configuraste en el portal de desarrolladores de Apple y Supabase

Configuración del plugin de Facebook

Facebook requiere su ID de aplicación y token de cliente:

await SocialLogin.initialize({
  facebook: {
    appId: 'YOUR_FACEBOOK_APP_ID',        // From Facebook Developer Dashboard
    clientToken: 'YOUR_FACEBOOK_CLIENT_TOKEN', // From Facebook Developer Dashboard
    
    // Optional: Use Facebook Limited Login (for enhanced privacy)
    limitedLogin: false // See our Facebook setup guide for important Limited Login details
  }
});

puntos importantes para Facebook:

Utiliza el mismo ID de aplicación que configuraste en Supabase
El token de cliente se encuentra en los ajustes básicos de tu aplicación de Facebook
limitedLogin: true habilita la característica de inicio de sesión limitado de Facebook, enfocada en la privacidad (solo para iOS)
ImportanteVer: nuestra Guía de configuración de Facebook para obtener información detallada sobre la característica de inicio de sesión limitado, incluyendo consideraciones sobre ATT

Complete la inicialización del plugin

Aquí está cómo inicializar todos los proveedores al mismo tiempo:

import { SocialLogin } from '@capgo/capacitor-social-login';

export async function initializeSocialLogin() {
  await SocialLogin.initialize({
    google: {
      webClientId: 'YOUR_WEB_CLIENT_ID.apps.googleusercontent.com',
      mode: 'offline'
    },
    facebook: {
      appId: 'YOUR_FACEBOOK_APP_ID',
      clientToken: 'YOUR_FACEBOOK_CLIENT_TOKEN',
    },
    apple: {
      // iOS: no config needed
      // Android/Web: uncomment the lines below
      // clientId: 'YOUR_SERVICE_ID',
      // redirectUrl: 'https://your-project-ref.supabase.co/auth/v1/callback'
    }
  });
}

Notas importantes:

Llama initialize() una vez cuando tu aplicación comience, no antes de cada inicio de sesión
Solo necesitas configurar los proveedores que planeas usar
Las credenciales aquí son de los proveedores originalesy no de Supabase
Asegúrate de que las credenciales del proveedor coincidan con lo que configuraste en Supabase

Paso 5: Configura el cliente de Supabase

Instala el cliente de Supabase:

npm install @supabase/supabase-js

Crear un servicio de Supabase:

// services/supabase.ts
import { createClient } from '@supabase/supabase-js';

const supabaseUrl = 'https://your-project-ref.supabase.co';
const supabaseKey = 'your-anon-public-key';

export const supabase = createClient(supabaseUrl, supabaseKey, {
  auth: {
    autoRefreshToken: true,
    persistSession: true,
    detectSessionInUrl: false,
  },
});

Step 6: Implementar flujo de autenticación

Crear un servicio de autenticación que combina ambos:

// services/auth.ts
import { SocialLogin } from '@capgo/capacitor-social-login';
import { supabase } from './supabase';

export class AuthService {
  
  async initializeSocialLogin() {
    await SocialLogin.initialize({
      google: {
        webClientId: 'YOUR_WEB_CLIENT_ID.apps.googleusercontent.com',
      },
      facebook: {
        appId: 'YOUR_FACEBOOK_APP_ID',
        clientToken: 'YOUR_FACEBOOK_CLIENT_TOKEN',
      },
      apple: {} // iOS configuration
    });
  }

  async signInWithGoogle() {
    try {
      const result = await SocialLogin.login({
        provider: 'google',
        options: {
          scopes: ['email', 'profile']
        }
      });

      const googleResult = result.result;
      if (!googleResult) {
        throw new Error('Google login failed');
      }

      // GoogleLoginResponse is a union type - check responseType to determine flow
      if (googleResult.responseType === 'online') {
        // Online mode: use idToken directly with Supabase
        const { data, error } = await supabase.auth.signInWithIdToken({
          provider: 'google',
          token: googleResult.idToken!,
        });
        if (error) throw error;
        return data;
      } else {
        // Offline mode: exchange serverAuthCode on your backend
        // Your backend should exchange the code for tokens and create a Supabase session
        const response = await fetch('/api/auth/google', {
          method: 'POST',
          headers: { 'Content-Type': 'application/json' },
          body: JSON.stringify({ serverAuthCode: googleResult.serverAuthCode })
        });
        return response.json();
      }
    } catch (error) {
      console.error('Google sign-in error:', error);
      throw error;
    }
  }

  async signInWithApple() {
    try {
      const result = await SocialLogin.login({
        provider: 'apple',
        options: {
          scopes: ['email', 'name']
        }
      });

      const { data, error } = await supabase.auth.signInWithIdToken({
        provider: 'apple',
        token: result.result?.identityToken!,
      });

      if (error) throw error;
      return data;
    } catch (error) {
      console.error('Apple sign-in error:', error);
      throw error;
    }
  }

  async signInWithFacebook() {
    try {
      const result = await SocialLogin.login({
        provider: 'facebook',
        options: {
          permissions: ['email', 'public_profile']
        }
      });

      const fbResult = result.result;
      if (!fbResult?.accessToken?.token) {
        throw new Error('Facebook login failed - no access token received');
      }

      // Facebook uses accessToken for Supabase authentication
      const { data, error } = await supabase.auth.signInWithIdToken({
        provider: 'facebook',
        token: fbResult.accessToken.token,
      });

      if (error) throw error;
      return data;
    } catch (error) {
      console.error('Facebook sign-in error:', error);
      throw error;
    }
  }

  async signOut() {
    // Sign out from Supabase
    await supabase.auth.signOut();
    
    // Optionally sign out from social providers
    await SocialLogin.logout({
      provider: 'google' // or 'apple', 'facebook'
    });
  }

  getCurrentUser() {
    return supabase.auth.getUser();
  }

  onAuthStateChange(callback: (event: string, session: any) => void) {
    return supabase.auth.onAuthStateChange(callback);
  }
}

export const authService = new AuthService();

Step 7: Implementar en tu aplicación

Inicializar el servicio y manejar la autenticación:

// main.ts or app component
import { authService } from './services/auth';

async function initializeApp() {
  await authService.initializeSocialLogin();
  
  // Listen to auth state changes
  authService.onAuthStateChange((event, session) => {
    if (event === 'SIGNED_IN') {
      console.log('User signed in:', session.user);
      // Redirect to authenticated area
    } else if (event === 'SIGNED_OUT') {
      console.log('User signed out');
      // Redirect to login
    }
  });
}

initializeApp();

Crear botones de inicio de sesión en tu interfaz de usuario:

// Login component
async function handleGoogleLogin() {
  try {
    const user = await authService.signInWithGoogle();
    console.log('Signed in with Google:', user);
  } catch (error) {
    console.error('Login failed:', error);
  }
}

async function handleAppleLogin() {
  try {
    const user = await authService.signInWithApple();
    console.log('Signed in with Apple:', user);
  } catch (error) {
    console.error('Login failed:', error);
  }
}

async function handleFacebookLogin() {
  try {
    const user = await authService.signInWithFacebook();
    console.log('Signed in with Facebook:', user);
  } catch (error) {
    console.error('Login failed:', error);
  }
}

async function handleLogout() {
  try {
    await authService.signOut();
    console.log('Signed out successfully');
  } catch (error) {
    console.error('Logout failed:', error);
  }
}

Step 8: Configuración específica de plataforma

Configuración de iOS

Para obtener instrucciones de configuración de iOS detalladas, consulte nuestros guías específicas de plataforma:

Configuración de inicio de sesión de Google iOS - Esquemas de URL, configuración de Info.plist
Configuración de inicio de sesión de Apple iOS - Configuración de la capacidad de inicio de sesión con Apple
Configuración de Facebook para iOS (en general, guía de Facebook) - Configuración de Facebook SDK

Resumen rápido - Agregar a ios/App/App/Info.plist:

<!-- Google Sign-In URL scheme -->
<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>YOUR_REVERSED_CLIENT_ID</string>
    </array>
  </dict>
</array>

<!-- Apple Sign-In capability -->
<key>com.apple.developer.applesignin</key>
<array>
  <string>Default</string>
</array>

Siga las guías vinculadas para obtener instrucciones completas de configuración de iOS, incluida la configuración del proyecto de Xcode.

Configuración de Android

Para obtener instrucciones de configuración de Android detalladas, consulte nuestras guías específicas de plataforma:

Configuración de Google Android - Huellas digitales SHA-1, configuración de servicios de Google Play
Configuración de Android de Apple - Configuración de ID de servicio para Android
Configuración de Facebook para Android (en general, guía de Facebook) - Integración de Facebook SDK

Configuración Android esencial:

1. Obtén tu huella SHA-1 (requerido para Google):

# For debug builds (development)
cd android
./gradlew signingReport

# Look for the SHA1 fingerprint under "Variant: debug"
# Add this SHA1 to your Google Cloud Console Android OAuth client

2. Configura AndroidManifest.xml - Agregar a android/app/src/main/AndroidManifest.xml:

<!-- Internet permission -->
<uses-permission android:name="android.permission.INTERNET" />

<!-- Facebook configuration -->
<meta-data 
  android:name="com.facebook.sdk.ApplicationId" 
  android:value="@string/facebook_app_id"/>
<meta-data 
  android:name="com.facebook.sdk.ClientToken" 
  android:value="@string/facebook_client_token"/>

3. Agrega recursos de Facebook a android/app/src/main/res/values/strings.xml:

<string name="facebook_app_id">YOUR_FACEBOOK_APP_ID</string>
<string name="facebook_client_token">YOUR_FACEBOOK_CLIENT_TOKEN</string>

Sigue las guías de la plataforma vinculada para configurar completamente Android, incluida la configuración de servicios de Google Play y el nombre de paquete.

Paso 9: Utilizando la base de datos de Supabase con usuarios autenticados

Una vez que los usuarios estén autenticados, puede utilizar la base de datos de Supabase con seguridad de nivel de fila (RLS):

// Example: Fetch user profile
async function getUserProfile() {
  const { data: user } = await supabase.auth.getUser();
  
  if (user) {
    const { data, error } = await supabase
      .from('profiles')
      .select('*')
      .eq('id', user.user.id)
      .single();
    
    return data;
  }
}

// Example: Update user profile
async function updateUserProfile(updates: any) {
  const { data: user } = await supabase.auth.getUser();
  
  if (user) {
    const { data, error } = await supabase
      .from('profiles')
      .update(updates)
      .eq('id', user.user.id);
    
    return data;
  }
}

Consideraciones de seguridad importantes

Nunca exponga claves sensibles en su cliente code
Utilice variables de entorno para la configuración
Habilite la seguridad de nivel de fila en Supabase
Valida tokens en su servidor de respaldo si es necesario
Administre la refrescación de tokens automáticamente con Supabase

Resolución de Problemas Comunes

Errores de Coincidencia de Token

Asegúrese de que las configuraciones de proveedor de OAuth coincidan entre el plugin de inicio de sesión social y Supabase
Verifique que las URL de redirección estén configuradas correctamente

Problemas Específicos de Plataforma

iOS: Verifique que el ID de paquete coincida con la configuración de desarrollador de Apple
Android: Asegúrese de que los huellas SHA1 estén agregadas correctamente al Console de Google

Interrupciones en el Flujo de Autenticación

Implemente un manejo de errores adecuado para problemas de red
Agregue estados de carga durante la autenticación

Conclusión

Ahora tienes un sistema de autenticación completo que combina el backend robusto de Supabase con capacidades de inicio de sesión social nativa. Esta configuración proporciona:

Autenticación social segura y nativa
Gestión de tokens sin problemas
Integración de base de datos en tiempo real
Compatibilidad cruzada de plataformas

La combinación de Supabase y el plugin de inicio de sesión social Capgo ofrece una solución de autenticación poderosa y escalable para tus Capacitor aplicaciones.

Para características avanzadas como autenticación multifactor o ¿Quieres más características avanzadas como la autenticación multifactorial o la personalización de tokens?revisa la documentación de Supabase y el documentación del plugin de inicio de sesión social.

Si estás utilizando Configuración de Supabase con inicio de sesión social Capacitor para planificar la autenticación y los flujos de cuenta, conecta con @capgo/capacitor-inicio-de-sesión-social para los detalles de implementación en @capgo/capacitor-inicio-de-sesión-social, @capgo/capacitor-clave-pública para los detalles de implementación en @capgo/capacitor-clave-pública, @capgo/capacitor-biometría-nativa para los detalles de implementación en @capgo/capacitor-biometría-nativa, Autenticación en dos factores para el detalle de implementación en Autenticación en dos factores, y SSO (Empresas) para el detalle de implementación en SSO (Empresas).

Configuración de autenticación de Supabase con plugin de inicio de sesión social de Capacitor

¿Por qué usar Supabase con inicio de sesión social?