プロバイダー: 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 |
サーバーにのみ |
- Android: 2023 年 10 月以降、新しい Android のクライアントは、「Custom URI scheme」を有効にしない限り独自の URI スキームを使えません。Google は Android アプリに Credential Manager を勧めていますが、このパッケージはそれをラップしていません。独自のスキームなしでは、サーバーにユーザーをログインさせてください。
- デスクトップ: 「デスクトップアプリ」のクライアントには、Google 自身が機密ではないと言う
client_secretが付いてきます。トークンエンドポイントがそれを求める場合は、client-secretとして設定してください。 - ロール: Google にはロールがありません。
GrantedAuthoritiesMapperBean で、そして判断するサーバーで、ユーザーを権限に対応付けてください。 - ユーザーが誰か: ユーザーはメールアドレスではなく、常に
subで保持してください。メールアドレスはemail_verified=trueの場合にだけ使ってください。 - リフレッシュトークン は長命でローテーションされません。
logout()がそれを取り消します。Google は DPoP のトークンを発行しません (dpop=autoはBearerのままです)。
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'):
- シートにスコープ (
name、email)、新しいstate、新しい nonce の SHA-256 ハッシュを送ります。 - 応答をチェックします。
state、Apple の鍵に対する ID トークンの署名、その issuer、audience、時刻、nonce、そしてシートのユーザーと等しいそのsubです。トークンは TLS の接続ではなくオペレーティングシステムから来るので、サーバーと同じように検証されます。 - 認可コード (有効期間は五分、一度だけ) を、登録のトークンエンドポイント、つまり アプリのサーバー で交換します。Apple は、チームの鍵で署名されたクライアントシークレットとともにでなければコードを受け付けず、どのアプリもその鍵を保持してはなりません。サーバーは検証し、Apple とコードを交換し (セキュリティスターターの
JwtClientSecret)、自身の API のトークンで応答します。 - 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 では: アプリのサーバー |
登録のすべてのキーは すべてのプロパティ にあります。