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

La mise en place de l'authentification dans les applications mobiles peut être complexe, mais la combinaison de Supabase avec le plugin de connexion sociale __CAPGO_KEEP_0__ Supabase avec le Capgo Social Login plugin facilite les choses. Cette tutrice vous guidera à travers l'intégration de l'authentification sociale (Google, Apple, Facebook) avec Supabase dans votre Capacitor application.

Supabase fournit un backend robuste en tant que service avec une authentification intégrée, tandis que le @capgo/capacitor-social-login plugin offre une authentification sociale native sur les plateformes iOS, Android et web. Pour une intégration Supabase plus serrée, @capgo/capacitor-supabase ajoute des aides d'authentification natives et un accès JWT. Ensemble, ils fournissent :

Une authentification sociale fluide
Une gestion sécurisée des jetons
Une compatibilité multi-plateforme
Une intégration de base de données en temps réel
Gestion des utilisateurs 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)

Tout d'abord, installez le plugin de connexion sociale Capgo :

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

Voir le Connexion sociale et Supabase pages de plugins pour la configuration spécifique à la plateforme.

Étape 2 : Configuration du projet Supabase

Créez et configurez votre projet Supabase

Créez un projet Supabase:
- Allez à supabase.com et vous inscrire/ vous connecter
- Cliquez sur “Nouveau projet”
- Choisissez votre organisation
- Entrez un Nom de projet Par exemple, « MonApp Auth »
- Configurez un Mot de passe de base de données Enregistrez ceci en toute sécurité
- Sélectionnez votre Région Sélectionnez la plus proche de vos utilisateurs
- 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 compte public anonyme API clé
- Sauvegardez ces informations 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:
  - Enregistrer URL du site à l'URL de votre application (par exemple, https://yourdomain.com ou http://localhost:3000 pour le développement)
  - Ajouter des URL de redirection si nécessaire : Configurer les paramètres de messagerie
```
http://localhost:3000
https://yourdomain.com
capacitor://localhost (for mobile apps)
```
(facultatif mais recommandé :) Sous
- Configurez les paramètres de messagerie (facultatif mais recommandé) : Paramètres SMTP, configurez votre fournisseur d'e-mail
- Cela active les confirmations par e-mail et les réinitialisations de mot de passe
- Pour le développement, vous pouvez utiliser le service d'e-mail intégré

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

Configurez maintenant chaque fournisseur social en détail :

Configuration de l'authentification Google dans Supabase

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

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

Ce guide couvre :

Créer un projet Google Cloud
Configurer les clés OAuth 2.0 pour les applications web, iOS et Android
Configurer l'écran de consentement
Obtenir les identifiants et les 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 activez-le ACTIVÉ
- Remplissez les informations de configuration :
  - ID 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 (remplie automatiquement)
- Cliquez “Sauvegarder”

Important: Utilisez le ID du client Web et Web Client Secret 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

Obtenir les informations d'identification Apple :

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

Ce guide couvre :

Configuration de votre compte développeur Apple
Création d'identifiants d'application et d'identifiants de service
Configuration de la capacité de connexion avec 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 Apple SUR
- Remplissez les informations de configuration :
  - ID client : votre identifiant d'instance de Service (par exemple,Secret client com.yourapp.signin)
  - __CAPGO_KEEP_0__: Générez ce JWT à l'aide de votre clé privée Apple (voir Documentation Apple Supabase pour le format JWT)
  - URL de redirection: https://your-project-ref.supabase.co/auth/v1/callback (remplie automatiquement)
- Cliquez “Sauvegarder”

Remarque: 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 compte Facebook :

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

Cette guide couvre :

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

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

Activer le fournisseur Facebook dans Supabase:
- Allez à Authentification > Fournisseurs et basculez Facebook Actif
- Remplir la 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 (remplie automatiquement)
- Cliquez « Enregistrer »

Important: Assurez-vous d'ajouter l'URL de rappel Supabase (https://your-project-ref.supabase.co/auth/v1/callback) à votre application Facebook Valides URIs de redirection OAuth dans les paramètres de connexion Facebook.

Notes importantes de configuration de Supabase

Contrôle de sécurité au niveau de la ligne (RLS) :

Après avoir configuré l'authentification, activez RLS sur vos tables
Allez à Base de données > Tables et basculez 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 :

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

Test de la configuration :

Utilisez l'outil de test d'authentification intégré de Supabase
Allez à Authentification > Utilisateurs et cliquez “Invitez l'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 a besoin des informations d'authentification OAuth des fournisseurs d'origine (pas de Supabase), tandis que Supabase gère l'authentification côté serveur.

How the Authentication Flow Works

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 en utilisant 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 du client Web pour tous les plateformes et optionnellement un ID du 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 ID du client Web (pas les identifiants clients Android/iOS) pour le webClientId champ
Le plugin fonctionnera sur toutes les plateformes avec seulement l'ID du client Web
The iOSClientId est optionnel et n'est utilisé que pour les fonctionnalités Google spécifiques à iOS

Configuration du plugin Apple

La configuration d'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 (nécessite 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 le Signe d'Apple natif (aucune configuration supplémentaire nécessaire)
Android/Web nécessite l'ID de service que vous avez créé dans le portail Apple Developer
The redirectUrl correspond à ce que vous avez configuré dans les deux Apple Developer Portal et Supabase

Configuration du plugin Facebook

Le 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 la fonctionnalité de connexion limitée du Facebook, axée sur la vie privée (iOS uniquement)
ImportantVoir notre guide de configuration Facebook pour des informations détaillées sur la connexion limitée, y compris les considérations ATT

Initialisation complète du plugin

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

Remarques 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'origine, et non de Supabase
Assurez-vous que les informations d'identification du fournisseur correspondent à celles que vous avez configurées dans Supabase

Étape 5 : Configuration du 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 le 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 au plateforme

Configuration iOS

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

Configuration iOS Google - Schemes de URL, configuration de Info.plist
Configuration iOS Apple - Configuration de l'authentification Apple
Configuration de Facebook iOS (guide général de Facebook) - Configuration de 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 des instructions de configuration complète d'iOS, y compris la configuration du projet Xcode.

Configuration d'Android

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

Configuration de Google Android - Impressions de doigts SHA-1, configuration de Google Play Services
Configuration d'Android Apple - Configuration de l'ID de service pour Android
Configuration de Facebook Android (guide général de Facebook) - Intégration de Facebook SDK

Configuration Android essentielle:

1. Obtenez votre empreinte SHA-1 (nécessaire 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 - Ajouter à 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 suivre les guides de plateforme liés pour une configuration Android complète, y compris la configuration des services Google Play et du nom de package. 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>

suivre les guides de plateforme liés pour une configuration Android complète, y compris la configuration des services Google Play et du nom de package.

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

Une fois les utilisateurs authentifiés, vous pouvez utiliser la base de données Supabase avec la sécurité de niveau de 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

Jamais exposer les clés sensibles dans votre client code
Utilisez les variables d'environnement pour la configuration
Activer la sécurité de niveau de ligne dans Supabase
Valider les jetons sur votre serveur de backend si nécessaire
Gérer le renouvellement de jetons automatiquement avec Supabase

Résolution des problèmes courants

Erreurs de correspondance de jeton

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 ID de bundle correspond à votre configuration Apple Developer
Android : Assurez-vous que les empreintes SHA1 sont correctement ajoutées à Google Console

Interruptions de la chaîne d'authentification

Implémentez une gestion des erreurs appropriée 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 des capacités de connexion sociale native.

Une authentification sociale native sécurisée
Gestion des jetons sans heurt
Intégration de la base de données en temps réel
Compatibilité multi-plateforme

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

Pour plus de fonctionnalités avancées comme l'authentification à plusieurs facteurs ou des revendications personnaliséesconsultez la documentation de Supabase. Supabase documentation et le Documentation du plugin de connexion sociale.

Si vous utilisez Setup Supabase Authentication avec Capacitor Plugin de connexion sociale pour planifier l'authentification et les flux de compte, connectez-le avec @capgo/capacitor-social-login pour les détails d'implémentation dans @capgo/capacitor-social-login, @capgo/capacitor-passkey pour les détails d'implémentation dans @capgo/capacitor-passkey, @capgo/capacitor-native-biometric pour les détails d'implémentation dans @capgo/capacitor-native-biometric, Authentification à deux facteurs pour le détail d'implémentation dans Authentification à deux facteurs, et SSO (Entreprise) pour le détail d'implémentation dans SSO (Entreprise).