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

`oauthAccessTokens` enthält die Bearer-Token, die Web akzeptiert. In Ayakaleaf Pro sind das die persönlichen Zugriffstoken (Git-Authentifizierungstoken), die ein Benutzer auf der Seite mit den Kontoeinstellungen erstellt und für git-bridge und den MCP-Endpunkt verwendet. Ein Dokument ist ein Token. Das Schema ist `services/web/app/src/models/OauthAccessToken.mjs`; das Web-Modul `oauth2-server` schreibt die Collection, meist mit dem nativen Treiber.

#### Felder

| Feld | Typ | Bedeutung | Quelle |
| - | - | - | - |
| `_id` | ObjectId | Dokument-ID des Tokens. Die Einstellungsseite löscht ein Token über diese ID. | `OauthAccessToken.mjs:6` |
| `accessToken` | String | SHA-256-Hex-Digest des Tokens. Das Klartext-Token, `olp_` plus 36 zufällige Buchstaben und Ziffern, wird beim Erstellen einmal angezeigt und nie gespeichert. | `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 | Die ersten 8 Zeichen des Klartext-Tokens, angezeigt in den Token-Listen. | `OauthAccessToken.mjs:9`, `OAuthPersonalAccessTokenManager.mjs:73` |
| `type` | String | `personal_access_token` für jedes auf der Einstellungsseite erstellte Token. Die Abfragen für Liste, Anzahl und Löschen filtern darauf. | `OauthAccessToken.mjs:10`, `OAuthPersonalAccessTokenManager.mjs:75` |
| `accessTokenExpiresAt` | Date | Ein Jahr nach der Erstellung. Beide Token-Prüfungen lehnen ein Token danach ab, und der TTL-Index löscht es einen Tag später. | `OauthAccessToken.mjs:11`, `OAuthPersonalAccessTokenManager.mjs:65-68,77` |
| `oauthApplication_id` | ObjectId | `_id` des Clients `Overleaf Git Bridge` in [OAuth Applications](https://ayakaleaf-pro.mintlify.site/de/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:12`, `OAuthPersonalAccessTokenManager.mjs:55-56,74` |
| `scope` | String | Durch Leerzeichen getrennte Scopes. Persönliche Zugriffstoken erhalten `git_bridge`, den Scope, den die Routen von git-bridge und MCP verlangen. | `OauthAccessToken.mjs:15`, `OAuthPersonalAccessTokenManager.mjs:76` |
| `user_id` | String (ObjectId in the schema) | Eigentümer des Tokens. `createToken` speichert die Benutzer-ID der Sitzung unverändert als String mit dem nativen Treiber; das Admin-Panel fragt sie als String ab (`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 | Erstellungszeit. Die Token-Liste ist danach sortiert, neueste zuerst. | `OauthAccessToken.mjs:17`, `OAuthPersonalAccessTokenManager.mjs:21-22,64,79` |
| `lastUsedAt` | Date | Letzter Zeitpunkt, an dem das Token eine Prüfung bestanden hat. Beide Token-Prüfungen setzen es. | `OauthAccessToken.mjs:19`, `services/web/modules/oauth2-server/app/src/OAuth2Model.mjs:58-61`, `OAuthPersonalAccessTokenManager.mjs:136-140` |
| `refreshToken`, `refreshTokenExpiresAt` | String, Date | Nur `saveToken` schreibt sie (das Refresh-Token gehasht), und nichts ruft `saveToken` auf, siehe [OAuth Applications](https://ayakaleaf-pro.mintlify.site/de/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:13-14`, `OAuth2Model.mjs:249-252` |
| `expiresAt` | Date | Nur im Schema: Kein Code in diesem Repository schreibt es. Ein TTL-Index deckt es ab. | `OauthAccessToken.mjs:18` |
| `lastNotifiedAt.warning`, `lastNotifiedAt.expired`, `notificationsSuppressedAt` | Date | Nur im Schema: Kein Code in diesem Repository liest oder schreibt sie. | `OauthAccessToken.mjs:20-27` |

#### Wer schreibt

| Code | Funktion |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:53-88` (`createToken`) | Fügt ein persönliches Zugriffstoken ein. Die Route `POST /oauth/personal-access-tokens` (`services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenRouter.mjs:22-27`) verlangt das Feature `gitBridge` des Benutzers und erlaubt 10 Token pro Benutzer (`OAuthPersonalAccessTokenController.mjs:7,34-38`). |
| `OAuthPersonalAccessTokenManager.mjs:90-105` (`removeToken`) | Löscht ein Token des Benutzers. Route `DELETE /oauth/personal-access-tokens/:token_id` (`OAuthPersonalAccessTokenRouter.mjs:29-32`). |
| `OAuthPersonalAccessTokenManager.mjs:136-140`, `OAuth2Model.mjs:58-61` | Setzen `lastUsedAt` nach einer erfolgreichen Prüfung. |

#### Wer liest

| Code | Funktion |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:107-144` (`verifyToken`) | Prüft ein Token über seinen Hash für `GET /oauth/token/info` (`OAuthPersonalAccessTokenRouter.mjs:11-15`), das git-bridge bei git clone und push aufruft (`services/git-bridge/src/main/java/uk/ac/ic/wlgitbridge/server/Oauth2Filter.java:285`). Lehnt abgelaufene Token und Token gesperrter oder gelöschter Benutzer ab. |
| `OAuth2Model.mjs:31-82` (`getAccessToken`) | Prüft ein Bearer-Token für `AuthenticationController.requireOauth('git_bridge')` (`services/web/app/src/Features/Authentication/AuthenticationController.mjs:409-450`): die API-Routen von git-bridge (`services/web/modules/git-bridge/app/src/GitBridgeRouter.mjs:33-59`) und den MCP-Endpunkt (`services/web/modules/mcp-server/app/src/McpRouter.mjs:16-22`). Lehnt abgelaufene Token und Token gesperrter oder gelöschter Benutzer ab. |
| `OAuthPersonalAccessTokenManager.mjs:13-50` (`listTokens`, `getUserTokenNums`) | Listet die Token eines Benutzers für die Einstellungsseite auf (`GET /oauth/personal-access-tokens`) und zählt sie für das Limit. |
| `AdminUserListManager.mjs:388-400` (module `admin-tools`) | Zeigt die Token-Präfixe eines Benutzers im Admin-Panel an. |

#### Indizes

| Name | Schlüssel | Optionen | Migration |
| - | - | - | - |
| `refreshToken_1` | `{ refreshToken: 1 }` | eindeutig, partiell: `refreshToken` existiert | `20230405190240_oauth_refresh_tokens_index.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL, `expireAfterSeconds: 0`, partiell: `expiresAt` existiert | `20230406125632_oauth_tokens_ttl.mjs` |
| `user_id_1_type_1` | `{ user_id: 1, type: 1 }` | | `20250321160345_add_type_to_pat_user_id_index.mjs` (ersetzt `user_id_1` aus `20250115110745_oauth_user_id_index_no_partial.mjs`, das `pat_user_id_1` aus `20230426095212_personal_oauth_tokens_user_index.mjs` ersetzte) |
| `accessTokenExpiresAt_1` | `{ accessTokenExpiresAt: 1 }` | TTL, `expireAfterSeconds: 86400`, partiell: `accessTokenExpiresAt` existiert | `20260511104500_expire_oauthAccessTokens.mjs` |

Die Migrationen liegen in `tools/migrations/`. Der eindeutige Index `accessToken_1` stammt nur aus Migrationen mit den Tags `saas` und `server-pro`, daher gibt es in der Community Edition keinen Index auf `accessToken`.

#### Hinweise

* Das Löschen eines Benutzers löscht seine Token nicht. `UserDeleter` löst den Hook `cleanupPersonalAccessTokens` aus (`services/web/app/src/Features/User/UserDeleter.mjs:230-234`), aber kein Modul hört darauf. Beide Token-Prüfungen lehnen die Token ab, weil der Benutzer nicht mehr existiert, und der TTL-Index entfernt sie einen Tag nach `accessTokenExpiresAt`.
* Das Sperren eines Benutzers beendet nur die Sitzungen. Die Token bleiben, und beide Token-Prüfungen lehnen sie ab, solange `users.suspended` auf `true` steht (`OAuth2Model.mjs:51-54`, `OAuthPersonalAccessTokenManager.mjs:129-134`).


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