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

# Samlingen OAuth Access Tokens

`oauthAccessTokens` innehåller de bearer-token som web accepterar. I Ayakaleaf Pro är det de personliga åtkomsttoken (Git-autentiseringstoken) som en användare skapar på sidan för kontoinställningar och använder för git-bridge och MCP-slutpunkten. Ett dokument är en token. Schemat är `services/web/app/src/models/OauthAccessToken.mjs`; webbmodulen `oauth2-server` skriver samlingen, mest med den inbyggda drivrutinen.

#### Fält

| Fält | Typ | Betydelse | Källa |
| - | - | - | - |
| `_id` | ObjectId | Tokendokumentets id. Inställningssidan tar bort en token via detta id. | `OauthAccessToken.mjs:6` |
| `accessToken` | String | SHA-256-hexsammandrag av token. Klartexttoken, `olp_` plus 36 slumpmässiga bokstäver och siffror, visas en gång när den skapas och sparas aldrig. | `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 första 8 tecknen i klartexttoken, som visas i tokenlistorna. | `OauthAccessToken.mjs:9`, `OAuthPersonalAccessTokenManager.mjs:73` |
| `type` | String | `personal_access_token` för varje token som skapas på inställningssidan. Frågorna för lista, antal och borttagning filtrerar på det. | `OauthAccessToken.mjs:10`, `OAuthPersonalAccessTokenManager.mjs:75` |
| `accessTokenExpiresAt` | Date | Ett år efter skapandet. Båda tokenkontrollerna avvisar en token efter det, och TTL-indexet tar bort den en dag senare. | `OauthAccessToken.mjs:11`, `OAuthPersonalAccessTokenManager.mjs:65-68,77` |
| `oauthApplication_id` | ObjectId | `_id` för klienten `Overleaf Git Bridge` i [OAuth Applications](https://ayakaleaf-pro.mintlify.site/sv/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:12`, `OAuthPersonalAccessTokenManager.mjs:55-56,74` |
| `scope` | String | Mellanslagsseparerade scopes. Personliga åtkomsttoken får `git_bridge`, den scope som routerna för git-bridge och MCP kräver. | `OauthAccessToken.mjs:15`, `OAuthPersonalAccessTokenManager.mjs:76` |
| `user_id` | String (ObjectId in the schema) | Tokenens ägare. `createToken` sparar sessionens användar-id som det är, som sträng, med den inbyggda drivrutinen; adminpanelen söker på det som sträng (`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 | Tidpunkt för skapande. Tokenlistan sorteras efter den, nyast först. | `OauthAccessToken.mjs:17`, `OAuthPersonalAccessTokenManager.mjs:21-22,64,79` |
| `lastUsedAt` | Date | Senaste gången token klarade en kontroll. Båda tokenkontrollerna sätter det. | `OauthAccessToken.mjs:19`, `services/web/modules/oauth2-server/app/src/OAuth2Model.mjs:58-61`, `OAuthPersonalAccessTokenManager.mjs:136-140` |
| `refreshToken`, `refreshTokenExpiresAt` | String, Date | Bara `saveToken` skriver dem (refresh-token hashad), och inget anropar `saveToken`, se [OAuth Applications](https://ayakaleaf-pro.mintlify.site/sv/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:13-14`, `OAuth2Model.mjs:249-252` |
| `expiresAt` | Date | Bara i schemat: ingen kod i detta repo skriver det. Ett TTL-index täcker det. | `OauthAccessToken.mjs:18` |
| `lastNotifiedAt.warning`, `lastNotifiedAt.expired`, `notificationsSuppressedAt` | Date | Bara i schemat: ingen kod i detta repo läser eller skriver dem. | `OauthAccessToken.mjs:20-27` |

#### Vem skriver

| Kod | Vad den gör |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:53-88` (`createToken`) | Infogar en personlig åtkomsttoken. Routen `POST /oauth/personal-access-tokens` (`services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenRouter.mjs:22-27`) kräver användarens funktion `gitBridge` och tillåter 10 token per användare (`OAuthPersonalAccessTokenController.mjs:7,34-38`). |
| `OAuthPersonalAccessTokenManager.mjs:90-105` (`removeToken`) | Tar bort en av användarens token. Route `DELETE /oauth/personal-access-tokens/:token_id` (`OAuthPersonalAccessTokenRouter.mjs:29-32`). |
| `OAuthPersonalAccessTokenManager.mjs:136-140`, `OAuth2Model.mjs:58-61` | Sätter `lastUsedAt` efter en lyckad kontroll. |

#### Vem läser

| Kod | Vad den gör |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:107-144` (`verifyToken`) | Kontrollerar en token via dess hash för `GET /oauth/token/info` (`OAuthPersonalAccessTokenRouter.mjs:11-15`), som git-bridge anropar vid git clone och push (`services/git-bridge/src/main/java/uk/ac/ic/wlgitbridge/server/Oauth2Filter.java:285`). Avvisar en utgången token och token för en avstängd eller borttagen användare. |
| `OAuth2Model.mjs:31-82` (`getAccessToken`) | Kontrollerar en bearer-token för `AuthenticationController.requireOauth('git_bridge')` (`services/web/app/src/Features/Authentication/AuthenticationController.mjs:409-450`): git-bridges API-router (`services/web/modules/git-bridge/app/src/GitBridgeRouter.mjs:33-59`) och MCP-slutpunkten (`services/web/modules/mcp-server/app/src/McpRouter.mjs:16-22`). Avvisar en utgången token och token för en avstängd eller borttagen användare. |
| `OAuthPersonalAccessTokenManager.mjs:13-50` (`listTokens`, `getUserTokenNums`) | Listar en användares token för inställningssidan (`GET /oauth/personal-access-tokens`) och räknar dem för gränsen. |
| `AdminUserListManager.mjs:388-400` (module `admin-tools`) | Visar prefixen för en användares token i adminpanelen. |

#### Index

| Namn | Nycklar | Alternativ | Migrering |
| - | - | - | - |
| `refreshToken_1` | `{ refreshToken: 1 }` | unikt, partiellt: `refreshToken` finns | `20230405190240_oauth_refresh_tokens_index.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL, `expireAfterSeconds: 0`, partiellt: `expiresAt` finns | `20230406125632_oauth_tokens_ttl.mjs` |
| `user_id_1_type_1` | `{ user_id: 1, type: 1 }` | | `20250321160345_add_type_to_pat_user_id_index.mjs` (ersätter `user_id_1` från `20250115110745_oauth_user_id_index_no_partial.mjs`, som ersatte `pat_user_id_1` från `20230426095212_personal_oauth_tokens_user_index.mjs`) |
| `accessTokenExpiresAt_1` | `{ accessTokenExpiresAt: 1 }` | TTL, `expireAfterSeconds: 86400`, partiellt: `accessTokenExpiresAt` finns | `20260511104500_expire_oauthAccessTokens.mjs` |

Migreringarna finns i `tools/migrations/`. Det unika indexet `accessToken_1` kommer bara från migreringar taggade `saas` och `server-pro`, så i Community Edition finns inget index på `accessToken`.

#### Anteckningar

* När en användare tas bort tas inte användarens token bort. `UserDeleter` utlöser hooken `cleanupPersonalAccessTokens` (`services/web/app/src/Features/User/UserDeleter.mjs:230-234`), men ingen modul lyssnar på den. Båda tokenkontrollerna avvisar token eftersom användaren är borta, och TTL-indexet tar bort dem en dag efter `accessTokenExpiresAt`.
* Att stänga av en användare avslutar bara sessionerna. Token finns kvar, och båda tokenkontrollerna avvisar dem så länge `users.suspended` är `true` (`OAuth2Model.mjs:51-54`, `OAuthPersonalAccessTokenManager.mjs:129-134`).


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