Supabase Google Login - 基本設定
インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。
はじめに
セクション「はじめに」このガイドでは、Capacitor Social Login プラグインを使用して、Supabase Authentication に Google Sign-In を統合する方法を説明します。この設定により、モバイルプラットフォームでネイティブの Google Sign-In を使用しながら、バックエンドの認証には Supabase Auth を活用できます。
前提条件
「前提条件」セクション開始する前に、以下を確認してください:
-
以下の Google Login の基本設定 Google OAuth 認証情報を設定するためのガイド
-
対象プラットフォームの Google OAuth 認証情報を設定するため、それぞれのプラットフォーム別ガイドに従った:
SupabaseでGoogle OAuthプロバイダーを有効にする
「Supabase で Google OAuth プロバイダーを有効にする」セクション-
以下に移動してください: Supabase ダッシュボード
-
プロジェクトをクリック
-
次に、以下に移動してください:
Authenticationメニュー
-
次の
Providersタブ
-
〜を探します
Googleプロバイダーを有効にする
-
プロバイダーを有効にする
-
使用するプラットフォームのクライアント ID を追加してください
-
次の
Saveボタンをクリックします
これで、Supabase Authentication を使用した Google Sign-In が有効になりました 🎉
Supabase Authentication Helperを使用したGoogle Sign-Inの仕組み
「Supabase Authentication Helperを使用したGoogle Sign-Inの仕組み」セクションこのセクションでは、Google Sign-InとSupabaseの連携が内部でどのように動作するかを解説します。このフローを理解すると、認証プロセスの実装やトラブルシューティングに役立ちます。
1. Nonceの生成
「1. Nonceの生成」セクション実装では、次の要件に従ってセキュアなnonceペアを生成します。 Supabaseのnonce要件:
// Generate URL-safe random noncefunction getUrlSafeNonce(): string { const array = new Uint8Array(32); crypto.getRandomValues(array); return Array.from(array, (byte) => byte.toString(16).padStart(2, '0')).join('');}
// Hash the nonce with SHA-256async function sha256Hash(message: string): Promise<string> { const encoder = new TextEncoder(); const data = encoder.encode(message); const hashBuffer = await crypto.subtle.digest('SHA-256', data); const hashArray = Array.from(new Uint8Array(hashBuffer)); return hashArray.map((b) => b.toString(16).padStart(2, '0')).join('');}
// Generate nonce pairasync function getNonce(): Promise<{ rawNonce: string; nonceDigest: string }> { const rawNonce = getUrlSafeNonce(); const nonceDigest = await sha256Hash(rawNonce); return { rawNonce, nonceDigest };}フロー:
rawNonce: URLセーフなランダム文字列(64文字の16進数)nonceDigest: SHA-256ハッシュ(対象:rawNonce)(16進エンコード)nonceDigestはGoogle Sign-Inに渡される → GoogleはIDトークンにnonceダイジェストを含めるrawNonceはSupabaseに渡される → Supabaseは生のnonceをハッシュ化し、トークンのnonceと比較する
2. Google サインイン
セクション「2. Google Sign-In」この関数はプラグインを初期化し、Googleでサインインします:
await SocialLogin.initialize({ google: { webClientId: 'YOUR_WEB_CLIENT_ID.apps.googleusercontent.com', // iOS only: iOSClientId: 'YOUR_IOS_CLIENT_ID.apps.googleusercontent.com', mode: 'online', // Required to get idToken },});
const response = await SocialLogin.login({ provider: 'google', options: { scopes: ['email', 'profile'], nonce: nonceDigest, // Pass the SHA-256 hashed nonce },});3. JWTの検証
セクション「3. JWT検証」Supabaseにトークンを送信する前に、実装はJWTトークンを検証します:
function validateJWTToken(idToken: string, expectedNonceDigest: string): { valid: boolean; error?: string } { const decodedToken = decodeJWT(idToken);
// Check audience matches your Google Client IDs const audience = decodedToken.aud; if (!VALID_GOOGLE_CLIENT_IDS.includes(audience)) { return { valid: false, error: 'Invalid audience' }; }
// Check nonce matches const tokenNonce = decodedToken.nonce; if (tokenNonce && tokenNonce !== expectedNonceDigest) { return { valid: false, error: 'Nonce mismatch' }; }
return { valid: true };}なぜSupabaseに送信する前に検証するのか?
Supabaseに送信する前にJWTトークンを検証することには、いくつかの重要な目的があります:
-
不正なリクエストの防止:audienceが正しくない、またはnonceが一致しない場合、Supabaseは結局トークンを拒否します。事前に検証すれば、不要な API 呼び出しを避け、より明確なエラーメッセージを返せます。
-
トークンキャッシュの問題:一部のプラットフォーム(特にiOS)では、パフォーマンス向上のためにGoogle Sign-In SDK がトークンをキャッシュすることがあります。キャッシュされたトークンが返されると、そのトークンが別のnonce(またはnonceなし)で生成されている可能性があり、Supabaseが「nonce mismatch」エラーでトークンを拒否します。Supabaseに送る前に検証することで、この問題を早期に検知し、新しいトークンで自動リトライできます。
-
セキュリティ (iOS): iOSでは、検証によりトークンがお使いのGoogle Client ID向けに発行されたことを確認でき、他のアプリ向けのトークンを使うことによる潜在的なセキュリティ問題を防げます。
-
エラーハンドリングの向上:Supabaseに送る前に問題を検知できるため、自動リトライロジックを実装できます。これはiOSのキャッシュ問題を透過的に処理するために不可欠です。
バリデーションに失敗した場合、関数は自動的に以下を実行します:
- Googleからログアウト(キャッシュされたトークンをクリア - iOSでは特に重要)
- 認証を1回リトライ(正しいnonceで新しいトークンの生成を強制)
- リトライも失敗した場合は、エラーを返します
4. Supabaseへのサインイン
「4. Supabase Sign-In」セクション最後に、検証済みのトークンがSupabaseに送信されます:
const { data, error } = await supabase.auth.signInWithIdToken({ provider: 'google', token: googleResponse.idToken, nonce: rawNonce, // Pass the raw (unhashed) nonce});Code リファレンス全文
「Code 完全リファレンス」セクション完全な実装は以下にあります: サンプルアプリの supabaseAuthUtils.ts 以下を含むファイル:
getUrlSafeNonce()- URLセーフなランダムnonceを生成sha256Hash()- SHA-256で文字列をハッシュ化getNonce()- nonceペアを生成decodeJWT()- JWTトークンをデコードvalidateJWTToken()- JWTのaudienceとnonceを検証authenticateWithGoogleSupabase()- 自動リトライ付きのメイン認証関数
追加のサンプルファイル
「Additional Example Files」セクション- SupabasePage.tsx - リダイレクト処理を含むコンポーネント例 (Web)
- SupabaseCreateAccountPage.tsx - アカウント作成ページの例
次のステップ
「次のステップ」セクション対象プラットフォーム別のセットアップガイドに進んでください:
Supabase Google Login - General Setupの続きへ
「Keep going from Supabase Google Login - General Setup」というタイトルのセクション使用している場合 Supabase Google Login - 基本設定 認証とアカウントフローを計画するには、これを次と連携させてください @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要素認証 二要素認証の実装の詳細については。