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

# Kolekcja OAuth Access Tokens

`oauthAccessTokens` przechowuje tokeny bearer, które akceptuje web. W Ayakaleaf Pro są to osobiste tokeny dostępu (tokeny uwierzytelniania Git), które użytkownik tworzy na stronie ustawień konta i używa dla git-bridge oraz punktu końcowego MCP. Jeden dokument to jeden token. Schemat to `services/web/app/src/models/OauthAccessToken.mjs`; do kolekcji zapisuje moduł web `oauth2-server`, głównie przez natywny sterownik.

#### Pola

| Pole | Typ | Znaczenie | Źródło |
| - | - | - | - |
| `_id` | ObjectId | Id dokumentu tokenu. Strona ustawień usuwa token po tym id. | `OauthAccessToken.mjs:6` |
| `accessToken` | String | Szesnastkowy skrót SHA-256 tokenu. Token w postaci jawnej, `olp_` plus 36 losowych liter i cyfr, jest pokazywany raz przy tworzeniu i nigdy nie jest zapisywany. | `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 | Pierwsze 8 znaków jawnego tokenu, pokazywane na listach tokenów. | `OauthAccessToken.mjs:9`, `OAuthPersonalAccessTokenManager.mjs:73` |
| `type` | String | `personal_access_token` dla każdego tokenu utworzonego na stronie ustawień. Zapytania listy, liczenia i usuwania filtrują po nim. | `OauthAccessToken.mjs:10`, `OAuthPersonalAccessTokenManager.mjs:75` |
| `accessTokenExpiresAt` | Date | Rok po utworzeniu. Po tym czasie oba sprawdzenia tokenu go odrzucają, a indeks TTL usuwa go dzień później. | `OauthAccessToken.mjs:11`, `OAuthPersonalAccessTokenManager.mjs:65-68,77` |
| `oauthApplication_id` | ObjectId | `_id` klienta `Overleaf Git Bridge` w [OAuth Applications](https://ayakaleaf-pro.mintlify.site/pl/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:12`, `OAuthPersonalAccessTokenManager.mjs:55-56,74` |
| `scope` | String | Zakresy rozdzielone spacjami. Osobiste tokeny dostępu dostają `git_bridge`, zakres wymagany przez trasy git-bridge i MCP. | `OauthAccessToken.mjs:15`, `OAuthPersonalAccessTokenManager.mjs:76` |
| `user_id` | String (ObjectId in the schema) | Właściciel tokenu. `createToken` zapisuje id użytkownika z sesji bez zmian, jako ciąg znaków, przez natywny sterownik; panel administracyjny wyszukuje go jako ciąg znaków (`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 | Czas utworzenia. Lista tokenów jest według niego posortowana, od najnowszych. | `OauthAccessToken.mjs:17`, `OAuthPersonalAccessTokenManager.mjs:21-22,64,79` |
| `lastUsedAt` | Date | Ostatni raz, gdy token przeszedł sprawdzenie. Ustawiają go oba sprawdzenia tokenu. | `OauthAccessToken.mjs:19`, `services/web/modules/oauth2-server/app/src/OAuth2Model.mjs:58-61`, `OAuthPersonalAccessTokenManager.mjs:136-140` |
| `refreshToken`, `refreshTokenExpiresAt` | String, Date | Zapisuje je tylko `saveToken` (refresh token jako hash), a nic nie wywołuje `saveToken`, zobacz [OAuth Applications](https://ayakaleaf-pro.mintlify.site/pl/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:13-14`, `OAuth2Model.mjs:249-252` |
| `expiresAt` | Date | Tylko w schemacie: żaden kod w tym repozytorium go nie zapisuje. Obejmuje go indeks TTL. | `OauthAccessToken.mjs:18` |
| `lastNotifiedAt.warning`, `lastNotifiedAt.expired`, `notificationsSuppressedAt` | Date | Tylko w schemacie: żaden kod w tym repozytorium ich nie odczytuje ani nie zapisuje. | `OauthAccessToken.mjs:20-27` |

#### Kto zapisuje

| Kod | Co robi |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:53-88` (`createToken`) | Wstawia osobisty token dostępu. Trasa `POST /oauth/personal-access-tokens` (`services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenRouter.mjs:22-27`) wymaga funkcji `gitBridge` użytkownika i pozwala na 10 tokenów na użytkownika (`OAuthPersonalAccessTokenController.mjs:7,34-38`). |
| `OAuthPersonalAccessTokenManager.mjs:90-105` (`removeToken`) | Usuwa jeden token użytkownika. Trasa `DELETE /oauth/personal-access-tokens/:token_id` (`OAuthPersonalAccessTokenRouter.mjs:29-32`). |
| `OAuthPersonalAccessTokenManager.mjs:136-140`, `OAuth2Model.mjs:58-61` | Ustawiają `lastUsedAt` po udanym sprawdzeniu. |

#### Kto odczytuje

| Kod | Co robi |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:107-144` (`verifyToken`) | Sprawdza token po jego hashu dla `GET /oauth/token/info` (`OAuthPersonalAccessTokenRouter.mjs:11-15`), które git-bridge wywołuje przy git clone i push (`services/git-bridge/src/main/java/uk/ac/ic/wlgitbridge/server/Oauth2Filter.java:285`). Odrzuca wygasły token i token zawieszonego lub usuniętego użytkownika. |
| `OAuth2Model.mjs:31-82` (`getAccessToken`) | Sprawdza token bearer dla `AuthenticationController.requireOauth('git_bridge')` (`services/web/app/src/Features/Authentication/AuthenticationController.mjs:409-450`): trasy API git-bridge (`services/web/modules/git-bridge/app/src/GitBridgeRouter.mjs:33-59`) i punkt końcowy MCP (`services/web/modules/mcp-server/app/src/McpRouter.mjs:16-22`). Odrzuca wygasły token i token zawieszonego lub usuniętego użytkownika. |
| `OAuthPersonalAccessTokenManager.mjs:13-50` (`listTokens`, `getUserTokenNums`) | Wyświetla tokeny użytkownika na stronie ustawień (`GET /oauth/personal-access-tokens`) i liczy je na potrzeby limitu. |
| `AdminUserListManager.mjs:388-400` (module `admin-tools`) | Pokazuje prefiksy tokenów użytkownika w panelu administracyjnym. |

#### Indeksy

| Nazwa | Klucze | Opcje | Migracja |
| - | - | - | - |
| `refreshToken_1` | `{ refreshToken: 1 }` | unikalny, częściowy: `refreshToken` istnieje | `20230405190240_oauth_refresh_tokens_index.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL, `expireAfterSeconds: 0`, częściowy: `expiresAt` istnieje | `20230406125632_oauth_tokens_ttl.mjs` |
| `user_id_1_type_1` | `{ user_id: 1, type: 1 }` | | `20250321160345_add_type_to_pat_user_id_index.mjs` (zastępuje `user_id_1` z `20250115110745_oauth_user_id_index_no_partial.mjs`, który zastąpił `pat_user_id_1` z `20230426095212_personal_oauth_tokens_user_index.mjs`) |
| `accessTokenExpiresAt_1` | `{ accessTokenExpiresAt: 1 }` | TTL, `expireAfterSeconds: 86400`, częściowy: `accessTokenExpiresAt` istnieje | `20260511104500_expire_oauthAccessTokens.mjs` |

Migracje znajdują się w `tools/migrations/`. Unikalny indeks `accessToken_1` pochodzi tylko z migracji oznaczonych `saas` i `server-pro`, więc w Community Edition nie ma indeksu na `accessToken`.

#### Uwagi

* Usunięcie użytkownika nie usuwa jego tokenów. `UserDeleter` wywołuje hook `cleanupPersonalAccessTokens` (`services/web/app/src/Features/User/UserDeleter.mjs:230-234`), ale żaden moduł go nie nasłuchuje. Oba sprawdzenia tokenu odrzucają takie tokeny, bo użytkownik już nie istnieje, a indeks TTL usuwa je dzień po `accessTokenExpiresAt`.
* Zawieszenie użytkownika kończy tylko sesje. Tokeny zostają, a oba sprawdzenia tokenu odrzucają je, dopóki `users.suspended` ma wartość `true` (`OAuth2Model.mjs:51-54`, `OAuthPersonalAccessTokenManager.mjs:129-134`).


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