WebでのSupabase Googleログイン
インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。
はじめに
セクション「はじめに」このガイドでは、Web 上で Supabase Authentication に Google Sign-In を統合する方法を説明します。以下の作業が完了していることを前提としています:
実装方法
「実装」セクション完全な実装は以下にあります: サンプルアプリの supabaseAuthUtils.ts ファイル。このガイドでは主要な概念と使い方を説明します。
Authentication Helperの使用方法
「Authentication Helperの使用方法」セクションこの authenticateWithGoogleSupabase 関数が認証フロー全体を処理します:
import { authenticateWithGoogleSupabase } from './supabaseAuthUtils';
const result = await authenticateWithGoogleSupabase();if (result.success) { console.log('Signed in:', result.user); // Navigate to your authenticated area} else { console.error('Error:', result.error);}重要: リダイレクト処理
セクション「重要: リダイレクト処理」重要: リダイレクト処理
WebでGoogleログインを使う場合、 必ず リダイレクトが発生したタイミングでプラグインの関数を呼び出してプラグインを初期化してください。これにより、プラグインがリダイレクトを処理し、ポップアップウィンドウを閉じることができます。呼び出す関数は次のいずれかです: isLoggedIn() または initialize() - どちらもリダイレクト処理をトリガーします。
OAuth ポップアップフローが正しく動作するために不可欠です。
実装例
「実装例」セクションGoogle サインインを処理するコンポーネントに以下を追加します:
import { useEffect } from 'react';import { SocialLogin } from '@capgo/capacitor-social-login';
function SupabasePage() { // Check Google login status on mount to invoke redirect handling // This doesn't serve any functional purpose in the UI but ensures // that any pending OAuth redirects are properly processed useEffect(() => { const checkGoogleLoginStatus = async () => { try { await SocialLogin.isLoggedIn({ provider: 'google' }); // We don't use the result, this is just to trigger redirect handling } catch (error) { // Ignore errors - this is just for redirect handling console.log('Google login status check completed (redirect handling)'); } };
checkGoogleLoginStatus(); }, []);
// ... rest of your component}詳細については、 SupabasePage.tsx 完全な例については。
仕組み
「仕組み」セクションnonce 生成、JWT 検証、Supabase サインインを含む認証フローの詳細な説明については、 一般セットアップガイドの「仕組み」セクション.
完全な code リファレンスについては、こちらを参照してください。 General SetupガイドのCodeリファレンスセクションを完成させてください.
関連項目:
- SupabasePage.tsx - リダイレクト処理を含むコンポーネント例
- SupabaseCreateAccountPage.tsx - アカウント作成ページの例
重要な注意事項
「重要事項」セクションリダイレクト処理
「リダイレクト処理」セクションWebでGoogleログインを使う場合、 必ず リダイレクトが発生したタイミングでプラグインの関数を呼び出してプラグインを初期化してください。これにより、プラグインがリダイレクトを処理し、ポップアップウィンドウを閉じることができます。呼び出す関数は次のいずれかです: isLoggedIn() または initialize() - どちらもリダイレクト処理をトリガーします。
これはOAuthポップアップフローが正しく動作するために不可欠です。これがないと、認証後にポップアップウィンドウが閉じません。
Nonceの処理
「Nonceの処理」というセクションNonceの実装は、以下のパターンに従います: React Native Google Sign Inのドキュメント:
rawNonceSupabaseの〜に送られますsignInWithIdToken()- Supabaseは〜をハッシュ化し、
rawNonceそれを〜と比較しますnonceDigestこれはGoogle Sign-InのIDトークンに含まれています nonceDigest(SHA-256ハッシュ、16進数エンコード) が〜へ送信されますnonceGoogle Sign-In APIのパラメータ
自動リトライ
「Automatic Retry」セクション実装には以下の自動リトライロジックが含まれています:
- 初回のJWT検証に失敗した場合、ログアウトして1回リトライします
- これにより、キャッシュされたトークンのnonceが正しくないケースに対応します
- リトライも失敗した場合は、エラーが返されます
トラブルシューティング
「トラブルシューティング」セクション認証に失敗した場合:
- リダイレクトが動作しない: を呼び出していることを確認してください
isLoggedIn()コンポーネントのマウント時(上記の例を参照) - audienceが無効: Google Cloud ConsoleとSupabaseの両方で、Google Client IDが一致していることを確認してください
- 承認済みリダイレクト URL:Google Cloud Console と Supabase の両方で承認済みリダイレクト URL が設定されていることを確認してください
- Nonce の不一致:コンソールのログを確認してください。関数は自動的にリトライしますが、必要に応じて先に手動でログアウトできます
- Token の検証に失敗:次を使用していることを確認してください
mode: 'online'を initialize 呼び出しで使用して idToken を取得します - 以下を確認してください: サンプルアプリ code 参考用
Web版Supabase Googleログインから続行する
セクション「Web版Supabase Googleログインから続行する」使用している場合 WebでのSupabase Googleログイン 認証とアカウントフローを計画するには、これを次と連携させてください @capgo/capacitor-social-login の使用 「@capgo/capacitor-social-login の使用」のネイティブ機能のために、 @capgo/capacitor-social-login @capgo/capacitor-social-login の実装の詳細については、 @capgo/capacitor-passkey @capgo/capacitor-passkey の実装詳細については、 @capgo/capacitor-native-biometric @capgo/capacitor-native-biometric の実装の詳細、および 2要素認証 二要素認証の実装の詳細については。