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

`oauthAccessTokens` bevat de bearer-tokens die web accepteert. In Ayakaleaf Pro zijn dat de persoonlijke toegangstokens (Git-authenticatietokens) die een gebruiker op de pagina met accountinstellingen aanmaakt en gebruikt voor git-bridge en het MCP-endpoint. Eén document is één token. Het schema is `services/web/app/src/models/OauthAccessToken.mjs`; de webmodule `oauth2-server` schrijft de collectie, meestal met de native driver.

#### Velden

| Veld | Type | Betekenis | Bron |
| - | - | - | - |
| `_id` | ObjectId | Document-id van het token. De instellingenpagina verwijdert een token via deze id. | `OauthAccessToken.mjs:6` |
| `accessToken` | String | SHA-256-hexdigest van het token. Het token in platte tekst, `olp_` plus 36 willekeurige letters en cijfers, wordt bij het aanmaken één keer getoond en nooit opgeslagen. | `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 | De eerste 8 tekens van het token in platte tekst, getoond in de tokenlijsten. | `OauthAccessToken.mjs:9`, `OAuthPersonalAccessTokenManager.mjs:73` |
| `type` | String | `personal_access_token` voor elk token dat op de instellingenpagina is aangemaakt. De query's voor lijst, telling en verwijderen filteren erop. | `OauthAccessToken.mjs:10`, `OAuthPersonalAccessTokenManager.mjs:75` |
| `accessTokenExpiresAt` | Date | Eén jaar na het aanmaken. Beide tokencontroles weigeren een token daarna, en de TTL-index verwijdert het een dag later. | `OauthAccessToken.mjs:11`, `OAuthPersonalAccessTokenManager.mjs:65-68,77` |
| `oauthApplication_id` | ObjectId | `_id` van de client `Overleaf Git Bridge` in [OAuth Applications](https://ayakaleaf-pro.mintlify.site/nl/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:12`, `OAuthPersonalAccessTokenManager.mjs:55-56,74` |
| `scope` | String | Door spaties gescheiden scopes. Persoonlijke toegangstokens krijgen `git_bridge`, de scope die de routes van git-bridge en MCP vereisen. | `OauthAccessToken.mjs:15`, `OAuthPersonalAccessTokenManager.mjs:76` |
| `user_id` | String (ObjectId in the schema) | Eigenaar van het token. `createToken` slaat de gebruikers-id van de sessie ongewijzigd op als string, met de native driver; het beheerpaneel zoekt erop als string (`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 | Tijdstip van aanmaken. De tokenlijst is hierop gesorteerd, nieuwste eerst. | `OauthAccessToken.mjs:17`, `OAuthPersonalAccessTokenManager.mjs:21-22,64,79` |
| `lastUsedAt` | Date | Laatste keer dat het token een controle doorstond. Beide tokencontroles zetten het. | `OauthAccessToken.mjs:19`, `services/web/modules/oauth2-server/app/src/OAuth2Model.mjs:58-61`, `OAuthPersonalAccessTokenManager.mjs:136-140` |
| `refreshToken`, `refreshTokenExpiresAt` | String, Date | Alleen `saveToken` schrijft ze (het refresh-token gehasht), en niets roept `saveToken` aan, zie [OAuth Applications](https://ayakaleaf-pro.mintlify.site/nl/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:13-14`, `OAuth2Model.mjs:249-252` |
| `expiresAt` | Date | Alleen in het schema: geen code in deze repository schrijft het. Een TTL-index dekt het. | `OauthAccessToken.mjs:18` |
| `lastNotifiedAt.warning`, `lastNotifiedAt.expired`, `notificationsSuppressedAt` | Date | Alleen in het schema: geen code in deze repository leest of schrijft ze. | `OauthAccessToken.mjs:20-27` |

#### Wie schrijft

| Code | Wat het doet |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:53-88` (`createToken`) | Voegt een persoonlijk toegangstoken toe. Route `POST /oauth/personal-access-tokens` (`services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenRouter.mjs:22-27`) vereist de feature `gitBridge` van de gebruiker en staat 10 tokens per gebruiker toe (`OAuthPersonalAccessTokenController.mjs:7,34-38`). |
| `OAuthPersonalAccessTokenManager.mjs:90-105` (`removeToken`) | Verwijdert één token van de gebruiker. Route `DELETE /oauth/personal-access-tokens/:token_id` (`OAuthPersonalAccessTokenRouter.mjs:29-32`). |
| `OAuthPersonalAccessTokenManager.mjs:136-140`, `OAuth2Model.mjs:58-61` | Zetten `lastUsedAt` na een geslaagde controle. |

#### Wie leest

| Code | Wat het doet |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:107-144` (`verifyToken`) | Controleert een token via de hash voor `GET /oauth/token/info` (`OAuthPersonalAccessTokenRouter.mjs:11-15`), dat git-bridge aanroept bij git clone en push (`services/git-bridge/src/main/java/uk/ac/ic/wlgitbridge/server/Oauth2Filter.java:285`). Weigert een verlopen token en het token van een geschorste of verwijderde gebruiker. |
| `OAuth2Model.mjs:31-82` (`getAccessToken`) | Controleert een bearer-token voor `AuthenticationController.requireOauth('git_bridge')` (`services/web/app/src/Features/Authentication/AuthenticationController.mjs:409-450`): de API-routes van git-bridge (`services/web/modules/git-bridge/app/src/GitBridgeRouter.mjs:33-59`) en het MCP-endpoint (`services/web/modules/mcp-server/app/src/McpRouter.mjs:16-22`). Weigert een verlopen token en het token van een geschorste of verwijderde gebruiker. |
| `OAuthPersonalAccessTokenManager.mjs:13-50` (`listTokens`, `getUserTokenNums`) | Toont de tokens van een gebruiker op de instellingenpagina (`GET /oauth/personal-access-tokens`) en telt ze voor de limiet. |
| `AdminUserListManager.mjs:388-400` (module `admin-tools`) | Toont de tokenprefixen van een gebruiker in het beheerpaneel. |

#### Indexen

| Naam | Sleutels | Opties | Migratie |
| - | - | - | - |
| `refreshToken_1` | `{ refreshToken: 1 }` | uniek, gedeeltelijk: `refreshToken` bestaat | `20230405190240_oauth_refresh_tokens_index.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL, `expireAfterSeconds: 0`, gedeeltelijk: `expiresAt` bestaat | `20230406125632_oauth_tokens_ttl.mjs` |
| `user_id_1_type_1` | `{ user_id: 1, type: 1 }` | | `20250321160345_add_type_to_pat_user_id_index.mjs` (vervangt `user_id_1` uit `20250115110745_oauth_user_id_index_no_partial.mjs`, die `pat_user_id_1` uit `20230426095212_personal_oauth_tokens_user_index.mjs` verving) |
| `accessTokenExpiresAt_1` | `{ accessTokenExpiresAt: 1 }` | TTL, `expireAfterSeconds: 86400`, gedeeltelijk: `accessTokenExpiresAt` bestaat | `20260511104500_expire_oauthAccessTokens.mjs` |

De migraties staan in `tools/migrations/`. De unieke index `accessToken_1` komt alleen uit migraties met de tags `saas` en `server-pro`, dus in Community Edition is er geen index op `accessToken`.

#### Opmerkingen

* Een gebruiker verwijderen verwijdert zijn tokens niet. `UserDeleter` activeert de hook `cleanupPersonalAccessTokens` (`services/web/app/src/Features/User/UserDeleter.mjs:230-234`), maar geen module luistert ernaar. Beide tokencontroles weigeren de tokens omdat de gebruiker niet meer bestaat, en de TTL-index verwijdert ze een dag na `accessTokenExpiresAt`.
* Een gebruiker schorsen beëindigt alleen de sessies. De tokens blijven, en beide tokencontroles weigeren ze zolang `users.suspended` `true` is (`OAuth2Model.mjs:51-54`, `OAuthPersonalAccessTokenManager.mjs:129-134`).


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