Setup Supabase 认证 with Capacitor 社会登录插件

在移动应用中设置身份验证可能会很复杂，但结合 Supabase 和 Capgo makes it straightforward. This tutorial will guide you through integrating social authentication (Google, Apple, Facebook) with Supabase in your Capacitor app.

__CAPGO_KEEP_0__ 应用中 @capgo/capacitor-social-login 为什么要使用 Supabase 与社交登录？ @capgo/capacitor-supabase 提供了一个强大的后端服务，内置身份验证，而

无缝的社交认证
安全令牌管理
跨平台兼容性
实时数据库集成
内置用户管理

前提条件

开始之前，请确保您有：

一个 Capacitor 项目设置
一个 Supabase 帐户和项目
您选择的社交提供商的开发者帐户（Google、Apple、Facebook）

首先，安装 Capgo 社交登录插件：

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

参见 Social Login 和 Supabase 插件页面，了解平台特定的设置。

步骤 2：设置 Supabase 项目

创建和配置您的 Supabase 项目

创建一个 Supabase 项目:
- 前往 supabase.com 并注册/登录
- 点击 {
- targetLanguage
- "Simplified Chinese" protectedTokens ["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"]
- texts ["","","","","","","","","",""] }
- "新项目" "选择您的组织" "输入一个"
- "项目名称" “创建新项目”
获取您的项目凭证:
- 创建后，请前往 设置 > API
- 复制您的 项目 URL (例如 https://your-project-ref.supabase.co)
- 复制您的 匿名公共 API 密钥
- 将这些信息保存起来，以便在您的应用中使用

配置身份验证设置

设置通用身份验证设置:
- 前往 身份验证 > 设置
- 在 通用设置:
  - 设置 站点URL 到您的应用程序URL（例如， https://yourdomain.com 或 http://localhost:3000 用于开发
  - 添加额外的 重定向URL 如需:
```
http://localhost:3000
https://yourdomain.com
capacitor://localhost (for mobile apps)
```
配置电子邮件设置 (可选但推荐):
- 在 SMTP 设置,配置您的电子邮件提供商
- 这会启用电子邮件确认和密码重置
- 对于开发，您可以使用内置的电子邮件服务

访问提供商部分:
- 转到 身份验证 > 提供商 __CAPGO_KEEP_0__
- 您将在 Supabase 控制台中看到可用的社交提供者的列表
- 每个提供者都有一个启用开关和配置选项

现在，让我们详细配置每个社交提供者：

在 Supabase 中设置 Google 认证

首先，获取您的 Google OAuth 凭证：

请遵循我们的全面 Google 设置指南： Google 认证设置

本指南涵盖：

创建 Google Cloud 项目
为 web、iOS 和 Android 设置 OAuth 2.0 凭据
配置-consent 屏幕
获取所需的客户端 ID 和密钥

完成 Google 设置后，在 Supabase 中配置它：

在 Supabase 中启用 Google 提供者:
- 在 Supabase 控制台中，转到 身份验证 > 提供者
- 找到 Google 并切换到打开
- 填写配置:
  - __CAPGO_KEEP_0__: 您的 Google OAuth Web __CAPGO_KEEP_1__ (从 Google Cloud Console 中获取)
  - __CAPGO_KEEP_2__: 您的 Google OAuth Web __CAPGO_KEEP_3__
  - 重定向 URL: https://your-project-ref.supabase.co/auth/v1/callback (自动填充)
- 点击保存

重要: 在 Supabase 中使用 Web Client ID 和 Web Client Secret 即使您正在构建移动应用程序，也要在 Supabase 中使用它们。移动客户端 ID 在插件配置中单独使用。

在 Supabase 中设置 Apple 认证

获取 Apple 凭证：

遵循我们的详细 Apple 设置指南： Apple 认证设置

本指南涵盖：

设置 Apple 开发者帐户
创建 App IDs 和 Service IDs
配置 Sign in with Apple 功能
生成所需的私钥
适用于 iOS、Android 和 Web 的平台特定设置

完成 Apple 设置后，在 Supabase 中配置：

在 Supabase 中启用 Apple 提供者：:
- 前往 Authentication > Providers 并切换 Apple 开启
- 填写配置：
  - Client ID：您的服务 ID 标识符（例如， com.yourapp.signin)
  - Client Secret：使用您的 Apple 私钥生成此 JWT（参见 Supabase Apple 文档中 JWT 格式)
  - Redirect URL: https://your-project-ref.supabase.co/auth/v1/callback （自动填充)
- 点击 “保存”

注意: Apple认证设置是最复杂的，因为Apple要求Service ID、私钥和JWT生成。请仔细阅读每个平台的文档。

在Supabase中设置Facebook认证

获取Facebook凭证：

请遵循我们的完整Facebook设置指南： Facebook认证设置

本指南涵盖：

创建Facebook开发者帐户和应用
添加Facebook登录产品
配置OAuth重定向URI
获取您的App ID、App Secret和Client Token
iOS和Android平台的特定配置

完成Facebook设置后，请在Supabase中配置它：

启用 Facebook 提供者在 Supabase 中:
- 前往 身份验证 > 提供者 并切换 Facebook 开启
- 填写配置：
  - 客户端 ID: 您的 Facebook App ID
  - 客户端密钥: 您的 Facebook App Secret
  - 重定向 URL: https://your-project-ref.supabase.co/auth/v1/callback (auto-filled)
- Click “保存”

重要：确保在Facebook应用的https://your-project-ref.supabase.co/auth/v1/callback中添加Supabase回调URL（） Facebook登录设置中的有效OAuth重定向URI

重要的Supabase配置注意事项

行级安全性（RLS）：

在设置身份验证后，启用表格的RLS
前往 数据库 > 表 和切换 启用 RLS 每个表
根据已验证用户创建策略来控制数据访问

用户管理：

查看已验证用户在 身份验证 > 用户
在身份验证事件中监控 身份验证 > 日志
设置电子邮件模板 身份验证 > 电子邮件模板

测试配置:

使用 Supabase 内置的身份验证测试工具
前往 身份验证 > 用户 并点击 “Invite user” 测试电子邮件流程
检查日志部分以查看身份验证错误

现在，需要使用相应凭证配置 Social Login 插件重要: 需要从 原生提供商 (而不是 Supabase),获取 OAuth 凭据

如何工作的身份验证流程

在配置之前，了解流程：

插件与社交提供商 (Google/Apple/Facebook) natively
插件从提供商接收令牌
您的应用程序将这些令牌 发送到 Supabase signInWithIdToken()
Supabase 验证 与提供者验证令牌并创建用户会话
Supabase 返回 为您的应用程序的已认证请求提供自己的 JWT 令牌

Google 插件配置

插件需要您的 Web 客户端 ID 所有平台和可选地 iOS 客户端 ID iOS 特定功能： Google 的关键点：

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

使用

Capgo 验证 Web Client ID (不是 Android/iOS 客户端 ID) 用于 webClientId 字段
仅需 Web Client ID 即可在所有平台上使用该插件
The iOSClientId 是可选的，仅用于 iOS 特有的 Google 功能

Apple 插件配置

Apple 配置在 iOS 和 Android 之间有所不同:

对于 iOS (原生 Apple 登录):

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

对于 Android/Web (需要 Service ID):

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

Apple 的关键点：

iOS 使用原生 Sign in with Apple（无需额外配置）
Android/Web 需要您在 Apple Developer Portal 中创建的 Service ID
应与您在 Apple Developer Portal 和 Supabase 中配置的内容一致 redirectUrl Facebook 插件配置

Facebook 需要您的 App ID 和 Client Token：

Facebook 的关键点：

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

使用您在 Supabase 中配置的相同 App ID

Client Token 可在您的 Facebook App 的基本设置中找到
启用 Facebook 的 privacy-focused Limited Login 功能（仅限 iOS）
limitedLogin: true 重要
__CAPGO_KEEP_0__: Facebook 详细的有限登录信息，包括ATT考虑

完成插件初始化

以下是如何初始化所有提供者：

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

重要注意事项：

在应用启动时调用 initialize() 一次而不是在每次登录前
您只需要配置您计划使用的提供者
以下凭据来自 原始提供者, 不是来自 Supabase
确保提供者凭证与您在 Supabase 中配置的内容匹配

步骤 5: 配置 Supabase 客户端

安装 Supabase 客户端：

npm install @supabase/supabase-js

创建 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,
  },
});

步骤 6: 实现身份验证流程

创建一个结合了两者的身份验证服务：

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

步骤 7: 在您的应用中实现

初始化服务并处理身份验证：

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

在您的 UI 中创建登录按钮：

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

步骤 8: 平台特定配置

iOS 配置

For detailed iOS setup instructions, see our platform-specific guides:

Google iOS Setup - URL schemes, Info.plist configuration
Apple iOS Setup - Sign in with Apple capability setup
Facebook iOS Setup (in general Facebook guide) - Facebook SDK configuration

Quick summary - Add to 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>

Follow the linked guides for complete iOS setup instructions including Xcode project configuration.

Android Configuration

详细的Android设置指南，请参见我们的平台特定指南：

Google Android设置 - SHA-1指纹，Google Play Services配置
Apple Android设置 - Android服务ID配置
Facebook Android设置 (一般Facebook指南) - Facebook SDK集成

Android设置:

1. 获取SHA-1指纹 (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. 配置AndroidManifest.xml - 添加到 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. 添加 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>

请遵循相关平台指南，完成 Android 配置，包括 Google Play Services 的设置和包名配置。

步骤 9：使用 Supabase 数据库与已验证用户

一旦用户验证成功，您就可以使用 Supabase 的数据库，带有行级安全性 (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;
  }
}

重要安全注意事项

绝不暴露敏感密钥 在客户端 code
使用环境变量 进行配置
启用行级安全性 在 Supabase 中
验证令牌 如果需要在您的后端验证令牌
使用 Supabase 自动刷新令牌 常见问题排查

令牌匹配错误

确保您的社交登录插件和 Supabase 之间的 OAuth 提供商配置匹配

检查重定向 URL 是否正确配置
平台特定问题

iOS：验证您的 bundle ID 与 Apple Developer 配置匹配

Android：确保 SHA1 指纹正确添加到 Google Console 中
在 Supabase 中

认证流程中断

网络问题时正确处理错误
在认证期间添加加载状态

结论

您现在已经拥有一个结合了 Supabase 强大的后端和原生社交登录功能的完整认证系统。这个设置提供:

安全的原生社交认证
无缝的令牌管理
实时数据库集成
跨平台兼容性

Supabase 和 Capgo 社交登录插件的结合提供了一个强大的、可扩展的认证解决方案，适用于您的 Capacitor 应用。

如需更高级的功能，如 多因素认证 或自定义声明 ,查看Supabase 文档和 Social Login 插件文档继续从设置 Supabase 认证与 __CAPGO_KEEP_0__ 社交登录插件.

设置 Supabase 认证与 __CAPGO_KEEP_0__ 社交登录插件 Setup Supabase Authentication with Capacitor Social Login Plugin @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-social-login 查看 @capgo/capacitor-social-login 中的实现细节查看 @capgo/capacitor-social-login @capgo/capacitor-passkey 为 @capgo/capacitor-passkey 的实现细节 @capgo/capacitor-native-biometric 为 @capgo/capacitor-native-biometric 的实现细节双因素认证双因素认证的实现细节， SSO (企业版) SSO (企业版) 的实现细节，

使用Capacitor社交登录插件设置Supabase身份验证

可以轻松实现。这个教程将指导您如何在

前提条件

步骤 1：安装和配置社交登录插件

步骤 2：设置 Supabase 项目

创建和配置您的 Supabase 项目

配置身份验证设置

启用社交身份验证提供商

步骤 3：在 Supabase 中配置社交提供者

在 Supabase 中设置 Google 认证

在 Supabase 中设置 Apple 认证

在Supabase中设置Facebook认证

重要的Supabase配置注意事项

步骤 4: 配置社交登录插件

如何工作的身份验证流程

Google 插件配置

Apple 插件配置

Facebook 需要您的 App ID 和 Client Token：

完成插件初始化

步骤 5: 配置 Supabase 客户端

步骤 6: 实现身份验证流程

步骤 7: 在您的应用中实现

步骤 8: 平台特定配置

iOS 配置

Android Configuration

步骤 9：使用 Supabase 数据库与已验证用户

重要安全注意事项

令牌匹配错误

确保您的社交登录插件和 Supabase 之间的 OAuth 提供商配置匹配

iOS：验证您的 bundle ID 与 Apple Developer 配置匹配

认证流程中断

结论

Keep going from Setup Supabase Authentication with Capacitor Social Login Plugin