プロバイダー: Google と Apple

ほとんどの OpenID Connect のプロバイダー (Keycloak、Okta、Auth0、Microsoft) が必要とするのは、PKCE を使うパブリッククライアントと、アプリが受け取れるリダイレクト URI だけです。Google と Apple には独自のルールがあります。このページでは、2026 年 10 月時点でわかっている範囲で、それぞれが必要とするものを示します。コードはフェイクに対してテストされているので、プロバイダーのコンソールで確認してください。

使う理由

Google のコンソールは、プラットフォームごとに異なるリダイレクトを持つ異なるクライアントの種類を提供し、Android のルールを変更してきました。Apple はアプリに独自のシートを使うよう求め、アプリのコードをアプリのサーバーにだけ与えます。これを前もって知っておけば、審査の失敗や、決して戻ってこないログインを避けられます。

Google でのログイン

Google は OpenID Connect のプロバイダーです。登録 google は OAuth2 クライアントの既知のプロバイダーからエンドポイントを得て、クライアント ID だけを必要とします。

spring:
  security:
    oauth2:
      client:
        registration:
          google:
            client-id: 123-abc.apps.googleusercontent.com
            redirect-uri: com.googleusercontent.apps.123-abc:/oauth2redirect
            scope: openid,profile,email
場所 Google Cloud でのクライアントの種類 リダイレクト URI シークレット
iOS、macOS iOS (バンドル ID) 逆順のクライアント ID: com.googleusercontent.apps.123-abc:/oauth2redirect なし
Android Android (パッケージ名と SHA-1)。詳細設定で「Custom URI scheme」を有効にする コンソールが受け付ける独自スキーム (逆順のクライアント ID) なし
Windows、Linux デスクトップアプリ http://127.0.0.1/callback (任意のポート) 秘密ではない client_secret
Web (サーバーがログインする) Web アプリケーション https://<server>/login/oauth2/code/google サーバーにのみ

Sign in with Apple

iOS と macOS では、アプリはブラウザーではなく、システム独自のシート (ASAuthorizationAppleIDProvider: Face ID、Touch ID、パスコード) でサインインします。プロバイダーが apple の登録はデフォルトでそれを使い、native-sign-in はそれを明示します。

spring:
  security:
    oauth2:
      client:
        registration:
          apple:
            client-id: books.neon.app          # App ID (バンドル ID)
            native-sign-in: apple              # iOS と macOS ではシート。none: ブラウザー
        provider:
          apple:
            # アプリのサーバーがコードを交換する: Apple のクライアントシークレットに署名できるのはそれだけ。
            token-uri: https://api.neon.example/oauth2/apple/token

アプリには、Xcode の「Sign in with Apple」のケイパビリティと、Sign in with Apple が有効な App ID が必要です。login('apple'):

  1. シートにスコープ (name、email)、新しい state、新しい nonce の SHA-256 ハッシュを送ります。
  2. 応答をチェックします。state、Apple の鍵に対する ID トークンの署名、その issuer、audience、時刻、nonce、そしてシートのユーザーと等しいその sub です。トークンは TLS の接続ではなくオペレーティングシステムから来るので、サーバーと同じように検証されます。
  3. 認可コード (有効期間は五分、一度だけ) を、登録のトークンエンドポイント、つまり アプリのサーバー で交換します。Apple は、チームの鍵で署名されたクライアントシークレットとともにでなければコードを受け付けず、どのアプリもその鍵を保持してはなりません。サーバーは検証し、Apple とコードを交換し (セキュリティスターターの JwtClientSecret)、自身の API のトークンで応答します。
  4. Apple が 最初の認可のときだけ 送る名前 (と、トークンにないメールアドレス) を、ログインとともに保持します。すぐにサーバーにも保存してください。

どの失敗も OAuth2AuthenticationException で、閉じられたシートは AuthorizationCancelledException です。Android、Windows、Linux にはシートがありません。登録はブラウザー、https のリダイレクト、response-mode=query を使います。そこではサーバーにユーザーをログインさせるほうが簡単です。

App Store は、サードパーティーのログインを提供するアプリに Sign in with Apple も提供するよう求め (App Review Guideline 4.8)、アカウントを作るアプリはユーザーがそれを削除できるようにしなければなりません。それにはサーバーでユーザーの Apple のトークンを取り消すことも含まれます。

ここで使う登録のキー

キー 意味
spring.security.oauth2.client.registration.<id>.native-sign-in apple: iOS と macOS での Sign in with Apple のシート。none: ブラウザー。apple プロバイダーではデフォルトが apple
spring.security.oauth2.client.registration.<id>.response-mode query (デフォルト) または form_post (サーバーだけが受け取れる)
spring.security.oauth2.client.provider.<id>.token-uri Apple では: アプリのサーバー

登録のすべてのキーは すべてのプロパティ にあります。

関連項目