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

تحتوي `oauthAccessTokens` على رموز bearer التي يقبلها web. في Ayakaleaf Pro هذه هي رموز الوصول الشخصية (رموز مصادقة Git) التي ينشئها المستخدم في صفحة إعدادات الحساب ويستخدمها مع git-bridge ونقطة نهاية MCP. كل مستند هو رمز واحد. المخطط موجود في `services/web/app/src/models/OauthAccessToken.mjs`، وتكتب وحدة web `oauth2-server` في المجموعة، غالباً عبر برنامج التشغيل الأصلي.

#### الحقول

| الحقل | النوع | المعنى | المصدر |
| - | - | - | - |
| `_id` | ObjectId | معرّف مستند الرمز. تحذف صفحة الإعدادات الرمز بهذا المعرّف. | `OauthAccessToken.mjs:6` |
| `accessToken` | String | ملخص SHA-256 السداسي عشري للرمز. يُعرض الرمز الصريح، وهو `olp_` متبوعاً بـ 36 حرفاً ورقماً عشوائياً، مرة واحدة عند إنشائه ولا يُخزَّن أبداً. | `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 أحرف من الرمز الصريح، تُعرض في قوائم الرموز. | `OauthAccessToken.mjs:9`, `OAuthPersonalAccessTokenManager.mjs:73` |
| `type` | String | `personal_access_token` لكل رمز يُنشأ في صفحة الإعدادات. تُصفّي عليه استعلامات القائمة والعدّ والحذف. | `OauthAccessToken.mjs:10`, `OAuthPersonalAccessTokenManager.mjs:75` |
| `accessTokenExpiresAt` | Date | بعد سنة من الإنشاء. بعدها يرفض فحصا الرمز كلاهما الرمز، ويحذفه فهرس TTL بعد يوم. | `OauthAccessToken.mjs:11`, `OAuthPersonalAccessTokenManager.mjs:65-68,77` |
| `oauthApplication_id` | ObjectId | `_id` الخاص بالعميل `Overleaf Git Bridge` في [OAuth Applications](https://ayakaleaf-pro.mintlify.site/ar/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:12`, `OAuthPersonalAccessTokenManager.mjs:55-56,74` |
| `scope` | String | نطاقات مفصولة بمسافات. تحصل رموز الوصول الشخصية على `git_bridge`، وهو النطاق الذي تتطلبه مسارات git-bridge وMCP. | `OauthAccessToken.mjs:15`, `OAuthPersonalAccessTokenManager.mjs:76` |
| `user_id` | String (ObjectId in the schema) | مالك الرمز. يخزّن `createToken` معرّف مستخدم الجلسة كما هو، كسلسلة نصية، عبر برنامج التشغيل الأصلي؛ وتستعلم لوحة الإدارة عنه كسلسلة نصية (`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 | وقت الإنشاء. تُرتَّب قائمة الرموز حسبه، الأحدث أولاً. | `OauthAccessToken.mjs:17`, `OAuthPersonalAccessTokenManager.mjs:21-22,64,79` |
| `lastUsedAt` | Date | آخر مرة اجتاز فيها الرمز فحصاً. يعيّنه فحصا الرمز كلاهما. | `OauthAccessToken.mjs:19`, `services/web/modules/oauth2-server/app/src/OAuth2Model.mjs:58-61`, `OAuthPersonalAccessTokenManager.mjs:136-140` |
| `refreshToken`, `refreshTokenExpiresAt` | String, Date | لا يكتبهما إلا `saveToken` (رمز التحديث مُجزّأ)، ولا شيء يستدعي `saveToken`، انظر [OAuth Applications](https://ayakaleaf-pro.mintlify.site/ar/dev/data-model/oauth-applications-collection.md). | `OauthAccessToken.mjs:13-14`, `OAuth2Model.mjs:249-252` |
| `expiresAt` | Date | في المخطط فقط: لا تكتبه أي شيفرة في هذا المستودع. يغطيه فهرس TTL. | `OauthAccessToken.mjs:18` |
| `lastNotifiedAt.warning`, `lastNotifiedAt.expired`, `notificationsSuppressedAt` | Date | في المخطط فقط: لا تقرؤها ولا تكتبها أي شيفرة في هذا المستودع. | `OauthAccessToken.mjs:20-27` |

#### من يكتب فيها

| الشيفرة | ما تفعله |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:53-88` (`createToken`) | تُدرج رمز وصول شخصياً. يتطلب المسار `POST /oauth/personal-access-tokens` (`services/web/modules/oauth2-server/app/src/OAuthPersonalAccessTokenRouter.mjs:22-27`) ميزة `gitBridge` لدى المستخدم ويسمح بـ 10 رموز لكل مستخدم (`OAuthPersonalAccessTokenController.mjs:7,34-38`). |
| `OAuthPersonalAccessTokenManager.mjs:90-105` (`removeToken`) | تحذف رمزاً واحداً للمستخدم. المسار `DELETE /oauth/personal-access-tokens/:token_id` (`OAuthPersonalAccessTokenRouter.mjs:29-32`). |
| `OAuthPersonalAccessTokenManager.mjs:136-140`, `OAuth2Model.mjs:58-61` | تعيّن `lastUsedAt` بعد فحص ناجح. |

#### من يقرأ منها

| الشيفرة | ما تفعله |
| - | - |
| `OAuthPersonalAccessTokenManager.mjs:107-144` (`verifyToken`) | تفحص الرمز عبر تجزئته لصالح `GET /oauth/token/info` (`OAuthPersonalAccessTokenRouter.mjs:11-15`)، الذي يستدعيه git-bridge عند git clone وpush (`services/git-bridge/src/main/java/uk/ac/ic/wlgitbridge/server/Oauth2Filter.java:285`). ترفض الرمز المنتهي ورمز المستخدم الموقوف أو المحذوف. |
| `OAuth2Model.mjs:31-82` (`getAccessToken`) | تفحص رمز bearer لصالح `AuthenticationController.requireOauth('git_bridge')` (`services/web/app/src/Features/Authentication/AuthenticationController.mjs:409-450`): مسارات API الخاصة بـ git-bridge (`services/web/modules/git-bridge/app/src/GitBridgeRouter.mjs:33-59`) ونقطة نهاية MCP (`services/web/modules/mcp-server/app/src/McpRouter.mjs:16-22`). ترفض الرمز المنتهي ورمز المستخدم الموقوف أو المحذوف. |
| `OAuthPersonalAccessTokenManager.mjs:13-50` (`listTokens`, `getUserTokenNums`) | تسرد رموز المستخدم لصفحة الإعدادات (`GET /oauth/personal-access-tokens`) وتعدّها للحد الأقصى. |
| `AdminUserListManager.mjs:388-400` (module `admin-tools`) | تعرض بادئات رموز المستخدم في لوحة الإدارة. |

#### الفهارس

| الاسم | المفاتيح | الخيارات | الترحيل |
| - | - | - | - |
| `refreshToken_1` | `{ refreshToken: 1 }` | فريد، جزئي: `refreshToken` موجود | `20230405190240_oauth_refresh_tokens_index.mjs` |
| `expiresAt_1` | `{ expiresAt: 1 }` | TTL، `expireAfterSeconds: 0`، جزئي: `expiresAt` موجود | `20230406125632_oauth_tokens_ttl.mjs` |
| `user_id_1_type_1` | `{ user_id: 1, type: 1 }` | | `20250321160345_add_type_to_pat_user_id_index.mjs` (يحل محل `user_id_1` من `20250115110745_oauth_user_id_index_no_partial.mjs`، الذي حل محل `pat_user_id_1` من `20230426095212_personal_oauth_tokens_user_index.mjs`) |
| `accessTokenExpiresAt_1` | `{ accessTokenExpiresAt: 1 }` | TTL، `expireAfterSeconds: 86400`، جزئي: `accessTokenExpiresAt` موجود | `20260511104500_expire_oauthAccessTokens.mjs` |

الترحيلات موجودة في `tools/migrations/`. يأتي الفهرس الفريد `accessToken_1` فقط من ترحيلات موسومة بـ `saas` و`server-pro`، لذا لا يوجد في Community Edition أي فهرس على `accessToken`.

#### ملاحظات

* حذف المستخدم لا يحذف رموزه. يطلق `UserDeleter` الخطاف `cleanupPersonalAccessTokens` (`services/web/app/src/Features/User/UserDeleter.mjs:230-234`)، لكن لا توجد وحدة تستمع إليه. يرفض فحصا الرمز كلاهما هذه الرموز لأن المستخدم لم يعد موجوداً، ويزيلها فهرس TTL بعد يوم من `accessTokenExpiresAt`.
* إيقاف المستخدم يُنهي جلساته فقط. تبقى الرموز، ويرفضها فحصا الرمز كلاهما ما دامت قيمة `users.suspended` هي `true` (`OAuth2Model.mjs:51-54`, `OAuthPersonalAccessTokenManager.mjs:129-134`).


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