تطوير ويب

إدارة فحص GitHub AI Scan عبر REST API: تفعيل المستودعات والتحقق من السياسات دون مفاجآت

Editorial Team

November 16, 2026

إدارة فحص GitHub AI Scan عبر REST API: تفعيل المستودعات والتحقق من السياسات دون مفاجآت — دليل تطبيقي يستند إلى التحديثات الرسمية ويشرح أثرها على فرق التطوير وإدارة الأنظمة.

ما الذي تغيّر ولماذا يهم فرق التطوير؟

أعلنت GitHub في 13 نوفمبر 2026 إتاحة إدارة إعداد فحص المستودعات بالذكاء الاصطناعي عبر REST API في معاينة عامة. كان ضبط الإعدادات يستهلك وقتًا عند وجود عشرات المستودعات؛ أما الآن فيمكن لفريق الأمان قراءة الحالة وتغييرها آليًا ضمن سياسة المؤسسة. الإضافة الأساسية هي الخاصية repository_scan، إلى جانب pr_scan المخصص لطلبات الدمج. لا تعني هذه الإضافة أن الفحص يبدأ تلقائيًا، ولا أنها بديل عن اختبارات الوحدات أو CodeQL التقليدي. الهدف الأول هو جعل ضبط السياسة قابلاً للتكرار والتدقيق.

المتطلبات وحدود التوافق

ابدأ بتحديد ما إذا كانت مؤسستك تسمح أصلًا بخدمة AI Scan. يستطيع مالك المؤسسة أو مدير الأمان ضبط مستوى المؤسسة، بينما يمكن لمسؤول المستودع تعطيل الإعداد الموروث على مستوى مستودعه. يتاح فحص المستودعات العامة التابعة للمؤسسات، وللمستودعات الخاصة أو الداخلية وفق اشتراك GitHub Code Security أو GitHub Advanced Security. لا تدعم الميزة GitHub Enterprise Server بحسب الإعلان. تحقق من صلاحيات الرمز وفق صفحة REST الرسمية، ولا تضع الرمز في الشيفرة أو سجلات الطرفية أو المقالات. اختبر على مستودع غير حساس قبل تعميم السياسة.

تصور بصري أصلي لموضوع إدارة GitHub AI Scan عبر API باستخدام طبقات هندسية وإضاءة هادئة، دون كلمات أو شعارات.

قراءة الحالة قبل التعديل

ابدأ بطلب GET /orgs/{org}/code-scanning/ai-scan لمعرفة القيم المخزنة على مستوى المؤسسة، ثم استخدم GET /repos/{owner}/{repo}/code-scanning/ai-scan للمستودع المستهدف. سجل النتائج في تقرير داخلي يذكر اسم المستودع والقيمة الحالية والقرار المقترح ومالك الموافقة. إذا كان لديك نظام Infrastructure as Code، اجعل هذه القراءة جزءًا من مرحلة المعاينة بدل القفز مباشرة إلى التغيير. راجع الفرق بين السياسة الموروثة والإعداد الفردي حتى لا تفترض أن كل المستودعات ستتصرف بالطريقة نفسها.

تغيير الإعداد بطريقة قابلة للتراجع

تستخدم واجهة GitHub طلب PATCH على المسارين نفسيهما، مع جسم JSON مثل {"repository_scan":"enabled"}. ويمكن إرسال pr_scan وrepository_scan معًا. في حالة حظر أي تغيير، قد يرجع الخادم 422 ولا يطبّق أيًا من التغييرين؛ لذا تعامل مع الطلب بوصفه عملية تحتاج فحص الاستجابة، لا مجرد إرسال ناجح. لا تنفذ التغيير على كل المستودعات دفعة واحدة: اختر مجموعة تجريبية، واحتفظ بقيم الإعدادات السابقة، ثم وسع النطاق بعد موافقة فريق الأمان. إذا ظهرت استجابة 403 فراجع الصلاحيات بدل تكرار الطلب دون تشخيص.

التحقق والتكلفة والمشكلات المتوقعة

بعد طلب التعديل، أعد تنفيذ GET وتأكد أن القيمة الفعلية توافق السياسة المطلوبة. افصل بين نجاح ضبط الإعداد ونجاح عملية الفحص نفسها: تفعيل AI Scan للمستودعات لا يبدأ فحصًا تلقائيًا، ويظل تشغيل الفحص عند الطلب متاحًا لمن لديه صلاحية كتابة، كما تستهلك عمليات الفحص أرصدة GitHub Code Security AI. ضع حدًا تشغيليًا للتكلفة وراجع نتائج التنبيهات ومعدل الإيجابيات الكاذبة قبل التوسع. عند استجابة 422 افحص سياسة المؤسسة العليا، وعند عدم ظهور نتائج تأكد أولًا أن فحصًا قد بدأ بالفعل وأن المستودع مؤهل.

خلاصة عملية

أفضل استخدام لهذا التحديث هو إدارة سياسة أمنية موحدة قابلة للتدقيق، لا إطلاق فحوص واسعة دون تقدير التكلفة. ابدأ بالقراءة، ثم المعاينة، ثم تعديل محدود، ثم تحقق مستقل، واحتفظ بخطة تراجع. اربط نتائج الفحص بمراجعة بشرية قبل اتخاذ قرارات حظر الدمج أو تعديل الشيفرة الإنتاجية.

المصادر والمراجع

View 0 Comments & Join Discussion