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

`oauthAccessTokens` sisältää bearer-tokenit, jotka web hyväksyy. Ayakaleaf Prossa ne ovat henkilökohtaisia käyttötunnuksia (Git-todennustunnuksia), jotka käyttäjä luo tiliasetusten sivulla ja joita hän käyttää git-bridgeen ja MCP-päätepisteeseen. Yksi dokumentti on yksi tunnus. Skeema on `services/web/app/src/models/OauthAccessToken.mjs`; web-moduuli `oauth2-server` kirjoittaa kokoelmaan, enimmäkseen natiivilla ajurilla.

#### Kentät

| Kenttä | Tyyppi | Merkitys | Lähde |
| - | - | - | - |
| `_id` | ObjectId | Tunnusdokumentin id. Asetussivu poistaa tunnuksen tällä id:llä. | `OauthAccessToken.mjs:6` |
| `accessToken` | String | Tunnuksen SHA-256-tiiviste heksamuodossa. Selväkielinen tunnus, `olp_` ja 36 satunnaista kirjainta ja numeroa, näytetään kerran luonnin yhteydessä eikä sitä koskaan tallenneta. | `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 | Selväkielisen tunnuksen 8 ensimmäistä merkkiä, jotka näytetään tunnuslistoissa. | `OauthAccessToken.mjs:9`, `OAuthPersonalAccessTokenManager.mjs:73` |
| `type` | String | `personal_access_token` jokaiselle asetussivulla luodulle tunnukselle. Listaus-, laskenta- ja poistokyselyt suodattavat sen mukaan. | `OauthAccessToken.mjs:10`, `OAuthPersonalAccessTokenManager.mjs:75` |
| `accessTokenExpiresAt` | Date | Vuosi luonnin jälkeen. Molemmat tunnustarkistukset hylkäävät tunnuksen sen jälkeen, ja TTL-indeksi poistaa sen päivää myöhemmin. | `OauthAccessToken.mjs:11`, `OAuthPersonalAccessTokenManager.mjs:65-68,77` |
| `oauthApplication_id` | ObjectId | Asiakkaan `Overleaf Git Bridge` `_id` kokoelmassa [OAuth Applications](https://ayakaleaf-pro.mintlify.site/fi/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:12`, `OAuthPersonalAccessTokenManager.mjs:55-56,74` |
| `scope` | String | Välilyönnein erotetut scopet. Henkilökohtaiset käyttötunnukset saavat scopen `git_bridge`, jota git-bridgen ja MCP:n reitit vaativat. | `OauthAccessToken.mjs:15`, `OAuthPersonalAccessTokenManager.mjs:76` |
| `user_id` | String (ObjectId in the schema) | Tunnuksen omistaja. `createToken` tallentaa istunnon käyttäjä-id:n sellaisenaan merkkijonona natiivilla ajurilla; hallintapaneeli hakee sitä merkkijonona (`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 | Luontiaika. Tunnuslista lajitellaan sen mukaan uusin ensin. | `OauthAccessToken.mjs:17`, `OAuthPersonalAccessTokenManager.mjs:21-22,64,79` |
| `lastUsedAt` | Date | Viimeisin kerta, kun tunnus läpäisi tarkistuksen. Molemmat tunnustarkistukset asettavat sen. | `OauthAccessToken.mjs:19`, `services/web/modules/oauth2-server/app/src/OAuth2Model.mjs:58-61`, `OAuthPersonalAccessTokenManager.mjs:136-140` |
| `refreshToken`, `refreshTokenExpiresAt` | String, Date | Vain `saveToken` kirjoittaa ne (refresh-tunnuksen tiivisteenä), eikä mikään kutsu `saveToken`-funktiota, katso [OAuth Applications](https://ayakaleaf-pro.mintlify.site/fi/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:13-14`, `OAuth2Model.mjs:249-252` |
| `expiresAt` | Date | Vain skeemassa: mikään tämän repositorion koodi ei kirjoita sitä. TTL-indeksi kattaa sen. | `OauthAccessToken.mjs:18` |
| `lastNotifiedAt.warning`, `lastNotifiedAt.expired`, `notificationsSuppressedAt` | Date | Vain skeemassa: mikään tämän repositorion koodi ei lue tai kirjoita niitä. | `OauthAccessToken.mjs:20-27` |

#### Kuka kirjoittaa

| Koodi | Mitä se tekee |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:53-88` (`createToken`) | Lisää henkilökohtaisen käyttötunnuksen. Reitti `POST /oauth/personal-access-tokens` (`services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenRouter.mjs:22-27`) vaatii käyttäjältä ominaisuuden `gitBridge` ja sallii 10 tunnusta käyttäjää kohden (`OAuthPersonalAccessTokenController.mjs:7,34-38`). |
| `OAuthPersonalAccessTokenManager.mjs:90-105` (`removeToken`) | Poistaa yhden käyttäjän tunnuksen. Reitti `DELETE /oauth/personal-access-tokens/:token_id` (`OAuthPersonalAccessTokenRouter.mjs:29-32`). |
| `OAuthPersonalAccessTokenManager.mjs:136-140`, `OAuth2Model.mjs:58-61` | Asettavat `lastUsedAt`-kentän onnistuneen tarkistuksen jälkeen. |

#### Kuka lukee

| Koodi | Mitä se tekee |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:107-144` (`verifyToken`) | Tarkistaa tunnuksen tiivisteen perusteella reitille `GET /oauth/token/info` (`OAuthPersonalAccessTokenRouter.mjs:11-15`), jota git-bridge kutsuu git clonessa ja pushissa (`services/git-bridge/src/main/java/uk/ac/ic/wlgitbridge/server/Oauth2Filter.java:285`). Hylkää vanhentuneen tunnuksen sekä jäädytetyn tai poistetun käyttäjän tunnuksen. |
| `OAuth2Model.mjs:31-82` (`getAccessToken`) | Tarkistaa bearer-tokenin kohteelle `AuthenticationController.requireOauth('git_bridge')` (`services/web/app/src/Features/Authentication/AuthenticationController.mjs:409-450`): git-bridgen API-reitit (`services/web/modules/git-bridge/app/src/GitBridgeRouter.mjs:33-59`) ja MCP-päätepiste (`services/web/modules/mcp-server/app/src/McpRouter.mjs:16-22`). Hylkää vanhentuneen tunnuksen sekä jäädytetyn tai poistetun käyttäjän tunnuksen. |
| `OAuthPersonalAccessTokenManager.mjs:13-50` (`listTokens`, `getUserTokenNums`) | Listaa käyttäjän tunnukset asetussivulle (`GET /oauth/personal-access-tokens`) ja laskee ne rajaa varten. |
| `AdminUserListManager.mjs:388-400` (module `admin-tools`) | Näyttää käyttäjän tunnusten etuliitteet hallintapaneelissa. |

#### Indeksit

| Nimi | Avaimet | Asetukset | Migraatio |
| - | - | - | - |
| `refreshToken_1` | `{ refreshToken: 1 }` | yksilöllinen, osittainen: `refreshToken` on olemassa | `20230405190240_oauth_refresh_tokens_index.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL, `expireAfterSeconds: 0`, osittainen: `expiresAt` on olemassa | `20230406125632_oauth_tokens_ttl.mjs` |
| `user_id_1_type_1` | `{ user_id: 1, type: 1 }` | | `20250321160345_add_type_to_pat_user_id_index.mjs` (korvaa indeksin `user_id_1` migraatiosta `20250115110745_oauth_user_id_index_no_partial.mjs`, joka korvasi indeksin `pat_user_id_1` migraatiosta `20230426095212_personal_oauth_tokens_user_index.mjs`) |
| `accessTokenExpiresAt_1` | `{ accessTokenExpiresAt: 1 }` | TTL, `expireAfterSeconds: 86400`, osittainen: `accessTokenExpiresAt` on olemassa | `20260511104500_expire_oauthAccessTokens.mjs` |

Migraatiot ovat hakemistossa `tools/migrations/`. Yksilöllinen indeksi `accessToken_1` tulee vain migraatioista, joilla on tagit `saas` ja `server-pro`, joten Community Editionissa kentällä `accessToken` ei ole indeksiä.

#### Huomautukset

* Käyttäjän poistaminen ei poista hänen tunnuksiaan. `UserDeleter` laukaisee hookin `cleanupPersonalAccessTokens` (`services/web/app/src/Features/User/UserDeleter.mjs:230-234`), mutta mikään moduuli ei kuuntele sitä. Molemmat tunnustarkistukset hylkäävät tunnukset, koska käyttäjää ei enää ole, ja TTL-indeksi poistaa ne päivä kentän `accessTokenExpiresAt` jälkeen.
* Käyttäjän jäädyttäminen päättää vain istunnot. Tunnukset jäävät, ja molemmat tunnustarkistukset hylkäävät ne niin kauan kuin `users.suspended` on `true` (`OAuth2Model.mjs:51-54`, `OAuthPersonalAccessTokenManager.mjs:129-134`).


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