【ITニュース解説】[SwiftUI/Supabase]　Supabase × Sign in with Apple 設定でハマらないための手順（SwiftUI対応）

アプリ開発において、ユーザーが安全かつ簡単にサービスを利用できるようにする「認証」は非常に重要な機能だ。多くのアプリでは、ユーザー名とパスワードの組み合わせだけでなく、GoogleやFacebook、あるいはAppleのアカウントを使ってログインする機能が提供されている。この記事は、特にApple製品向けのアプリ開発において、「Sign in with Apple」という認証方法を、バックエンドサービスである「Supabase」と連携させて実装するための設定手順に焦点を当てている。これは、アプリの機能そのものではなく、アプリの裏側で動くシステムを構築するための土台作りの話だ。

まず、「Sign in with Apple」とは何か、そのメリットを理解しよう。「Sign in with Apple」は、Appleが提供する認証サービスで、ユーザーが自分のApple IDを使ってアプリにログインできる機能だ。ユーザーは新しいアカウント情報を覚えたり作成したりする手間が省け、ワンタップでログインできるようになる。特に重要なのは、ユーザーのプライバシー保護に優れている点だ。ユーザーは、アプリに自分のメールアドレスを教える代わりに、Appleが生成した匿名化されたメールアドレスを使うことを選択できるため、個人情報が直接アプリ提供者に渡ることを避けられる。これは、ユーザーにとって大きな安心材料となる。

次に、「Supabase」とは何か、その役割を見てみよう。Supabaseは、Webやモバイルアプリのバックエンドを簡単に構築できるサービスで、データベース機能、認証機能、リアルタイム機能などを提供している。通常、アプリのユーザー認証システムを自前で構築しようとすると、データベースの設計、ユーザー情報の管理、パスワードのハッシュ化、セッション管理など、多くの専門知識と手間が必要となる。しかし、Supabaseのようなサービスを使うことで、これらの複雑なバックエンド処理を自分たちでコードを書かずに実現できる。開発者は、よりアプリの機能やユーザー体験の向上に集中できるようになるわけだ。

この記事が扱うのは、まさにこのSupabaseの認証機能と「Sign in with Apple」を連携させるための「設定」に特化している。実際のアプリでログインボタンをタップした後の画面遷移やユーザーインターフェース（UI）の実装、つまりSwiftUIでのプログラミングについては触れていない。これは、認証が機能するための「骨格」を作る作業であり、この骨格がしっかりしていなければ、どんなに素晴らしいUIを作っても認証は成功しないからだ。

「Sign in with Apple」とSupabaseを連携させる設定は、大きく分けて二つの場所で行う必要がある。一つは「Apple Developerアカウント側」、もう一つは「Supabaseプロジェクト側」だ。それぞれの場所で必要な情報を設定し、互いに連携できるように調整していく作業となる。

まず、Apple Developerアカウント側での設定から説明する。Apple Developer Programに登録している開発者は、アプリやサービスを開発・公開するための様々なツールや設定にアクセスできる。

1. App IDの登録と設定: 開発しているアプリを識別するための「App ID」を登録する。このとき、アプリの「Capabilities（機能）」の中から「Sign in with Apple」を有効にする必要がある。これを忘れると、アプリが「Sign in with Apple」の機能を使えない状態になってしまう。
2. Services IDの作成と設定: 「Sign in with Apple」は、単にアプリでログインするだけでなく、Webサービスなどでも利用できる。Supabaseのようなバックエンドサービスと連携するためには、「Services ID」というものを別途作成する。このServices IDは、SupabaseとAppleの認証システムが安全に通信するための識別子となる。Services IDの設定では、特に「Return URLs（リダイレクトURL）」を指定することが重要だ。これは、ユーザーがAppleでの認証を完了した後、SupabaseのどのURLに戻すかを指定するもので、Supabaseが提供する認証用URLをここに正確に設定する必要がある。
3. 秘密鍵（Private Key）の生成: Appleの認証サーバーとSupabaseが安全に通信し、認証情報をやり取りするためには、暗号化と署名のための秘密鍵が必要だ。この秘密鍵はApple Developerアカウントから生成し、ダウンロードする。この鍵は非常に重要であり、紛失したり他人に漏洩したりしないように厳重に管理する必要がある。また、この鍵には「Key ID」という識別子も付与されるため、これも控えておく。

次に、Supabaseプロジェクト側での設定に進む。

1. 認証プロバイダの有効化: Supabaseプロジェクトの管理画面にアクセスし、認証設定のセクションを開く。そこで、利用したい認証プロバイダの一覧の中から「Apple」を選択し、有効にする。
2. Apple Developerアカウントで取得した情報の登録: ここで、先ほどApple Developerアカウント側で設定・取得した情報をSupabaseに登録する。具体的には、
   • Service ID: Apple Developer側で作成したServices ID。
   • Team ID: 開発者が所属するApple Developer ProgramのチームID。
   • Key ID: Apple Developer側で生成した秘密鍵の識別子。
   • Private Key: ダウンロードした秘密鍵の内容そのもの。これをSupabaseの設定画面に貼り付ける。
3. Callback URLの確認: Supabaseが提供する「Sign in with Apple」のCallback URLを確認し、このURLをApple DeveloperアカウントのServices ID設定で「Return URLs」として正確に登録したかを確認する。このURLが一致していないと、認証が完了してもユーザーがアプリに戻れなくなり、エラーが発生してしまう。

これらの設定は、一見すると多くのIDや鍵、URLが登場し、複雑に感じるかもしれない。しかし、それぞれがどのような役割を持っているのかを理解すれば、迷わずに設定を進めることができる。特にハマりやすいポイントとして、以下の点が挙げられる。

• IDの混同: App ID、Services ID、Team ID、Key IDなど、似たようなIDが複数登場するため、どれをどこに設定すべきか混乱しやすい。それぞれのIDが何を識別しているのかを明確に理解することが重要だ。
• Return URL / Callback URLの不一致: 最もよくある問題の一つで、Apple Developer側で設定するReturn URLと、Supabaseが期待するCallback URLが一致していない場合、認証フローが途中で止まってしまう。コピペミスやスペルミスがないか、何度も確認が必要だ。
• 秘密鍵の取り扱い: 秘密鍵の生成を忘れたり、ダウンロードした鍵ファイルを失くしたり、Supabaseに正しく貼り付けなかったりすると、SupabaseがAppleの認証サーバーと通信できなくなる。また、秘密鍵には有効期限がある場合もあるため、定期的な確認や更新が必要になることもある。
• Capabilitiesの有効化忘れ: App IDで「Sign in with Apple」のCapabilityを有効にし忘れると、そもそもアプリがその機能を使おうとしてもApple側で拒否されてしまう。

これらの設定を一つ一つ丁寧に、そして正確に行うことで、「Sign in with Apple」を使った安全で便利な認証システムをSupabase上で構築できる。このバックエンド側の設定が完了して初めて、SwiftUIなどのクライアント側でログインボタンを実装し、ユーザーがスムーズにログインできる体験を提供できるようになる。アプリの裏側でこれだけ多くの設定が連携して初めて、当たり前のように使えるログイン機能が実現しているのだ。システムエンジニアを目指す上では、こうした見えない部分の仕組みと設定の重要性を理解しておくことが、安定したサービス提供に不可欠であると理解しておこう。