iOSでのSupabase Google Login
インストール手順と、このプラグインの完全なMarkdownガイドを含むセットアッププロンプトをコピーします。
はじめに
セクション「はじめに」このガイドでは、iOSでGoogle Sign-InをSupabase Authenticationと連携させる方法を解説します。以下の手順は完了しているものとします:
実装方法
「実装」セクション完全な実装は以下にあります: サンプルアプリの 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);}仕組み
「仕組み」セクション認証フローの詳細な仕組み(nonce の生成、JWT の検証、Supabase へのサインインを含む)については、 General Setup ガイドの How It Works セクションを参照してください.
重要な注意点
「Important Caveats」セクションiOSのトークンキャッシュとNonceの問題
「iOS Token Caching and Nonce Issues」セクションiOS の Nonce キャッシュ問題
iOS では、Google Sign-In がトークンをキャッシュするため、nonce の検証に失敗することがあります。 validateJWTToken 関数がこれを検出し、自動的に処理します:
- 自動検出:関数は、トークン内の nonce が期待値と一致するかチェックします
nonceDigest - 自動リトライ:検証に失敗した場合、Google から自動的にログアウトし、1 回リトライします
- エラーハンドリング:リトライも失敗した場合、エラーが返されます
発生原因:iOS の Google Sign-In SDK はパフォーマンスのためにトークンをキャッシュします。キャッシュされたトークンが返された場合、異なる nonce(または nonce なし)で生成された可能性があり、不一致が発生します。
解決策:実装は、ログアウトしてリトライすることで自動的にこれを処理し、Google に正しい nonce を持つ新しいトークンを生成させます。
手動での回避策 (自動リトライが機能しない場合):
// Logout first to clear cached tokensawait SocialLogin.logout({ provider: 'google' });
// Then authenticateconst result = await authenticateWithGoogleSupabase();これにより、正しい nonce を使用して新しいトークンを取得できます。
完全な code リファレンスについては、こちらを参照してください。 General SetupガイドのCodeリファレンスセクションを完成させてください.
重要な注意事項
「重要事項」セクション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のパラメータ
自動リトライの仕組み
「自動リトライ機構」セクションこの authenticateWithGoogleSupabase 関数は retry パラメータ:
- 初回呼び出し (
retry=false): 検証に失敗した場合、自動的にログアウトして1回リトライします - リトライ呼び出し (
retry=true): 検証が再度失敗した場合、即座にエラーを返します
これにより、iOS のトークンキャッシュの問題が自動的に処理されます。
トラブルシューティング
「トラブルシューティング」セクション認証に失敗した場合:
- Nonce の不一致): 関数は自動的にリトライします - 詳細はコンソールログを確認してください。問題が継続する場合は、まず手動でログアウトしてください
- audienceが無効): Google Cloud Console と Supabase の両方で Google Client ID が一致していることを確認してください(iOS と Web の Client ID 両方)
- トークン検証に失敗): 使用していることを確認してください
mode: 'online'を initialize 呼び出しで使用して idToken を取得します - Info.plist の設定:Info.plist に正しい URL スキームと GIDClientID が設定されていることを確認してください
- 以下を確認してください: サンプルアプリ code 参考用
iOSでSupabase Google Loginから続行する
セクションタイトル「Supabase Google Login on iOS から続ける」使用している場合 iOSでの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要素認証 二要素認証の実装の詳細については。