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

# Koleksi OAuth Access Tokens

`oauthAccessTokens` menyimpan token bearer yang diterima web. Di Ayakaleaf Pro, ini adalah token akses pribadi (token autentikasi Git) yang dibuat pengguna di halaman pengaturan akun dan dipakai untuk git-bridge serta endpoint MCP. Satu dokumen adalah satu token. Skemanya adalah `services/web/app/src/models/OauthAccessToken.mjs`; modul web `oauth2-server` menulis koleksi ini, sebagian besar dengan driver native.

#### Field

| Field | Tipe | Arti | Sumber |
| - | - | - | - |
| `_id` | ObjectId | Id dokumen token. Halaman pengaturan menghapus token berdasarkan id ini. | `OauthAccessToken.mjs:6` |
| `accessToken` | String | Digest heksadesimal SHA-256 dari token. Token aslinya, `olp_` ditambah 36 huruf dan angka acak, ditampilkan sekali saat dibuat dan tidak pernah disimpan. | `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 | 8 karakter pertama dari token asli, ditampilkan di daftar token. | `OauthAccessToken.mjs:9`, `OAuthPersonalAccessTokenManager.mjs:73` |
| `type` | String | `personal_access_token` untuk setiap token yang dibuat di halaman pengaturan. Kueri daftar, hitung, dan hapus memfilter field ini. | `OauthAccessToken.mjs:10`, `OAuthPersonalAccessTokenManager.mjs:75` |
| `accessTokenExpiresAt` | Date | Satu tahun setelah dibuat. Kedua pemeriksaan token menolak token setelah waktu ini, dan indeks TTL menghapusnya sehari kemudian. | `OauthAccessToken.mjs:11`, `OAuthPersonalAccessTokenManager.mjs:65-68,77` |
| `oauthApplication_id` | ObjectId | `_id` dari klien `Overleaf Git Bridge` di [OAuth Applications](https://ayakaleaf-pro.mintlify.site/id/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:12`, `OAuthPersonalAccessTokenManager.mjs:55-56,74` |
| `scope` | String | Scope yang dipisahkan spasi. Token akses pribadi mendapat `git_bridge`, scope yang diwajibkan rute git-bridge dan MCP. | `OauthAccessToken.mjs:15`, `OAuthPersonalAccessTokenManager.mjs:76` |
| `user_id` | String (ObjectId in the schema) | Pemilik token. `createToken` menyimpan id pengguna dari sesi apa adanya, sebagai string, dengan driver native; panel admin mengkuerinya sebagai string (`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 | Waktu pembuatan. Daftar token diurutkan berdasarkan field ini, terbaru lebih dulu. | `OauthAccessToken.mjs:17`, `OAuthPersonalAccessTokenManager.mjs:21-22,64,79` |
| `lastUsedAt` | Date | Terakhir kali token lolos pemeriksaan. Kedua pemeriksaan token mengisinya. | `OauthAccessToken.mjs:19`, `services/web/modules/oauth2-server/app/src/OAuth2Model.mjs:58-61`, `OAuthPersonalAccessTokenManager.mjs:136-140` |
| `refreshToken`, `refreshTokenExpiresAt` | String, Date | Hanya `saveToken` yang menulisnya (refresh token dalam bentuk hash), dan tidak ada yang memanggil `saveToken`, lihat [OAuth Applications](https://ayakaleaf-pro.mintlify.site/id/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:13-14`, `OAuth2Model.mjs:249-252` |
| `expiresAt` | Date | Hanya ada di skema: tidak ada kode di repositori ini yang menulisnya. Sebuah indeks TTL mencakupnya. | `OauthAccessToken.mjs:18` |
| `lastNotifiedAt.warning`, `lastNotifiedAt.expired`, `notificationsSuppressedAt` | Date | Hanya ada di skema: tidak ada kode di repositori ini yang membaca atau menulisnya. | `OauthAccessToken.mjs:20-27` |

#### Siapa yang menulis

| Kode | Fungsinya |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:53-88` (`createToken`) | Menyisipkan token akses pribadi. Rute `POST /oauth/personal-access-tokens` (`services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenRouter.mjs:22-27`) memerlukan fitur `gitBridge` milik pengguna dan mengizinkan 10 token per pengguna (`OAuthPersonalAccessTokenController.mjs:7,34-38`). |
| `OAuthPersonalAccessTokenManager.mjs:90-105` (`removeToken`) | Menghapus satu token milik pengguna. Rute `DELETE /oauth/personal-access-tokens/:token_id` (`OAuthPersonalAccessTokenRouter.mjs:29-32`). |
| `OAuthPersonalAccessTokenManager.mjs:136-140`, `OAuth2Model.mjs:58-61` | Mengisi `lastUsedAt` setelah pemeriksaan berhasil. |

#### Siapa yang membaca

| Kode | Fungsinya |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:107-144` (`verifyToken`) | Memeriksa token lewat hash-nya untuk `GET /oauth/token/info` (`OAuthPersonalAccessTokenRouter.mjs:11-15`), yang dipanggil git-bridge saat git clone dan push (`services/git-bridge/src/main/java/uk/ac/ic/wlgitbridge/server/Oauth2Filter.java:285`). Menolak token kedaluwarsa dan token milik pengguna yang ditangguhkan atau dihapus. |
| `OAuth2Model.mjs:31-82` (`getAccessToken`) | Memeriksa token bearer untuk `AuthenticationController.requireOauth('git_bridge')` (`services/web/app/src/Features/Authentication/AuthenticationController.mjs:409-450`): rute API git-bridge (`services/web/modules/git-bridge/app/src/GitBridgeRouter.mjs:33-59`) dan endpoint MCP (`services/web/modules/mcp-server/app/src/McpRouter.mjs:16-22`). Menolak token kedaluwarsa dan token milik pengguna yang ditangguhkan atau dihapus. |
| `OAuthPersonalAccessTokenManager.mjs:13-50` (`listTokens`, `getUserTokenNums`) | Menampilkan token pengguna di halaman pengaturan (`GET /oauth/personal-access-tokens`) dan menghitungnya untuk batas. |
| `AdminUserListManager.mjs:388-400` (module `admin-tools`) | Menampilkan prefiks token pengguna di panel admin. |

#### Indeks

| Nama | Kunci | Opsi | Migrasi |
| - | - | - | - |
| `refreshToken_1` | `{ refreshToken: 1 }` | unik, parsial: `refreshToken` ada | `20230405190240_oauth_refresh_tokens_index.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL, `expireAfterSeconds: 0`, parsial: `expiresAt` ada | `20230406125632_oauth_tokens_ttl.mjs` |
| `user_id_1_type_1` | `{ user_id: 1, type: 1 }` | | `20250321160345_add_type_to_pat_user_id_index.mjs` (menggantikan `user_id_1` dari `20250115110745_oauth_user_id_index_no_partial.mjs`, yang menggantikan `pat_user_id_1` dari `20230426095212_personal_oauth_tokens_user_index.mjs`) |
| `accessTokenExpiresAt_1` | `{ accessTokenExpiresAt: 1 }` | TTL, `expireAfterSeconds: 86400`, parsial: `accessTokenExpiresAt` ada | `20260511104500_expire_oauthAccessTokens.mjs` |

Migrasi ada di `tools/migrations/`. Indeks unik `accessToken_1` hanya berasal dari migrasi bertag `saas` dan `server-pro`, jadi di Community Edition tidak ada indeks pada `accessToken`.

#### Catatan

* Menghapus pengguna tidak menghapus token-tokennya. `UserDeleter` memicu hook `cleanupPersonalAccessTokens` (`services/web/app/src/Features/User/UserDeleter.mjs:230-234`), tetapi tidak ada modul yang mendengarkannya. Kedua pemeriksaan token menolak token tersebut karena penggunanya sudah tidak ada, dan indeks TTL menghapusnya sehari setelah `accessTokenExpiresAt`.
* Menangguhkan pengguna hanya mengakhiri sesinya. Token tetap ada, dan kedua pemeriksaan token menolaknya selama `users.suspended` bernilai `true` (`OAuth2Model.mjs:51-54`, `OAuthPersonalAccessTokenManager.mjs:129-134`).


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