メインコンテンツへスキップ

Supabase Google Login - 基本設定

GitHub

このガイドでは、Capacitor Social Login プラグインを使用して、Supabase Authentication に Google Sign-In を統合する方法を説明します。この設定により、モバイルプラットフォームでネイティブの Google Sign-In を使用しながら、バックエンドの認証には Supabase Auth を活用できます。

開始する前に、以下を確認してください:

  1. Supabase プロジェクトを作成済み

  2. 以下の Google Login の基本設定 Google OAuth 認証情報を設定するためのガイド

  3. 対象プラットフォームの Google OAuth 認証情報を設定するため、それぞれのプラットフォーム別ガイドに従った:

SupabaseでGoogle OAuthプロバイダーを有効にする

「Supabase で Google OAuth プロバイダーを有効にする」セクション
  1. 以下に移動してください: Supabase ダッシュボード

  2. プロジェクトをクリック

    Supabase プロジェクト選択
  3. 次に、以下に移動してください: Authentication メニュー

    Supabase 認証メニュー
  4. 次の Providers タブ

    Supabase Providers タブ
  5. 〜を探します Google プロバイダーを有効にする

    Supabase Google プロバイダー
  6. プロバイダーを有効にする

    Supabase Google Provider の有効化
  7. 使用するプラットフォームのクライアント ID を追加してください

    Supabase Google Provider にクライアント ID を追加
  8. 次の Save ボタンをクリックします

    Supabase Google プロバイダーの保存

これで、Supabase Authentication を使用した Google Sign-In が有効になりました 🎉

Supabase Authentication Helperを使用したGoogle Sign-Inの仕組み

「Supabase Authentication Helperを使用したGoogle Sign-Inの仕組み」セクション

このセクションでは、Google Sign-InとSupabaseの連携が内部でどのように動作するかを解説します。このフローを理解すると、認証プロセスの実装やトラブルシューティングに役立ちます。

実装では、次の要件に従ってセキュアなnonceペアを生成します。 Supabaseのnonce要件:

// Generate URL-safe random nonce
function 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-256
async 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 pair
async 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と比較する

この関数はプラグインを初期化し、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
},
});

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トークンを検証することには、いくつかの重要な目的があります:

  1. 不正なリクエストの防止:audienceが正しくない、またはnonceが一致しない場合、Supabaseは結局トークンを拒否します。事前に検証すれば、不要な API 呼び出しを避け、より明確なエラーメッセージを返せます。

  2. トークンキャッシュの問題:一部のプラットフォーム(特にiOS)では、パフォーマンス向上のためにGoogle Sign-In SDK がトークンをキャッシュすることがあります。キャッシュされたトークンが返されると、そのトークンが別のnonce(またはnonceなし)で生成されている可能性があり、Supabaseが「nonce mismatch」エラーでトークンを拒否します。Supabaseに送る前に検証することで、この問題を早期に検知し、新しいトークンで自動リトライできます。

  3. セキュリティ (iOS): iOSでは、検証によりトークンがお使いのGoogle Client ID向けに発行されたことを確認でき、他のアプリ向けのトークンを使うことによる潜在的なセキュリティ問題を防げます。

  4. エラーハンドリングの向上:Supabaseに送る前に問題を検知できるため、自動リトライロジックを実装できます。これはiOSのキャッシュ問題を透過的に処理するために不可欠です。

バリデーションに失敗した場合、関数は自動的に以下を実行します:

  1. Googleからログアウト(キャッシュされたトークンをクリア - iOSでは特に重要)
  2. 認証を1回リトライ(正しいnonceで新しいトークンの生成を強制)
  3. リトライも失敗した場合は、エラーを返します

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

完全な実装は以下にあります: サンプルアプリの supabaseAuthUtils.ts 以下を含むファイル:

  • getUrlSafeNonce() - URLセーフなランダムnonceを生成
  • sha256Hash() - SHA-256で文字列をハッシュ化
  • getNonce() - nonceペアを生成
  • decodeJWT() - JWTトークンをデコード
  • validateJWTToken() - JWTのaudienceとnonceを検証
  • authenticateWithGoogleSupabase() - 自動リトライ付きのメイン認証関数

追加のサンプルファイル

「Additional Example Files」セクション

対象プラットフォーム別のセットアップガイドに進んでください:

使用している場合 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要素認証 二要素認証の実装の詳細については。