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

`oauthAccessTokens` inneholder bearer-tokenene som web godtar. I Ayakaleaf Pro er dette de personlige tilgangstokenene (Git-autentiseringstokener) som en bruker oppretter på siden for kontoinnstillinger og bruker for git-bridge og MCP-endepunktet. Ett dokument er ett token. Skjemaet er `services/web/app/src/models/OauthAccessToken.mjs`; webmodulen `oauth2-server` skriver samlingen, for det meste med den innebygde driveren.

#### Felter

| Felt | Type | Betydning | Kilde |
| - | - | - | - |
| `_id` | ObjectId | Id-en til tokendokumentet. Innstillingssiden sletter et token via denne id-en. | `OauthAccessToken.mjs:6` |
| `accessToken` | String | SHA-256-heksdigest av tokenet. Klartekst-tokenet, `olp_` pluss 36 tilfeldige bokstaver og sifre, vises én gang når det opprettes og lagres aldri. | `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ørste 8 tegnene i klartekst-tokenet, vist i tokenlistene. | `OauthAccessToken.mjs:9`, `OAuthPersonalAccessTokenManager.mjs:73` |
| `type` | String | `personal_access_token` for hvert token som opprettes på innstillingssiden. Spørringene for liste, antall og sletting filtrerer på det. | `OauthAccessToken.mjs:10`, `OAuthPersonalAccessTokenManager.mjs:75` |
| `accessTokenExpiresAt` | Date | Ett år etter opprettelse. Begge tokensjekkene avviser et token etter dette, og TTL-indeksen sletter det én dag senere. | `OauthAccessToken.mjs:11`, `OAuthPersonalAccessTokenManager.mjs:65-68,77` |
| `oauthApplication_id` | ObjectId | `_id` til klienten `Overleaf Git Bridge` i [OAuth Applications](https://ayakaleaf-pro.mintlify.site/no/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:12`, `OAuthPersonalAccessTokenManager.mjs:55-56,74` |
| `scope` | String | Mellomromsseparerte scopes. Personlige tilgangstokener får `git_bridge`, scopet som rutene for git-bridge og MCP krever. | `OauthAccessToken.mjs:15`, `OAuthPersonalAccessTokenManager.mjs:76` |
| `user_id` | String (ObjectId in the schema) | Eieren av tokenet. `createToken` lagrer øktens bruker-id som den er, som streng, med den innebygde driveren; adminpanelet spør etter den som streng (`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 | Tidspunkt for opprettelse. Tokenlisten er sortert etter den, nyeste først. | `OauthAccessToken.mjs:17`, `OAuthPersonalAccessTokenManager.mjs:21-22,64,79` |
| `lastUsedAt` | Date | Siste gang tokenet besto en sjekk. Begge tokensjekkene setter det. | `OauthAccessToken.mjs:19`, `services/web/modules/oauth2-server/app/src/OAuth2Model.mjs:58-61`, `OAuthPersonalAccessTokenManager.mjs:136-140` |
| `refreshToken`, `refreshTokenExpiresAt` | String, Date | Bare `saveToken` skriver dem (refresh-tokenet hashet), og ingenting kaller `saveToken`, se [OAuth Applications](https://ayakaleaf-pro.mintlify.site/no/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:13-14`, `OAuth2Model.mjs:249-252` |
| `expiresAt` | Date | Bare i skjemaet: ingen kode i dette repoet skriver det. En TTL-indeks dekker det. | `OauthAccessToken.mjs:18` |
| `lastNotifiedAt.warning`, `lastNotifiedAt.expired`, `notificationsSuppressedAt` | Date | Bare i skjemaet: ingen kode i dette repoet leser eller skriver dem. | `OauthAccessToken.mjs:20-27` |

#### Hvem skriver

| Kode | Hva den gjør |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:53-88` (`createToken`) | Setter inn et personlig tilgangstoken. Ruten `POST /oauth/personal-access-tokens` (`services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenRouter.mjs:22-27`) krever brukerens funksjon `gitBridge` og tillater 10 tokener per bruker (`OAuthPersonalAccessTokenController.mjs:7,34-38`). |
| `OAuthPersonalAccessTokenManager.mjs:90-105` (`removeToken`) | Sletter ett av brukerens tokener. Rute `DELETE /oauth/personal-access-tokens/:token_id` (`OAuthPersonalAccessTokenRouter.mjs:29-32`). |
| `OAuthPersonalAccessTokenManager.mjs:136-140`, `OAuth2Model.mjs:58-61` | Setter `lastUsedAt` etter en vellykket sjekk. |

#### Hvem leser

| Kode | Hva den gjør |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:107-144` (`verifyToken`) | Sjekker et token via hashen for `GET /oauth/token/info` (`OAuthPersonalAccessTokenRouter.mjs:11-15`), som git-bridge kaller ved git clone og push (`services/git-bridge/src/main/java/uk/ac/ic/wlgitbridge/server/Oauth2Filter.java:285`). Avviser et utløpt token og tokenet til en suspendert eller slettet bruker. |
| `OAuth2Model.mjs:31-82` (`getAccessToken`) | Sjekker et bearer-token for `AuthenticationController.requireOauth('git_bridge')` (`services/web/app/src/Features/Authentication/AuthenticationController.mjs:409-450`): API-rutene til git-bridge (`services/web/modules/git-bridge/app/src/GitBridgeRouter.mjs:33-59`) og MCP-endepunktet (`services/web/modules/mcp-server/app/src/McpRouter.mjs:16-22`). Avviser et utløpt token og tokenet til en suspendert eller slettet bruker. |
| `OAuthPersonalAccessTokenManager.mjs:13-50` (`listTokens`, `getUserTokenNums`) | Lister en brukers tokener for innstillingssiden (`GET /oauth/personal-access-tokens`) og teller dem for grensen. |
| `AdminUserListManager.mjs:388-400` (module `admin-tools`) | Viser prefiksene til en brukers tokener i adminpanelet. |

#### Indekser

| Navn | Nøkler | Alternativer | Migrering |
| - | - | - | - |
| `refreshToken_1` | `{ refreshToken: 1 }` | unik, delvis: `refreshToken` finnes | `20230405190240_oauth_refresh_tokens_index.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL, `expireAfterSeconds: 0`, delvis: `expiresAt` finnes | `20230406125632_oauth_tokens_ttl.mjs` |
| `user_id_1_type_1` | `{ user_id: 1, type: 1 }` | | `20250321160345_add_type_to_pat_user_id_index.mjs` (erstatter `user_id_1` fra `20250115110745_oauth_user_id_index_no_partial.mjs`, som erstattet `pat_user_id_1` fra `20230426095212_personal_oauth_tokens_user_index.mjs`) |
| `accessTokenExpiresAt_1` | `{ accessTokenExpiresAt: 1 }` | TTL, `expireAfterSeconds: 86400`, delvis: `accessTokenExpiresAt` finnes | `20260511104500_expire_oauthAccessTokens.mjs` |

Migreringene ligger i `tools/migrations/`. Den unike indeksen `accessToken_1` kommer bare fra migreringer merket `saas` og `server-pro`, så i Community Edition finnes det ingen indeks på `accessToken`.

#### Merknader

* Å slette en bruker sletter ikke brukerens tokener. `UserDeleter` utløser hooken `cleanupPersonalAccessTokens` (`services/web/app/src/Features/User/UserDeleter.mjs:230-234`), men ingen modul lytter på den. Begge tokensjekkene avviser tokenene fordi brukeren er borte, og TTL-indeksen fjerner dem én dag etter `accessTokenExpiresAt`.
* Å suspendere en bruker avslutter bare øktene. Tokenene blir værende, og begge tokensjekkene avviser dem så lenge `users.suspended` er `true` (`OAuth2Model.mjs:51-54`, `OAuthPersonalAccessTokenManager.mjs:129-134`).


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