Configurer l'authentification Supabase avec le plugin Capacitor de connexion sociale

La mise en place de l'authentification dans les applications mobiles peut être complexe, mais la combinaison de Supabase avec le Capgo makes it straightforward. This tutorial will guide you through integrating social authentication (Google, Apple, Facebook) with Supabase in your Capacitor app.

Pourquoi Utiliser Supabase avec l'Inscription Sociale ? Supabase @capgo/capacitor-social-login @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-social-login @capgo/capacitor-supabase ajoute des assistants d'authentification natifs et un accès JWT. Ensemble, ils fournissent :

Une authentification sociale fluide
Une gestion de jetons sécurisée
Une compatibilité multiplateforme
Une intégration de base de données en temps réel
Une gestion de compte utilisateur intégrée

Prérequis

Avant de commencer, assurez-vous d'avoir :

Un projet Capacitor configuré
Un compte et un projet Supabase
Des comptes développeurs pour vos fournisseurs sociaux choisis (Google, Apple, Facebook)

Premièrement, installez le Capgo plugin de connexion sociale :

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

Consultez les Connexion sociale context et context

Supabase

pages du plugin pour la configuration spécifique à la plateforme.

Étape 2 : Configurez le projet Supabase:
- Créez et configurez votre projet Supabase Créez un projet Supabase : « Supabase » est un fournisseur de base de données en nuage. Créez un projet Supabase sur le site web de Supabase : « supabase.com » et vous inscrire/ vous connecter
- Cliquez “Nouveau Projet”
- Choisissez votre organisation
- Entrez un Nom de projet (par exemple, « MonApp Auth »)
- Définissez un Mot de passe de base de données (sauvez-l’en toute sécurité)
- Sélectionnez votre Région (choisissez celui qui vous convient le mieux)
- Cliquez « Créer un nouveau projet »
Obtenez vos informations de projet:
- Une fois créé, allez à Paramètres > API
- Copiez votre URL de projet Par exemple, https://your-project-ref.supabase.co)
- Copiez votre clé publique anonyme API
- Sauvez-les pour une utilisation ultérieure dans votre application

Configurez les paramètres d'authentification

Configurez les paramètres d'authentification généraux:
- Allez à Authentification > Paramètres
- Sous Paramètres généraux:
  - Définissez URL du site à l'URL de votre application (par exemple, https://yourdomain.com ou http://localhost:3000 pour le développement
  - Ajoutez des fonctionnalités supplémentaires URLs de redirection si nécessaire :
```
http://localhost:3000
https://yourdomain.com
capacitor://localhost (for mobile apps)
```
Configurez les paramètres de courrier électronique (facultatif mais recommandé) :
- Sous Paramètres SMTP, configurez votre fournisseur de courrier électronique
- Cela active les confirmations par courrier électronique et les réinitialisations de mot de passe
- Pour le développement, vous pouvez utiliser le service de courrier électronique intégré

Accédez à la section des fournisseurs:
- Allez à Authentification > Fournisseurs dans votre tableau de bord Supabase
- Vous verrez une liste des fournisseurs sociaux disponibles
- Chaque fournisseur a un Activer bouton et des options de configuration

Maintenant, configurons chaque fournisseur social en détail :

Configuration de l'authentification Google dans Supabase

Tout d'abord, obtenez vos clés OAuth Google :

Suivez notre guide de configuration Google complet : Configuration d'authentification Google

Cette guide couvre :

Création d'un projet Cloud Google
Configuration des clés OAuth 2.0 pour web, iOS et Android
Configuration de l'écran de consentement
Obtention des identifiants et des secrets clients requis

Après avoir terminé la configuration Google, configurez-la dans Supabase :

Activer le fournisseur Google dans Supabase:
- Dans votre tableau de bord Supabase, allez à Authentification > Fournisseurs
- Trouvez Google et l'activer ACTIVER
- Remplissez les informations de configuration :
  - ID du client: Votre Google OAuth Web ID du client (à partir de la console Google Cloud)
  - Secret du client: Votre Google OAuth Web Secret du client
  - URL de redirection: https://your-project-ref.supabase.co/auth/v1/callback (auto-filled)
- Clicker “Sauvegarder”

Important :: Utilisez le ID du Client Web et Secret du Client Web dans Supabase, même si vous construisez une application mobile. Les identifiants de client mobile sont utilisés séparément dans la configuration du plugin.

Configuration de l'authentification Apple dans Supabase

Obtenez les informations d'identification Apple :

Suivez notre guide détaillé de configuration Apple : Configuration d'authentification Apple

Cette guide couvre :

Configuration de votre compte développeur Apple
Création d'identifiants d'application et d'identifiants de service
Configuration de la capacité Sign in with Apple
Génération des clés privées requises
Configuration spécifique à la plateforme pour iOS, Android et Web

Après avoir terminé la configuration Apple, configurez-la dans Supabase :

Activer le fournisseur Apple dans Supabase:
- Allez à Authentification > Fournisseurs et déplacez le curseur Apple OUI
- Remplir les informations de configuration :
  - ID du client: Votre identifiant de Service ID (par exemple, com.yourapp.signin)
  - Secret du client: Générez ce JWT à l'aide de votre clé privée Apple (voir Documents Apple de Supabase pour le format JWT)
  - URL de redirection: https://your-project-ref.supabase.co/auth/v1/callback (remplie automatiquement)
- Cliquez “Sauvegarder”

Note: La configuration d'authentification Apple est la plus complexe en raison des exigences d'Apple pour les identifiants de service, les clés privées et la génération de JWT. Suivez notre documentation soigneusement pour chaque plateforme.

Configuration de l'authentification Facebook dans Supabase

Obtenez les informations de connexion Facebook :

Suivez notre guide de configuration Facebook complet : Configuration de l'authentification Facebook

Ce guide couvre :

Créer un compte développeur Facebook et une application
Ajouter le produit de connexion Facebook
Configurer les URIs de redirection OAuth
Obtenir votre ID d'application, votre secret d'application et votre jeton client
Configuration spécifique à la plateforme pour iOS et Android

Après avoir terminé la configuration de Facebook, configurez-la dans Supabase :

Activer le fournisseur Facebook dans Supabase:
- Allez à Authentification > Fournisseurs et déplacez le curseur Facebook ACTIVÉ
- Remplissez les informations de configuration :
  - ID du client: Votre ID d'application Facebook
  - Secret du client: Votre secret d'application Facebook
  - URL de redirection: https://your-project-ref.supabase.co/auth/v1/callback (rempli automatiquement)
- Cliquez “Sauvegarder”

Important: Assurez-vous d'avoir ajouté l'URL de rappel de Supabase (https://your-project-ref.supabase.co/auth/v1/callback) aux URIs OAuth valides de votre application Facebook. Paramètres de connexion Facebook Valid OAuth Redirect URIs

Paramètres de sécurité de niveau de ligne (RLS) :

Paramètres de sécurité de niveau de ligne (RLS) :

Après avoir configuré l'authentification, activez RLS sur vos tables
Allez à Base de données > Tables et déplacez le curseur Activer RLS pour chaque table
Créez des politiques pour contrôler l'accès aux données en fonction des utilisateurs authentifiés

Gestion des utilisateurs :

Affichez les utilisateurs authentifiés dans Authentification > Utilisateurs
Surveillez les événements d'authentification dans Authentification > Journal
Configurer les modèles de courriel dans Authentification > Modèles de courriel

Tester la configuration :

Utilisez l'outil de test d'authentification intégré de Supabase
Allez à Authentification > Utilisateurs et cliquez sur « Inviter un utilisateur » pour tester les flux de courriel
Vérifiez la section des journaux pour tout erreur d'authentification

Maintenant que Supabase est configuré, vous devez configurer le plugin de connexion sociale avec les informations correspondantes. Important: Le plugin nécessite les informations d'authentification OAuth des originaux fournisseurs (pas de Supabase), tandis que Supabase gère l'authentification côté serveur.

Comment fonctionne le flux d'authentification

Avant de plonger dans la configuration, comprenez le flux :

Le plugin s'authentifie avec le fournisseur social (Google/Apple/Facebook) nativement
Le plugin reçoit les jetons (jeton d'accès, jeton d'ID) du fournisseur
Votre application envoie ces jetons à Supabase à l'aide de signInWithIdToken()
Supabase valide les jetons avec le fournisseur et crée une session utilisateur
Supabase retourne son propre jeton JWT pour les requêtes authentifiées de votre application

Configuration du plugin Google

Le plugin nécessite votre ID de client Web pour tous les plateformes et optionnellement un ID de client iOS pour les fonctionnalités spécifiques à 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'
  }
});

Points clés pour Google :

Utilisez le ID du client Web (pas les ID de client Android/iOS) pour le webClientId champ
Le plugin fonctionnera sur tous les plateformes avec uniquement l'ID du client Web
Le iOSClientId est optionnel et n'est utilisé que pour les fonctionnalités iOS spécifiques de Google

Configuration du plugin Apple

La configuration Apple diffère entre iOS et Android :

Pour iOS (signe d'Apple natif) :

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

Pour Android/Web (exige l'ID de service) :

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

Points clés pour Apple :

iOS utilise Sign in avec Apple natif (aucune configuration supplémentaire nécessaire)
Android/Web nécessite l'ID de service que vous avez créé dans le Portail des développeurs Apple
Le redirectUrl devrait correspondre à ce que vous avez configuré dans le Portail des développeurs Apple et Supabase

Configuration du plugin Facebook

Facebook nécessite votre ID d'application et votre jeton client :

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

Points clés pour Facebook :

Utilisez le même ID d'application que vous avez configuré dans Supabase
Le jeton client se trouve dans les paramètres de base de votre application Facebook
limitedLogin: true active le mode de connexion privé axé sur la confidentialité de Facebook (disponible uniquement sur iOS)
ImportantVoir notre guide de configuration Facebook pour plus d'informations détaillées sur la connexion limitée, y compris les considérations sur ATT

Initialisation complète du plugin

C'est ainsi que vous pouvez initialiser tous les fournisseurs ensemble :

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

Notes importantes :

Appelez initialize() une fois lorsque votre application démarre, et non avant chaque connexion
Vous n'avez besoin de configurer que les fournisseurs que vous prévoyez d'utiliser
Les informations d'identification ici proviennent des fournisseurs d'origineet non de Supabase
Assurez-vous que les informations d'identification du fournisseur correspondent à celles que vous avez configurées dans Supabase

Étape 5 : Configurer le client Supabase

Installez le client Supabase :

npm install @supabase/supabase-js

Créez un service 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,
  },
});

Étape 6 : Implémenter la flux d'authentification

Créez un service d'authentification qui combine les deux :

// 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();

Étape 7 : Implémenter dans votre application

Initialisez le service et gérez l'authentification :

// 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();

Créez des boutons de connexion dans votre interface utilisateur :

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

Étape 8 : Configuration Spécifique à la Plateforme

Configuration iOS

Pour obtenir des instructions de configuration iOS détaillées, consultez nos guides spécifiques à la plateforme :

Configuration iOS Google - Configuration des schémas URL, configuration d'Info.plist
Configuration iOS Apple - Configuration de la capacité de connexion avec Apple
Configuration iOS Facebook (guide Facebook général) - Configuration Facebook SDK

Résumé rapide - Ajouter à 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>

Suivez les guides liés pour obtenir les instructions de configuration complète d'iOS, y compris la configuration du projet Xcode.

Configuration Android

Pour obtenir des instructions de configuration détaillées d'Android, consultez nos guides spécifiques à la plateforme :

Configuration Android Google - Fingerprint SHA-1, configuration des services Google Play
Configuration Android Apple - Configuration de l'ID de service pour Android
Configuration Android Facebook (guide Facebook en général) - Intégration du SDK Facebook

Configuration Android essentielle:

1. Obtenez votre empreinte SHA-1 (obligatoire pour 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. Configurez AndroidManifest.xml - Ajoutez à 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. Ajoutez les ressources Facebook à 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>

Suivez les guides de la plateforme liée pour une configuration complète de l'Android, y compris la mise en place de Google Play Services et la configuration du nom de package.

Étape 9 : Utilisation de la base de données Supabase avec des utilisateurs authentifiés

Lorsque les utilisateurs sont authentifiés, vous pouvez utiliser la base de données Supabase avec la sécurité au niveau de la ligne (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;
  }
}

Considérations de sécurité importantes

Ne jamais exposer les clés sensibles en votre client code
Utilisez les variables d'environnement pour la configuration
Activer la sécurité au niveau de la ligne dans Supabase
Vérifier les jetons sur votre serveur de backend si nécessaire
Gérer le renouvellement automatique des jetons avec Supabase

Résoudre les problèmes courants

Erreurs de correspondance de jetons

Vérifiez que les configurations de votre fournisseur OAuth correspondent entre le plugin de connexion sociale et Supabase
Vérifiez que les URL de redirection sont correctement configurées

Problèmes spécifiques à la plateforme

iOS : Vérifiez que votre identifiant de bundle correspond à votre configuration Apple Developer
Android : Assurez-vous que les empreintes SHA1 sont correctement ajoutées à Google Console

Interruptions de flux d'authentification

Implémentez un traitement d'erreur approprié pour les problèmes de réseau
Ajoutez des états de chargement pendant l'authentification

Conclusion

Vous disposez maintenant d'un système d'authentification complet qui combine le backend robuste de Supabase avec les capacités de connexion sociale native. Cette configuration fournit :

Authentification sociale native sécurisée
Gestion de jetons sans heurt
Intégration de base de données en temps réel
Compatibilité plateforme croisée

La combinaison de Supabase et du plugin de connexion sociale Capgo offre une solution d'authentification puissante et scalable pour vos applications Capacitor.

For plus de fonctionnalités avancées comme l'authentification à plusieurs facteurs ou la documentation de Supabase et la documentation du plugin de connexion sociale Continuez à partir de Setup Supabase Authentication avec le plugin de connexion sociale __CAPGO_KEEP_0__ Si vous utilisez Setup Supabase Authentication avec le plugin de connexion sociale __CAPGO_KEEP_0__ .

multi-factor authentication Setup Supabase Authentication with Capacitor Social Login Plugin la documentation de Supabase @capgo/capacitor-connexion sociale pour les détails d'implémentation dans @capgo/capacitor-connexion sociale, @capgo/capacitor-passkey pour les détails d'implémentation dans @capgo/capacitor-passkey, @capgo/capacitor-authentification biométrique native pour les détails d'implémentation dans @capgo/capacitor-authentification biométrique native, L'authentification à deux facteurs pour les détails d'implémentation dans L'authentification à deux facteurs, et L'authentification unique (Entreprise) pour les détails d'implémentation dans L'authentification unique (Entreprise).

Configurer l'authentification Supabase avec le plugin de connexion sociale Capacitor

facilite grandement cela. Cette étape vous guidera à travers l'intégration de l'authentification sociale (Google, Apple, Facebook) avec Supabase dans votre application __CAPGO_KEEP_0__.