> ## 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.

# Collection OAuth Access Tokens

`oauthAccessTokens` lưu các bearer token mà web chấp nhận. Trong Ayakaleaf Pro, đó là các personal access token (token xác thực Git) mà người dùng tạo trên trang cài đặt tài khoản và dùng cho git-bridge và endpoint MCP. Mỗi document là một token. Schema là `services/web/app/src/models/OauthAccessToken.mjs`; module web `oauth2-server` ghi vào collection, chủ yếu bằng driver gốc.

#### Các trường

| Trường | Kiểu | Ý nghĩa | Nguồn |
| - | - | - | - |
| `_id` | ObjectId | Id document của token. Trang cài đặt xóa token theo id này. | `OauthAccessToken.mjs:6` |
| `accessToken` | String | Bản tóm tắt SHA-256 dạng hex của token. Token gốc, gồm `olp_` cộng 36 chữ cái và chữ số ngẫu nhiên, chỉ hiển thị một lần khi tạo và không bao giờ được lưu. | `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 ký tự đầu của token gốc, hiển thị trong danh sách token. | `OauthAccessToken.mjs:9`, `OAuthPersonalAccessTokenManager.mjs:73` |
| `type` | String | `personal_access_token` cho mọi token tạo trên trang cài đặt. Các truy vấn liệt kê, đếm và xóa đều lọc theo trường này. | `OauthAccessToken.mjs:10`, `OAuthPersonalAccessTokenManager.mjs:75` |
| `accessTokenExpiresAt` | Date | Một năm sau khi tạo. Sau thời điểm đó cả hai bước kiểm tra token đều từ chối token, và chỉ mục TTL xóa nó một ngày sau. | `OauthAccessToken.mjs:11`, `OAuthPersonalAccessTokenManager.mjs:65-68,77` |
| `oauthApplication_id` | ObjectId | `_id` của client `Overleaf Git Bridge` trong [OAuth Applications](https://ayakaleaf-pro.mintlify.site/vi/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:12`, `OAuthPersonalAccessTokenManager.mjs:55-56,74` |
| `scope` | String | Các scope cách nhau bằng dấu cách. Personal access token nhận `git_bridge`, scope mà các route git-bridge và MCP yêu cầu. | `OauthAccessToken.mjs:15`, `OAuthPersonalAccessTokenManager.mjs:76` |
| `user_id` | String (ObjectId in the schema) | Chủ sở hữu token. `createToken` lưu nguyên id người dùng của phiên dưới dạng chuỗi bằng driver gốc; bảng quản trị cũng truy vấn nó dưới dạng chuỗi (`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 | Thời điểm tạo. Danh sách token được sắp xếp theo trường này, mới nhất trước. | `OauthAccessToken.mjs:17`, `OAuthPersonalAccessTokenManager.mjs:21-22,64,79` |
| `lastUsedAt` | Date | Lần cuối token vượt qua kiểm tra. Cả hai bước kiểm tra token đều đặt trường này. | `OauthAccessToken.mjs:19`, `services/web/modules/oauth2-server/app/src/OAuth2Model.mjs:58-61`, `OAuthPersonalAccessTokenManager.mjs:136-140` |
| `refreshToken`, `refreshTokenExpiresAt` | String, Date | Chỉ `saveToken` ghi chúng (refresh token đã hash), và không có gì gọi `saveToken`, xem [OAuth Applications](https://ayakaleaf-pro.mintlify.site/vi/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:13-14`, `OAuth2Model.mjs:249-252` |
| `expiresAt` | Date | Chỉ có trong schema: không có mã nào trong repo này ghi nó. Một chỉ mục TTL bao phủ nó. | `OauthAccessToken.mjs:18` |
| `lastNotifiedAt.warning`, `lastNotifiedAt.expired`, `notificationsSuppressedAt` | Date | Chỉ có trong schema: không có mã nào trong repo này đọc hay ghi chúng. | `OauthAccessToken.mjs:20-27` |

#### Ai ghi

| Mã | Chức năng |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:53-88` (`createToken`) | Chèn một personal access token. Route `POST /oauth/personal-access-tokens` (`services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenRouter.mjs:22-27`) yêu cầu tính năng `gitBridge` của người dùng và cho phép 10 token mỗi người dùng (`OAuthPersonalAccessTokenController.mjs:7,34-38`). |
| `OAuthPersonalAccessTokenManager.mjs:90-105` (`removeToken`) | Xóa một token của người dùng. Route `DELETE /oauth/personal-access-tokens/:token_id` (`OAuthPersonalAccessTokenRouter.mjs:29-32`). |
| `OAuthPersonalAccessTokenManager.mjs:136-140`, `OAuth2Model.mjs:58-61` | Đặt `lastUsedAt` sau một lần kiểm tra thành công. |

#### Ai đọc

| Mã | Chức năng |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:107-144` (`verifyToken`) | Kiểm tra token theo hash cho `GET /oauth/token/info` (`OAuthPersonalAccessTokenRouter.mjs:11-15`), mà git-bridge gọi khi git clone và push (`services/git-bridge/src/main/java/uk/ac/ic/wlgitbridge/server/Oauth2Filter.java:285`). Từ chối token hết hạn và token của người dùng bị tạm khóa hoặc đã xóa. |
| `OAuth2Model.mjs:31-82` (`getAccessToken`) | Kiểm tra bearer token cho `AuthenticationController.requireOauth('git_bridge')` (`services/web/app/src/Features/Authentication/AuthenticationController.mjs:409-450`): các route API của git-bridge (`services/web/modules/git-bridge/app/src/GitBridgeRouter.mjs:33-59`) và endpoint MCP (`services/web/modules/mcp-server/app/src/McpRouter.mjs:16-22`). Từ chối token hết hạn và token của người dùng bị tạm khóa hoặc đã xóa. |
| `OAuthPersonalAccessTokenManager.mjs:13-50` (`listTokens`, `getUserTokenNums`) | Liệt kê token của người dùng cho trang cài đặt (`GET /oauth/personal-access-tokens`) và đếm chúng để áp giới hạn. |
| `AdminUserListManager.mjs:388-400` (module `admin-tools`) | Hiển thị tiền tố token của người dùng trong bảng quản trị. |

#### Chỉ mục

| Tên | Khóa | Tùy chọn | Migration |
| - | - | - | - |
| `refreshToken_1` | `{ refreshToken: 1 }` | duy nhất, partial: `refreshToken` tồn tại | `20230405190240_oauth_refresh_tokens_index.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL, `expireAfterSeconds: 0`, partial: `expiresAt` tồn tại | `20230406125632_oauth_tokens_ttl.mjs` |
| `user_id_1_type_1` | `{ user_id: 1, type: 1 }` | | `20250321160345_add_type_to_pat_user_id_index.mjs` (thay thế `user_id_1` từ `20250115110745_oauth_user_id_index_no_partial.mjs`, vốn đã thay thế `pat_user_id_1` từ `20230426095212_personal_oauth_tokens_user_index.mjs`) |
| `accessTokenExpiresAt_1` | `{ accessTokenExpiresAt: 1 }` | TTL, `expireAfterSeconds: 86400`, partial: `accessTokenExpiresAt` tồn tại | `20260511104500_expire_oauthAccessTokens.mjs` |

Các migration nằm trong `tools/migrations/`. Chỉ mục duy nhất `accessToken_1` chỉ đến từ các migration gắn tag `saas` và `server-pro`, nên Community Edition không có chỉ mục nào trên `accessToken`.

#### Ghi chú

* Xóa người dùng không xóa token của họ. `UserDeleter` kích hoạt hook `cleanupPersonalAccessTokens` (`services/web/app/src/Features/User/UserDeleter.mjs:230-234`), nhưng không module nào lắng nghe nó. Cả hai bước kiểm tra token đều từ chối các token này vì người dùng không còn, và chỉ mục TTL xóa chúng một ngày sau `accessTokenExpiresAt`.
* Tạm khóa người dùng chỉ kết thúc các phiên. Token vẫn còn, và cả hai bước kiểm tra token đều từ chối chúng khi `users.suspended` là `true` (`OAuth2Model.mjs:51-54`, `OAuthPersonalAccessTokenManager.mjs:129-134`).


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