
# プロバイダー: Google と Apple

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

## 使う理由

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

## Google でのログイン

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

```yaml
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 にはロールがありません。`GrantedAuthoritiesMapper` Bean で、そして判断するサーバーで、ユーザーを権限に対応付けてください。
- **ユーザーが誰か:** ユーザーはメールアドレスではなく、常に `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` はそれを明示します。

```yaml
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 では: アプリのサーバー |

登録のすべてのキーは [すべてのプロパティ](properties.md) にあります。

## 関連項目

- [アプリのログイン](app-login.md)
- [ログイン画面](login-screens.md)
- [spring_boot_starter_security](../spring-boot-starter-security/index.md)
