SupabaseのAppleログインを継続して実行する
このプラグインのインストール手順とマークダウンガイドの全てを含む設定プロンプトをコピーする。
前提条件
「前提条件」このガイドでは、AndroidでApple Sign-InをSupabase Authenticationと統合する方法を説明します。Apple Sign-InをAndroidで使用するには、既に以下のことを完了していることを前提としています。
ステップ 1: バックエンドエッジ関数をデプロイする
「ステップ 1: バックエンドエッジ関数をデプロイする」最初に、Apple OAuthコールバックを処理するSupabase Edge Functionをデプロイする必要があります。
-
Supabaseプロジェクトディレクトリに移動してください
ターミナルウィンドウ cd your-project/supabase -
エッジ関数を作成します (存在しない場合)
ターミナルウィンドウ supabase functions new apple-signin-callback -
エッジ関数をコピーします: code
完全なエッジ関数実装は、 例のアプリ.
次のファイルをプロジェクトにコピーしてください:
supabase/functions/apple-signin-callback/index.ts- メインエッジ関数: codesupabase/functions/apple-signin-callback/deno.json- 依存関係のインポートマップ (含むjoseライブラリの JWT 署名用
-
JWT の検証を設定
Apple の OAuth コールバックエンドは、Apple がリダイレクトするため、パブリックでなければなりません (認証が必要ありません)。 Apple の OAuth リダイレクトが Supabase の認証ヘッダーを含まないため、ファイルを更新してください:
supabase/config.tomlクリップボードにコピー[functions.apple-signin-callback]enabled = trueverify_jwt = false # Important: Set to false for public OAuth callbackimport_map = "./functions/apple-signin-callback/deno.json"entrypoint = "./functions/apple-signin-callback/index.ts" -
ターミナル画面
Terminal window supabase functions deploy apple-signin-callback -
関数 URLを取得
デプロイ後、次のようになります:
https://your-project-ref.supabase.co/functions/v1/apple-signin-callback見つけることができない場合は、以下の手順を実行してください。
- 開く
https://supabase.com/dashboard/project/YOUR_PROJECT_REF/functions - 関数 URLをクリックしてコピーします。
apple-signin-callbackSupabase Functions Apple Sign-In Callback
- 開く
Step 2: Apple Developer Portalの設定
「Step 2: Apple Developer Portalの設定」ここで、バックエンドURLと必要な値を取得するためにApple Developer Portalを設定する必要があります。
-
Apple Login Androidのセットアップガイドに従ってください
「Apple Login Androidのセットアップガイド」を完了してください を参照してください: サービスIDを作成する
- プライベートキー(.p8ファイル)を生成する
- Function URL
- CapgoのTeam IDとKey IDを取得
- リターンURLを設定
-
Apple Developer PortalでリターンURLを設定
Apple Developer PortalでリターンURLを設定する際 (Appleガイドのステップ6.9)、Capgoのエッジ関数URLを使用してください:
https://your-project-ref.supabase.co/functions/v1/apple-signin-callback重要: Capgoのエッジ関数URLを使用してください
使用しないでください Apple Login Android セットアップガイドから リダイレクトURLを取得しないでくださいそのガイドではカスタムバックエンドサーバーURLを使用しています。Capgoの統合の場合、 Capgoのエッジ関数URLを使用する必要があります。 Capgo
-
必要な値をすべて収集する
Appleの設定ガイドを完了した後、以下の値を取得する必要があります:
- APPLE_TEAM_ID: Apple Developer Portalから取得するApple Developer Team ID
- APPLE_KEY_ID: Apple Developer Portalから取得するKey ID
- APPLE_PRIVATE_KEY:
- ANDROID_SERVICE_ID:
com.example.app.service) - BASE_REDIRECT_URL:
capgo-demo-app://path)
Step 3: Supabase Secretsを設定する
セクションのタイトル “Step 3: Supabase Secrets”ここでは、Supabase Edge Functionの環境変数(シークレット)を設定する必要があります。
-
プライベートキーをエンコードする
まず、Appleのプライベートキー(.p8ファイル)をbase64にエンコードしてください:
ターミナル画面 base64 -i AuthKey_XXXXX.p8コピーする必要があるのは、出力全体(長い単一の文字列)です。
-
SupabaseのCLIでシークレットを設定する
ターミナル画面 supabase secrets set APPLE_TEAM_ID=your_team_idsupabase secrets set APPLE_KEY_ID=your_key_idsupabase secrets set APPLE_PRIVATE_KEY=your_base64_encoded_keysupabase secrets set ANDROID_SERVICE_ID=your.service.idsupabase secrets set BASE_REDIRECT_URL=your-app://pathsupabase secrets set APPLE_REDIRECT_URI=https://your-project-ref.supabase.co/functions/v1/apple-signin-callback -
代替: Supabase ダッシュボードでシークレットを設定
ダッシュボードを使用したい場合は
- Supabase プロジェクト ダッシュボードに移動
- ナビゲート エッジ関数 → 設定 → シークレット
- 各シークレット変数と値を追加
を追加する
を追加する今では、codeでアプリ内で認証ヘルパーを使用できます。
実装の詳細は、 例のアプリの supabaseAuthUtils.ts ファイルにあります。
認証ヘルパーの使用
「認証ヘルパーの使用」のセクションimport { authenticateWithAppleSupabase } from './supabaseAuthUtils';
const result = await authenticateWithAppleSupabase();if (result.success) { console.log('Signed in:', result.user); // Navigate to your authenticated area} else { console.error('Error:', result.error);}ヘルパー関数の更新
「ヘルパー関数の更新」のセクション認証ヘルパーを使用する場合 authenticateWithAppleSupabase ヘルパー関数、 は 以下の値を更新する必要があります。
-
更新
redirectUrl- この値をあなたのSupabase Edge Function URLに設定してください。const redirectUrl = platform === 'android'? 'https://your-project-ref.supabase.co/functions/v1/apple-signin-callback': undefined; -
更新
clientId- この値をあなたのApple Service IDに設定してください。await SocialLogin.initialize({apple: {clientId: isIOS? undefined // iOS uses bundle ID automatically: 'your.service.id.here', // Your Apple Service ID for AndroidredirectUrl: redirectUrl,},});
を参照してください。 の実装を参照してください。 Step 5: Test the Integration
Step 5: Test the Integration
Android アプリをビルドして実行してください。-
ターミナル画面
クリップボードにコピー npx cap sync androidnpx cap run android -
「Appleでサインイン」をタップしてください
- Tap the “Sign in with Apple” button
- Apple OAuth画面がブラウザで表示されるはずです。
- 認証が完了したら、再びアプリにリダイレクトされるはずです。
- コンソールログを確認して、エラーがないか確認してください。
-
フローを確認してください。
完了したフローは次のようになります。
- ユーザーが「Appleでサインイン」をタップします。
- アプリがApple OAuth画面を開きます。
- ユーザーがAppleで認証します。
- Appleがリダイレクトします:
https://your-project-ref.supabase.co/functions/v1/apple-signin-callback - Edge Functionがcodeをトークンに交換します。
- Edge Functionがリダイレクトします:
your-app://path?id_token=...&access_token=... - Androidアプリがデープリンクを受け取り、アイデンティティトークンを処理します。
- AppはSupabaseにアイデンティティトークンを使用してサインインします。
トラブルシューティング
トラブルシューティング認証が失敗した場合:
- リダイレクトURIの不一致: Apple Developer PortalのReturn URLが正確に一致していることを確認してください。
APPLE_REDIRECT_URI秘密鍵 - デープリンクが機能しない: インテントフィルタがあなたの
AndroidManifest.xml秘密鍵が欠けているBASE_REDIRECT_URL - : すべての秘密鍵が正しく設定されていることを、使用していることを確認してください。
supabase secrets list - トークン交換が失敗します: Supabase ダッシュボードのエッジ関数ログを確認して、詳細なエラーメッセージを確認してください
- アプリがコールバックを受け取っていません: MainActivity にて
onNewIntentが正しく実装されていることを確認してください - MainActivity の example app code 例のアプリ __CAPGO_KEEP_0__
を参照してください
「How It Works」コンテキスト: Capgo Builder / ネイティブクラウドビルド製品ページ。役割: セクションまたはページヘッダー。メッセージキー `native_build_how_it_works_title` (ネイティブビルドHow It Works Title)。 | ホームページの問題/解決セクション。役割: 短いUIラベルまたはナビゲーションアイテム。見られるページ: page premium-support.astro。メッセージキー `ps_how_it_works` (Ps How It Works)。 | ライブアップデート製品ページ。役割: セクションまたはページヘッダー。見られるページ: page live-update.astro。メッセージキー `live_update_how_it_works_title` (ライブアップデートHow It Works Title)。
- 「How It Works」セクションのタイトルです。: Capgoプラグインは、サービスIDとバックエンドリダイレクトURLで初期化されます。
- OAuthフロー: AppleのOAuthページにブラウザ/Chromeカスタムタブを開きます。
- バックエンドコールバック: Appleは、認証codeを含むSupabaseエッジ関数にリダイレクトされます。
- トークン交換: エッジ関数は、Appleのトークンエンドポイントを使用してcodeをトークンに交換します。
- ディープリンクリダイレクト: エッジ関数は、アイデンティティトークンを含むアプリにリダイレクトされます。
- Supabase認証: アプリはトークンを受け取り、Supabaseにサインインします。
このフローは、AppleがSign in with AppleのネイティブAndroidサポートを提供していないため必要です。
Supabase Apple Android の続きから
「Supabase Apple Android の続きから」あなたが使用している場合 Supabase Apple Android 認証とアカウントフローの計画に使用している場合、Supabase Apple Android を Capacitor の @capgo/capacitor-social-login Capacitor の @capgo/capacitor-social-login Capacitor の @capgo/capacitor-social-login Capacitor の @capgo/capacitor-passkey Capacitor の @capgo/capacitor-passkey Capacitor の @capgo/capacitor-native-biometric Capacitor の @capgo/capacitor-native-biometric Capacitorで@capgo/capacitor-native-biometricの実装詳細について 2要素認証 2要素認証の実装詳細について