> ## 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` contient les jetons bearer que web accepte. Dans Ayakaleaf Pro, ce sont les jetons d'accès personnels (jetons d'authentification Git) qu'un utilisateur crée sur la page des paramètres du compte et utilise pour git-bridge et le point de terminaison MCP. Un document correspond à un jeton. Le schéma est `services/web/app/src/models/OauthAccessToken.mjs` ; le module web `oauth2-server` écrit la collection, surtout avec le pilote natif.

#### Champs

| Champ | Type | Signification | Source |
| - | - | - | - |
| `_id` | ObjectId | Identifiant du document du jeton. La page des paramètres supprime un jeton par cet identifiant. | `OauthAccessToken.mjs:6` |
| `accessToken` | String | Condensé hexadécimal SHA-256 du jeton. Le jeton en clair, `olp_` suivi de 36 lettres et chiffres aléatoires, est affiché une fois à sa création et jamais stocké. | `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 | Les 8 premiers caractères du jeton en clair, affichés dans les listes de jetons. | `OauthAccessToken.mjs:9`, `OAuthPersonalAccessTokenManager.mjs:73` |
| `type` | String | `personal_access_token` pour chaque jeton créé sur la page des paramètres. Les requêtes de liste, de comptage et de suppression filtrent sur ce champ. | `OauthAccessToken.mjs:10`, `OAuthPersonalAccessTokenManager.mjs:75` |
| `accessTokenExpiresAt` | Date | Un an après la création. Les deux vérifications de jeton rejettent un jeton après cette date, et l'index TTL le supprime un jour plus tard. | `OauthAccessToken.mjs:11`, `OAuthPersonalAccessTokenManager.mjs:65-68,77` |
| `oauthApplication_id` | ObjectId | `_id` du client `Overleaf Git Bridge` dans [OAuth Applications](https://ayakaleaf-pro.mintlify.site/fr/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:12`, `OAuthPersonalAccessTokenManager.mjs:55-56,74` |
| `scope` | String | Scopes séparés par des espaces. Les jetons d'accès personnels reçoivent `git_bridge`, le scope qu'exigent les routes git-bridge et MCP. | `OauthAccessToken.mjs:15`, `OAuthPersonalAccessTokenManager.mjs:76` |
| `user_id` | String (ObjectId in the schema) | Propriétaire du jeton. `createToken` stocke l'identifiant utilisateur de la session tel quel, sous forme de chaîne, avec le pilote natif ; le panneau d'administration le recherche comme chaîne (`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 | Date de création. La liste des jetons est triée par ce champ, du plus récent au plus ancien. | `OauthAccessToken.mjs:17`, `OAuthPersonalAccessTokenManager.mjs:21-22,64,79` |
| `lastUsedAt` | Date | Dernière fois que le jeton a réussi une vérification. Les deux vérifications de jeton le définissent. | `OauthAccessToken.mjs:19`, `services/web/modules/oauth2-server/app/src/OAuth2Model.mjs:58-61`, `OAuthPersonalAccessTokenManager.mjs:136-140` |
| `refreshToken`, `refreshTokenExpiresAt` | String, Date | Seul `saveToken` les écrit (le jeton de rafraîchissement haché), et rien n'appelle `saveToken`, voir [OAuth Applications](https://ayakaleaf-pro.mintlify.site/fr/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:13-14`, `OAuth2Model.mjs:249-252` |
| `expiresAt` | Date | Uniquement dans le schéma : aucun code de ce dépôt ne l'écrit. Un index TTL le couvre. | `OauthAccessToken.mjs:18` |
| `lastNotifiedAt.warning`, `lastNotifiedAt.expired`, `notificationsSuppressedAt` | Date | Uniquement dans le schéma : aucun code de ce dépôt ne les lit ni ne les écrit. | `OauthAccessToken.mjs:20-27` |

#### Qui écrit

| Code | Rôle |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:53-88` (`createToken`) | Insère un jeton d'accès personnel. La route `POST /oauth/personal-access-tokens` (`services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenRouter.mjs:22-27`) exige la fonctionnalité `gitBridge` de l'utilisateur et autorise 10 jetons par utilisateur (`OAuthPersonalAccessTokenController.mjs:7,34-38`). |
| `OAuthPersonalAccessTokenManager.mjs:90-105` (`removeToken`) | Supprime un jeton de l'utilisateur. Route `DELETE /oauth/personal-access-tokens/:token_id` (`OAuthPersonalAccessTokenRouter.mjs:29-32`). |
| `OAuthPersonalAccessTokenManager.mjs:136-140`, `OAuth2Model.mjs:58-61` | Définissent `lastUsedAt` après une vérification réussie. |

#### Qui lit

| Code | Rôle |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:107-144` (`verifyToken`) | Vérifie un jeton par son hachage pour `GET /oauth/token/info` (`OAuthPersonalAccessTokenRouter.mjs:11-15`), que git-bridge appelle lors d'un git clone et d'un push (`services/git-bridge/src/main/java/uk/ac/ic/wlgitbridge/server/Oauth2Filter.java:285`). Rejette un jeton expiré et le jeton d'un utilisateur suspendu ou supprimé. |
| `OAuth2Model.mjs:31-82` (`getAccessToken`) | Vérifie un jeton bearer pour `AuthenticationController.requireOauth('git_bridge')` (`services/web/app/src/Features/Authentication/AuthenticationController.mjs:409-450`) : les routes d'API git-bridge (`services/web/modules/git-bridge/app/src/GitBridgeRouter.mjs:33-59`) et le point de terminaison MCP (`services/web/modules/mcp-server/app/src/McpRouter.mjs:16-22`). Rejette un jeton expiré et le jeton d'un utilisateur suspendu ou supprimé. |
| `OAuthPersonalAccessTokenManager.mjs:13-50` (`listTokens`, `getUserTokenNums`) | Liste les jetons d'un utilisateur pour la page des paramètres (`GET /oauth/personal-access-tokens`) et les compte pour la limite. |
| `AdminUserListManager.mjs:388-400` (module `admin-tools`) | Affiche les préfixes des jetons d'un utilisateur dans le panneau d'administration. |

#### Index

| Nom | Clés | Options | Migration |
| - | - | - | - |
| `refreshToken_1` | `{ refreshToken: 1 }` | unique, partiel : `refreshToken` existe | `20230405190240_oauth_refresh_tokens_index.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL, `expireAfterSeconds: 0`, partiel : `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` (remplace `user_id_1` de `20250115110745_oauth_user_id_index_no_partial.mjs`, qui remplaçait `pat_user_id_1` de `20230426095212_personal_oauth_tokens_user_index.mjs`) |
| `accessTokenExpiresAt_1` | `{ accessTokenExpiresAt: 1 }` | TTL, `expireAfterSeconds: 86400`, partiel : `accessTokenExpiresAt` existe | `20260511104500_expire_oauthAccessTokens.mjs` |

Les migrations se trouvent dans `tools/migrations/`. L'index unique `accessToken_1` provient uniquement des migrations marquées `saas` et `server-pro`, donc Community Edition n'a aucun index sur `accessToken`.

#### Remarques

* Supprimer un utilisateur ne supprime pas ses jetons. `UserDeleter` déclenche le hook `cleanupPersonalAccessTokens` (`services/web/app/src/Features/User/UserDeleter.mjs:230-234`), mais aucun module ne l'écoute. Les deux vérifications de jeton rejettent les jetons parce que l'utilisateur n'existe plus, et l'index TTL les supprime un jour après `accessTokenExpiresAt`.
* Suspendre un utilisateur ne met fin qu'aux sessions. Les jetons restent, et les deux vérifications de jeton les rejettent tant que `users.suspended` vaut `true` (`OAuth2Model.mjs:51-54`, `OAuthPersonalAccessTokenManager.mjs:129-134`).


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