> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OAuth Access Tokens コレクション

`oauthAccessTokens` には、web が受け付ける bearer トークンが格納されます。Ayakaleaf Pro では、ユーザーがアカウント設定ページで作成し、git-bridge と MCP エンドポイントに使う個人アクセストークン（Git 認証トークン）です。1 つのドキュメントが 1 つのトークンです。スキーマは `services/web/app/src/models/OauthAccessToken.mjs` で、web モジュール `oauth2-server` が主にネイティブドライバーでコレクションに書き込みます。

#### フィールド

| フィールド | 型 | 意味 | 出典 |
| - | - | - | - |
| `_id` | ObjectId | トークンのドキュメント id。設定ページはこの id でトークンを削除します。 | `OauthAccessToken.mjs:6` |
| `accessToken` | String | トークンの SHA-256 16 進ダイジェスト。平文のトークン（`olp_` とランダムな英数字 36 文字）は作成時に一度だけ表示され、保存されることはありません。 | `OauthAccessToken.mjs:8`, `services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenManager.mjs:54,72`, `services/web/modules/oauth2-server/app/src/SecretsHelper.mjs:6-11` |
| `accessTokenPartial` | String | 平文トークンの先頭 8 文字。トークン一覧に表示されます。 | `OauthAccessToken.mjs:9`, `OAuthPersonalAccessTokenManager.mjs:73` |
| `type` | String | 設定ページで作成されたトークンはすべて `personal_access_token` です。一覧、件数、削除のクエリはこれで絞り込みます。 | `OauthAccessToken.mjs:10`, `OAuthPersonalAccessTokenManager.mjs:75` |
| `accessTokenExpiresAt` | Date | 作成から 1 年後。これを過ぎると両方のトークン検証がトークンを拒否し、TTL インデックスが 1 日後に削除します。 | `OauthAccessToken.mjs:11`, `OAuthPersonalAccessTokenManager.mjs:65-68,77` |
| `oauthApplication_id` | ObjectId | [OAuth Applications](https://ayakaleaf-pro.mintlify.site/ja/dev/data-model/oauth-applications-collection.md) にある `Overleaf Git Bridge` クライアントの `_id`。 | `OauthAccessToken.mjs:12`, `OAuthPersonalAccessTokenManager.mjs:55-56,74` |
| `scope` | String | スペース区切りのスコープ。個人アクセストークンには、git-bridge と MCP のルートが要求するスコープ `git_bridge` が付与されます。 | `OauthAccessToken.mjs:15`, `OAuthPersonalAccessTokenManager.mjs:76` |
| `user_id` | String (ObjectId in the schema) | トークンの所有者。`createToken` はセッションのユーザー id をそのまま文字列としてネイティブドライバーで保存し、管理パネルも文字列として検索します（`services/web/modules/admin-tools/app/src/AdminUserListManager.mjs:391-392`）。 | `OauthAccessToken.mjs:16`, `services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenController.mjs:29-41`, `OAuthPersonalAccessTokenManager.mjs:78,83-85` |
| `createdAt` | Date | 作成日時。トークン一覧はこれで新しい順に並びます。 | `OauthAccessToken.mjs:17`, `OAuthPersonalAccessTokenManager.mjs:21-22,64,79` |
| `lastUsedAt` | Date | トークンが最後に検証を通過した日時。両方のトークン検証がこれを設定します。 | `OauthAccessToken.mjs:19`, `services/web/modules/oauth2-server/app/src/OAuth2Model.mjs:58-61`, `OAuthPersonalAccessTokenManager.mjs:136-140` |
| `refreshToken`, `refreshTokenExpiresAt` | String, Date | 書き込むのは `saveToken` だけで（リフレッシュトークンはハッシュ化）、`saveToken` を呼び出すものはありません。[OAuth Applications](https://ayakaleaf-pro.mintlify.site/ja/dev/data-model/oauth-applications-collection.md) を参照してください。 | `OauthAccessToken.mjs:13-14`, `OAuth2Model.mjs:249-252` |
| `expiresAt` | Date | スキーマにのみ存在し、このリポジトリのコードは書き込みません。TTL インデックスの対象です。 | `OauthAccessToken.mjs:18` |
| `lastNotifiedAt.warning`, `lastNotifiedAt.expired`, `notificationsSuppressedAt` | Date | スキーマにのみ存在し、このリポジトリのコードは読み書きしません。 | `OauthAccessToken.mjs:20-27` |

#### 書き込み元

| コード | 処理内容 |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:53-88` (`createToken`) | 個人アクセストークンを挿入します。ルート `POST /oauth/personal-access-tokens`（`services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenRouter.mjs:22-27`）はユーザーの `gitBridge` 機能を必要とし、ユーザーあたり 10 個までトークンを作成できます（`OAuthPersonalAccessTokenController.mjs:7,34-38`）。 |
| `OAuthPersonalAccessTokenManager.mjs:90-105` (`removeToken`) | ユーザーのトークンを 1 つ削除します。ルート `DELETE /oauth/personal-access-tokens/:token_id`（`OAuthPersonalAccessTokenRouter.mjs:29-32`）。 |
| `OAuthPersonalAccessTokenManager.mjs:136-140`, `OAuth2Model.mjs:58-61` | 検証の成功後に `lastUsedAt` を設定します。 |

#### 読み取り元

| コード | 処理内容 |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:107-144` (`verifyToken`) | `GET /oauth/token/info`（`OAuthPersonalAccessTokenRouter.mjs:11-15`）のためにハッシュでトークンを検証します。git-bridge は git clone と push のときにこれを呼び出します（`services/git-bridge/src/main/java/uk/ac/ic/wlgitbridge/server/Oauth2Filter.java:285`）。期限切れのトークンと、停止中または削除済みユーザーのトークンを拒否します。 |
| `OAuth2Model.mjs:31-82` (`getAccessToken`) | `AuthenticationController.requireOauth('git_bridge')`（`services/web/app/src/Features/Authentication/AuthenticationController.mjs:409-450`）のために bearer トークンを検証します。対象は git-bridge の API ルート（`services/web/modules/git-bridge/app/src/GitBridgeRouter.mjs:33-59`）と MCP エンドポイント（`services/web/modules/mcp-server/app/src/McpRouter.mjs:16-22`）です。期限切れのトークンと、停止中または削除済みユーザーのトークンを拒否します。 |
| `OAuthPersonalAccessTokenManager.mjs:13-50` (`listTokens`, `getUserTokenNums`) | 設定ページ用にユーザーのトークンを一覧表示し（`GET /oauth/personal-access-tokens`）、上限チェックのために数えます。 |
| `AdminUserListManager.mjs:388-400` (module `admin-tools`) | 管理パネルでユーザーのトークンのプレフィックスを表示します。 |

#### インデックス

| 名前 | キー | オプション | マイグレーション |
| - | - | - | - |
| `refreshToken_1` | `{ refreshToken: 1 }` | 一意、部分インデックス: `refreshToken` が存在 | `20230405190240_oauth_refresh_tokens_index.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL、`expireAfterSeconds: 0`、部分インデックス: `expiresAt` が存在 | `20230406125632_oauth_tokens_ttl.mjs` |
| `user_id_1_type_1` | `{ user_id: 1, type: 1 }` | | `20250321160345_add_type_to_pat_user_id_index.mjs`（`20250115110745_oauth_user_id_index_no_partial.mjs` の `user_id_1` を置き換え、それ自体が `20230426095212_personal_oauth_tokens_user_index.mjs` の `pat_user_id_1` を置き換えたもの） |
| `accessTokenExpiresAt_1` | `{ accessTokenExpiresAt: 1 }` | TTL、`expireAfterSeconds: 86400`、部分インデックス: `accessTokenExpiresAt` が存在 | `20260511104500_expire_oauthAccessTokens.mjs` |

マイグレーションは `tools/migrations/` にあります。一意インデックス `accessToken_1` はタグ `saas` と `server-pro` のマイグレーションからのみ作成されるため、Community Edition では `accessToken` にインデックスがありません。

#### 補足

* ユーザーを削除しても、そのトークンは削除されません。`UserDeleter` はフック `cleanupPersonalAccessTokens` を発火しますが（`services/web/app/src/Features/User/UserDeleter.mjs:230-234`）、これを受け取るモジュールはありません。ユーザーが存在しないため両方のトークン検証がトークンを拒否し、TTL インデックスが `accessTokenExpiresAt` の 1 日後に削除します。
* ユーザーを停止しても終了するのはセッションだけです。トークンは残り、`users.suspended` が `true` の間は両方のトークン検証が拒否します（`OAuth2Model.mjs:51-54`, `OAuthPersonalAccessTokenManager.mjs:129-134`）。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.