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

`oauthAccessTokens`, web'in kabul ettiği bearer tokenleri tutar. Ayakaleaf Pro'da bunlar, kullanıcının hesap ayarları sayfasında oluşturduğu ve git-bridge ile MCP uç noktası için kullandığı kişisel erişim tokenleridir (Git kimlik doğrulama tokenleri). Bir belge bir tokendir. Şema `services/web/app/src/models/OauthAccessToken.mjs` dosyasındadır; koleksiyona `oauth2-server` web modülü, çoğunlukla yerel sürücüyle yazar.

#### Alanlar

| Alan | Tür | Anlam | Kaynak |
| - | - | - | - |
| `_id` | ObjectId | Token belgesinin id'si. Ayarlar sayfası bir tokeni bu id ile siler. | `OauthAccessToken.mjs:6` |
| `accessToken` | String | Tokenin SHA-256 onaltılık özeti. Düz token, yani `olp_` ve 36 rastgele harf ve rakam, oluşturulduğunda bir kez gösterilir ve asla saklanmaz. | `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 | Düz tokenin ilk 8 karakteri; token listelerinde gösterilir. | `OauthAccessToken.mjs:9`, `OAuthPersonalAccessTokenManager.mjs:73` |
| `type` | String | Ayarlar sayfasında oluşturulan her token için `personal_access_token`. Listeleme, sayma ve silme sorguları buna göre filtreler. | `OauthAccessToken.mjs:10`, `OAuthPersonalAccessTokenManager.mjs:75` |
| `accessTokenExpiresAt` | Date | Oluşturulduktan bir yıl sonra. Bundan sonra iki token denetimi de tokeni reddeder ve TTL indeksi onu bir gün sonra siler. | `OauthAccessToken.mjs:11`, `OAuthPersonalAccessTokenManager.mjs:65-68,77` |
| `oauthApplication_id` | ObjectId | [OAuth Applications](https://ayakaleaf-pro.mintlify.site/tr/dev/data-model/oauth-applications-collection.md) içindeki `Overleaf Git Bridge` istemcisinin `_id` değeri. | `OauthAccessToken.mjs:12`, `OAuthPersonalAccessTokenManager.mjs:55-56,74` |
| `scope` | String | Boşlukla ayrılmış scope'lar. Kişisel erişim tokenleri, git-bridge ve MCP route'larının gerektirdiği `git_bridge` scope'unu alır. | `OauthAccessToken.mjs:15`, `OAuthPersonalAccessTokenManager.mjs:76` |
| `user_id` | String (ObjectId in the schema) | Tokenin sahibi. `createToken`, oturumdaki kullanıcı id'sini olduğu gibi, string olarak yerel sürücüyle saklar; yönetim paneli de onu string olarak sorgular (`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 | Oluşturulma zamanı. Token listesi buna göre, en yenisi önce sıralanır. | `OauthAccessToken.mjs:17`, `OAuthPersonalAccessTokenManager.mjs:21-22,64,79` |
| `lastUsedAt` | Date | Tokenin son kez bir denetimi geçtiği zaman. İki token denetimi de bunu ayarlar. | `OauthAccessToken.mjs:19`, `services/web/modules/oauth2-server/app/src/OAuth2Model.mjs:58-61`, `OAuthPersonalAccessTokenManager.mjs:136-140` |
| `refreshToken`, `refreshTokenExpiresAt` | String, Date | Bunları yalnızca `saveToken` yazar (refresh token hash'lenmiş olarak) ve hiçbir şey `saveToken` çağırmaz, bkz. [OAuth Applications](https://ayakaleaf-pro.mintlify.site/tr/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:13-14`, `OAuth2Model.mjs:249-252` |
| `expiresAt` | Date | Yalnızca şemada: bu depodaki hiçbir kod onu yazmaz. Bir TTL indeksi onu kapsar. | `OauthAccessToken.mjs:18` |
| `lastNotifiedAt.warning`, `lastNotifiedAt.expired`, `notificationsSuppressedAt` | Date | Yalnızca şemada: bu depodaki hiçbir kod bunları okumaz veya yazmaz. | `OauthAccessToken.mjs:20-27` |

#### Kim yazar

| Kod | Ne yapar |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:53-88` (`createToken`) | Bir kişisel erişim tokeni ekler. `POST /oauth/personal-access-tokens` route'u (`services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenRouter.mjs:22-27`) kullanıcının `gitBridge` özelliğini gerektirir ve kullanıcı başına 10 tokene izin verir (`OAuthPersonalAccessTokenController.mjs:7,34-38`). |
| `OAuthPersonalAccessTokenManager.mjs:90-105` (`removeToken`) | Kullanıcının bir tokenini siler. Route `DELETE /oauth/personal-access-tokens/:token_id` (`OAuthPersonalAccessTokenRouter.mjs:29-32`). |
| `OAuthPersonalAccessTokenManager.mjs:136-140`, `OAuth2Model.mjs:58-61` | Başarılı bir denetimden sonra `lastUsedAt` değerini ayarlar. |

#### Kim okur

| Kod | Ne yapar |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:107-144` (`verifyToken`) | `GET /oauth/token/info` (`OAuthPersonalAccessTokenRouter.mjs:11-15`) için tokeni hash'iyle denetler; git-bridge bunu git clone ve push sırasında çağırır (`services/git-bridge/src/main/java/uk/ac/ic/wlgitbridge/server/Oauth2Filter.java:285`). Süresi dolmuş tokeni ve askıya alınmış ya da silinmiş bir kullanıcının tokenini reddeder. |
| `OAuth2Model.mjs:31-82` (`getAccessToken`) | `AuthenticationController.requireOauth('git_bridge')` (`services/web/app/src/Features/Authentication/AuthenticationController.mjs:409-450`) için bearer tokeni denetler: git-bridge API route'ları (`services/web/modules/git-bridge/app/src/GitBridgeRouter.mjs:33-59`) ve MCP uç noktası (`services/web/modules/mcp-server/app/src/McpRouter.mjs:16-22`). Süresi dolmuş tokeni ve askıya alınmış ya da silinmiş bir kullanıcının tokenini reddeder. |
| `OAuthPersonalAccessTokenManager.mjs:13-50` (`listTokens`, `getUserTokenNums`) | Ayarlar sayfası için kullanıcının tokenlerini listeler (`GET /oauth/personal-access-tokens`) ve sınır için sayar. |
| `AdminUserListManager.mjs:388-400` (module `admin-tools`) | Yönetim panelinde kullanıcının token öneklerini gösterir. |

#### İndeksler

| Ad | Anahtarlar | Seçenekler | Migration |
| - | - | - | - |
| `refreshToken_1` | `{ refreshToken: 1 }` | benzersiz, kısmi: `refreshToken` mevcut | `20230405190240_oauth_refresh_tokens_index.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL, `expireAfterSeconds: 0`, kısmi: `expiresAt` mevcut | `20230406125632_oauth_tokens_ttl.mjs` |
| `user_id_1_type_1` | `{ user_id: 1, type: 1 }` | | `20250321160345_add_type_to_pat_user_id_index.mjs` (`20250115110745_oauth_user_id_index_no_partial.mjs` içindeki `user_id_1` indeksinin yerini alır; o da `20230426095212_personal_oauth_tokens_user_index.mjs` içindeki `pat_user_id_1` indeksinin yerini almıştı) |
| `accessTokenExpiresAt_1` | `{ accessTokenExpiresAt: 1 }` | TTL, `expireAfterSeconds: 86400`, kısmi: `accessTokenExpiresAt` mevcut | `20260511104500_expire_oauthAccessTokens.mjs` |

Migration'lar `tools/migrations/` içindedir. Benzersiz `accessToken_1` indeksi yalnızca `saas` ve `server-pro` etiketli migration'lardan gelir, bu yüzden Community Edition'da `accessToken` üzerinde indeks yoktur.

#### Notlar

* Bir kullanıcıyı silmek tokenlerini silmez. `UserDeleter`, `cleanupPersonalAccessTokens` hook'unu tetikler (`services/web/app/src/Features/User/UserDeleter.mjs:230-234`), ancak hiçbir modül onu dinlemez. Kullanıcı artık olmadığı için iki token denetimi de tokenleri reddeder ve TTL indeksi onları `accessTokenExpiresAt` zamanından bir gün sonra kaldırır.
* Bir kullanıcıyı askıya almak yalnızca oturumlarını sonlandırır. Tokenler kalır ve `users.suspended` `true` olduğu sürece iki token denetimi de onları reddeder (`OAuth2Model.mjs:51-54`, `OAuthPersonalAccessTokenManager.mjs:129-134`).


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