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

# Colección OAuth Access Tokens

`oauthAccessTokens` contiene los tokens bearer que acepta web. En Ayakaleaf Pro son los tokens de acceso personal (tokens de autenticación de Git) que un usuario crea en la página de configuración de la cuenta y usa para git-bridge y el endpoint MCP. Un documento es un token. El esquema es `services/web/app/src/models/OauthAccessToken.mjs`; el módulo web `oauth2-server` escribe la colección, sobre todo con el driver nativo.

#### Campos

| Campo | Tipo | Significado | Origen |
| - | - | - | - |
| `_id` | ObjectId | Id del documento del token. La página de configuración borra un token por este id. | `OauthAccessToken.mjs:6` |
| `accessToken` | String | Resumen hexadecimal SHA-256 del token. El token en claro, `olp_` más 36 letras y dígitos aleatorios, se muestra una vez al crearlo y nunca se guarda. | `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 | Primeros 8 caracteres del token en claro, que se muestran en las listas de tokens. | `OauthAccessToken.mjs:9`, `OAuthPersonalAccessTokenManager.mjs:73` |
| `type` | String | `personal_access_token` para cada token creado en la página de configuración. Las consultas de listado, recuento y borrado filtran por él. | `OauthAccessToken.mjs:10`, `OAuthPersonalAccessTokenManager.mjs:75` |
| `accessTokenExpiresAt` | Date | Un año después de la creación. Ambas comprobaciones de token rechazan el token después de esta fecha, y el índice TTL lo borra un día más tarde. | `OauthAccessToken.mjs:11`, `OAuthPersonalAccessTokenManager.mjs:65-68,77` |
| `oauthApplication_id` | ObjectId | `_id` del cliente `Overleaf Git Bridge` en [OAuth Applications](https://ayakaleaf-pro.mintlify.site/es/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:12`, `OAuthPersonalAccessTokenManager.mjs:55-56,74` |
| `scope` | String | Scopes separados por espacios. Los tokens de acceso personal reciben `git_bridge`, el scope que exigen las rutas de git-bridge y MCP. | `OauthAccessToken.mjs:15`, `OAuthPersonalAccessTokenManager.mjs:76` |
| `user_id` | String (ObjectId in the schema) | Propietario del token. `createToken` guarda el id de usuario de la sesión tal cual, como cadena, con el driver nativo; el panel de administración lo consulta como cadena (`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 | Momento de creación. La lista de tokens se ordena por él, del más nuevo al más antiguo. | `OauthAccessToken.mjs:17`, `OAuthPersonalAccessTokenManager.mjs:21-22,64,79` |
| `lastUsedAt` | Date | Última vez que el token superó una comprobación. Ambas comprobaciones de token lo establecen. | `OauthAccessToken.mjs:19`, `services/web/modules/oauth2-server/app/src/OAuth2Model.mjs:58-61`, `OAuthPersonalAccessTokenManager.mjs:136-140` |
| `refreshToken`, `refreshTokenExpiresAt` | String, Date | Solo los escribe `saveToken` (el refresh token con hash), y nada llama a `saveToken`, ver [OAuth Applications](https://ayakaleaf-pro.mintlify.site/es/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:13-14`, `OAuth2Model.mjs:249-252` |
| `expiresAt` | Date | Solo en el esquema: ningún código de este repositorio lo escribe. Un índice TTL lo cubre. | `OauthAccessToken.mjs:18` |
| `lastNotifiedAt.warning`, `lastNotifiedAt.expired`, `notificationsSuppressedAt` | Date | Solo en el esquema: ningún código de este repositorio los lee ni los escribe. | `OauthAccessToken.mjs:20-27` |

#### Quién escribe

| Código | Qué hace |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:53-88` (`createToken`) | Inserta un token de acceso personal. La ruta `POST /oauth/personal-access-tokens` (`services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenRouter.mjs:22-27`) requiere la funcionalidad `gitBridge` del usuario y permite 10 tokens por usuario (`OAuthPersonalAccessTokenController.mjs:7,34-38`). |
| `OAuthPersonalAccessTokenManager.mjs:90-105` (`removeToken`) | Borra un token del usuario. Ruta `DELETE /oauth/personal-access-tokens/:token_id` (`OAuthPersonalAccessTokenRouter.mjs:29-32`). |
| `OAuthPersonalAccessTokenManager.mjs:136-140`, `OAuth2Model.mjs:58-61` | Establecen `lastUsedAt` tras una comprobación correcta. |

#### Quién lee

| Código | Qué hace |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:107-144` (`verifyToken`) | Comprueba un token por su hash para `GET /oauth/token/info` (`OAuthPersonalAccessTokenRouter.mjs:11-15`), al que llama git-bridge en git clone y push (`services/git-bridge/src/main/java/uk/ac/ic/wlgitbridge/server/Oauth2Filter.java:285`). Rechaza un token caducado y el token de un usuario suspendido o eliminado. |
| `OAuth2Model.mjs:31-82` (`getAccessToken`) | Comprueba un token bearer para `AuthenticationController.requireOauth('git_bridge')` (`services/web/app/src/Features/Authentication/AuthenticationController.mjs:409-450`): las rutas de API de git-bridge (`services/web/modules/git-bridge/app/src/GitBridgeRouter.mjs:33-59`) y el endpoint MCP (`services/web/modules/mcp-server/app/src/McpRouter.mjs:16-22`). Rechaza un token caducado y el token de un usuario suspendido o eliminado. |
| `OAuthPersonalAccessTokenManager.mjs:13-50` (`listTokens`, `getUserTokenNums`) | Lista los tokens de un usuario para la página de configuración (`GET /oauth/personal-access-tokens`) y los cuenta para el límite. |
| `AdminUserListManager.mjs:388-400` (module `admin-tools`) | Muestra los prefijos de los tokens de un usuario en el panel de administración. |

#### Índices

| Nombre | Claves | Opciones | Migración |
| - | - | - | - |
| `refreshToken_1` | `{ refreshToken: 1 }` | único, parcial: `refreshToken` existe | `20230405190240_oauth_refresh_tokens_index.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL, `expireAfterSeconds: 0`, parcial: `expiresAt` existe | `20230406125632_oauth_tokens_ttl.mjs` |
| `user_id_1_type_1` | `{ user_id: 1, type: 1 }` | | `20250321160345_add_type_to_pat_user_id_index.mjs` (sustituye a `user_id_1` de `20250115110745_oauth_user_id_index_no_partial.mjs`, que sustituyó a `pat_user_id_1` de `20230426095212_personal_oauth_tokens_user_index.mjs`) |
| `accessTokenExpiresAt_1` | `{ accessTokenExpiresAt: 1 }` | TTL, `expireAfterSeconds: 86400`, parcial: `accessTokenExpiresAt` existe | `20260511104500_expire_oauthAccessTokens.mjs` |

Las migraciones están en `tools/migrations/`. El índice único `accessToken_1` solo procede de migraciones etiquetadas `saas` y `server-pro`, así que en Community Edition no hay índice en `accessToken`.

#### Notas

* Eliminar un usuario no borra sus tokens. `UserDeleter` dispara el hook `cleanupPersonalAccessTokens` (`services/web/app/src/Features/User/UserDeleter.mjs:230-234`), pero ningún módulo lo escucha. Ambas comprobaciones de token rechazan los tokens porque el usuario ya no existe, y el índice TTL los elimina un día después de `accessTokenExpiresAt`.
* Suspender un usuario solo cierra sus sesiones. Los tokens se quedan, y ambas comprobaciones de token los rechazan mientras `users.suspended` sea `true` (`OAuth2Model.mjs:51-54`, `OAuthPersonalAccessTokenManager.mjs:129-134`).


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