صلاحيات Git ونطاقاته
آخر تحديث
نطاقات OAuth وصلاحيات الرموز التي يطلبها AI CodeOps على GitHub و GitLab و Bitbucket و Gitea و Forgejo، وفيم يستخدم كل منها، وكيف تلغي الوصول.
يصل AI CodeOps إلى مستودعاتك عبر اتصال Git تنشئه في Configure → Settings → Git Providers. تسرد هذه الصفحة بدقة ما يطلبه كل اتصال، وما يفعله AI CodeOps به، وكيف تسحب الوصول.
ما يفعله AI CodeOps بالاتصال
برمزك، يقوم AI CodeOps بما يلي:
- يقرأ ملفك الشخصي، لإظهار الحساب المربوط ولفحص الرمز حين تربطه؛
- يسرد المستودعات التي تستطيع الوصول إليها ويبحث فيها، مع فروعها وملفاتها وإيداعاتها وطلبات السحب فيها (Develop → Repositories)؛
- يستنسخ مستودع المشروع لتستطيع الجلسة العمل عليه؛
- يدفع فرعا اسمه
codeops/run-<id>ويفتح طلب سحب إلى الفرع الافتراضي للمشروع؛ - يدمج طلب السحب حين تدمجه أنت من لوحة التحكم.
ولا ينشئ مستودعات ولا يعلق على طلبات السحب، ولا تسجل الجلسات أي webhook ولا تنشر حالات الإيداع. والاستثناء هو المستودع الذي تربطه من Build & Test → Builds، فهو يحصل على webhook، ليبدأ الدفع أو طلب السحب عملية بناء، وعلى حالة إيداع بنتيجة كل عملية بناء.
نطاقات OAuth لكل خدمة
اختر Connect (أو Connect via OAuth على GitLab) في بطاقة الخدمة للربط عبر OAuth.
| الخدمة | النطاقات المطلوبة | الغرض منها |
|---|---|---|
| GitHub | repo, read:user, user:email | النطاق repo: قراءة مستودعاتك والكتابة فيها، ومنها الخاصة، للاستنساخ ودفع الفروع وفتح طلبات السحب ودمجها. والنطاق read:user: إظهار الحساب المربوط. أما user:email فيطلب لكن الاتصال لا يستخدمه. |
| GitLab | api, read_user | النطاق api: قراءة المستودعات ودفع الفروع وفتح طلبات الدمج ودمجها. والنطاق read_user: إظهار الحساب المربوط. |
| Bitbucket | يحددها تطبيق OAuth الخاص بالمنصة | يسردها Bitbucket في شاشة الموافقة لديه. وتستخدم للعمليات نفسها المذكورة أعلاه. |
| Gitea, Forgejo | لا شيء في الطلب | يسري الإعداد الافتراضي للخادم الخاص بتطبيق OAuth. |
يستخدم GitHub تطبيق OAuth (OAuth app)، لا GitHub App. ولا يعمل OAuth مع GitLab و Gitea و Forgejo إلا على الخادم المسجل عليه تطبيق OAuth الخاص بالمنصة (وهو GitLab.com في حالة GitLab). ولأي خادم آخر، اربط برمز: فالبطاقة لا تعرض OAuth إلا حيث يستطيع العمل.
رموز الوصول الشخصية
في بطاقة كل خدمة حقل للرمز: or access token (أو or access token (no OAuth app) على GitHub و Bitbucket). الصق رمزا واختر Connect with token (ربط برمز).
ولخدمة GitLab على خادمك الخاص، ولخدمتي Gitea و Forgejo، أدخل أيضا عنوان الخادم في Instance URL. ويجب أن يكون عنوان https العام للخادم. وترفض عناوين الشبكات الخاصة و localhost ما لم يسمح مشغل المنصة بذلك الخادم.
يحتاج الرمز إلى قراءة ملفك الشخصي، وقراءة المستودعات، ودفع الفروع، وإنشاء طلبات السحب ودمجها:
| الخدمة | صلاحيات الرمز |
|---|---|
| GitHub | رمز classic بالنطاق repo، أو رمز fine-grained مع ضبط Contents و Pull requests على القراءة والكتابة. |
| GitLab | رمز وصول شخصي أو رمز مشروع أو رمز مجموعة بالنطاق api. ورموز المشروع والمجموعة تحتاج إلى الدور Developer أو أعلى. |
| Gitea, Forgejo | صلاحية القراءة والكتابة على repository، وصلاحية القراءة على user. |
| Bitbucket | يرسل في صورة Bearer token. والرموز التي تحتاج إلى اسم مستخدم معها لن تعمل؛ فاربط عبر OAuth بدلا من ذلك. |
حين تربط، يفحص AI CodeOps الرمز بقراءة ملفك الشخصي. وإذا فشل ذلك، تذكر الرسالة السبب: لم تتعرف الخدمة على الرمز، أو لا يسمح للرمز بقراءة حسابك، أو لم تجب أي واجهة API على العنوان. ولا يفحص نطاقات الرمز الأخرى عندئذ، فالرمز الأضيق من اللازم يتصل، ثم يفشل حين تحاول جلسة الدفع أو فتح طلب سحب. وزر Verify access (التحقق من الوصول) في المشروع يفحص ذلك لمستودع واحد.
الرموز لا تجدد. حين تنتهي صلاحية رمز على خدمتك، افصل الاتصال واربط من جديد برمز جديد. أدلة الخدمات: GitHub و GitLab و Bitbucket و Gitea و Forgejo.
اتصال من يستخدم
الاتصال يخص الشخص الذي أنشأه، لا مساحة العمل. وتبقى أدوار مساحة العمل هي التي تقرر ما يستطيع كل شخص فعله به. وحين تجري الموافقة على تغيير، يفتح طلب السحب الخاص به باتصال من وافق لتلك الخدمة. وحين تدمج من لوحة التحكم، يستخدم اتصالك أنت.
يمكن أن يكون لك اتصال واحد لكل نوع خدمة. وللانتقال إلى حساب أو خادم آخر، افصل الاتصال أولا.
كيف تخزن الرموز
تشفر الرموز وهي مخزنة بخوارزمية AES-256-GCM. وتمرر إلى Git في ترويسة الطلب، ولا تكتب أبدا في عنوان المستودع ولا في إعدادات Git الخاصة به.
إلغاء الوصول
- افتح Configure → Settings وانزل إلى Git Providers.
- اختر Disconnect (فصل) بجانب الحساب، ثم Disconnect account للتأكيد.
- على خدمة استضافة Git لديك، ألغ الرمز، أو ألغ تطبيق AI CodeOps من تطبيقاتك المأذون لها.
الخطوة 3 مهمة: يزيل Disconnect الاتصال من AI CodeOps لكنه لا يلغي الرمز على خدمتك.
الخطوات التالية
الأسئلة الشائعة
هل يلغي فصل الاتصال الرمز على خدمة استضافة Git لدي؟
لا. يزيل Disconnect الاتصال من AI CodeOps. ولإلغاء الرمز نفسه، ألغه أو ألغ التطبيق من إعدادات خدمة استضافة Git لديك.
هل يضيف AI CodeOps أي webhook إلى مستودعاتي؟
ليس للجلسات. المستودع الذي تربطه من Build & Test → Builds يحصل على webhook، ليبدأ الدفع أو طلب السحب عملية بناء، وعلى حالة إيداع بنتيجة كل عملية بناء. ولا يعلق AI CodeOps على طلبات السحب.
هل تسجيل الدخول عبر GitHub هو نفسه ربط GitHub؟
لا. تسجيل الدخول يقرأ ملفك الشخصي وبريدك الإلكتروني الموثق فقط. أما الوصول إلى المستودعات فيأتي من اتصال Git المنفصل في Settings.