> ## 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` зберігає bearer-токени, які приймає web. В Ayakaleaf Pro це персональні токени доступу (токени автентифікації Git), які користувач створює на сторінці налаштувань облікового запису та використовує для git-bridge і ендпоінта MCP. Один документ відповідає одному токену. Схема: `services/web/app/src/models/OauthAccessToken.mjs`; до колекції пише вебмодуль `oauth2-server`, переважно через нативний драйвер.

#### Поля

| Поле | Тип | Значення | Джерело |
| - | - | - | - |
| `_id` | ObjectId | Id документа токена. Сторінка налаштувань видаляє токен за цим id. | `OauthAccessToken.mjs:6` |
| `accessToken` | String | Шістнадцятковий дайджест SHA-256 токена. Сам токен, `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 | Через рік після створення. Після цього обидві перевірки токена відхиляють його, а TTL-індекс видаляє його ще через день. | `OauthAccessToken.mjs:11`, `OAuthPersonalAccessTokenManager.mjs:65-68,77` |
| `oauthApplication_id` | ObjectId | `_id` клієнта `Overleaf Git Bridge` в [OAuth Applications](https://ayakaleaf-pro.mintlify.site/uk/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:12`, `OAuthPersonalAccessTokenManager.mjs:55-56,74` |
| `scope` | String | Scopes через пробіл. Персональні токени доступу отримують `git_bridge`: цей scope вимагають маршрути git-bridge і MCP. | `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` (refresh-токен у хешованому вигляді), а `saveToken` ніхто не викликає, див. [OAuth Applications](https://ayakaleaf-pro.mintlify.site/uk/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`) | Видаляє один токен користувача. Маршрут `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`) | Перевіряє bearer-токен для `AuthenticationController.requireOauth('git_bridge')` (`services/web/app/src/Features/Authentication/AuthenticationController.mjs:409-450`): API-маршрути git-bridge (`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` (замінює `user_id_1` з `20250115110745_oauth_user_id_index_no_partial.mjs`, який замінив `pat_user_id_1` з `20230426095212_personal_oauth_tokens_user_index.mjs`) |
| `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`.
* Блокування користувача завершує лише сесії. Токени залишаються, і обидві перевірки токена відхиляють їх, поки `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.