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

- تحقق أولاً من أهلية المؤسسة: المستودعات العامة التابعة لمؤسسات أو المستودعات الخاصة والداخلية ذات GitHub Code Security أو Advanced Security.
- راجع سياسة المؤسسة العليا وصلاحيات مالك المؤسسة أو مدير الأمن؛ إعداد المؤسسة المعطّل يمنع المستودعات من التفعيل.
- استخدم GET لقراءة الحالة الحالية على مسار /orgs/{org}/code-scanning/ai-scan أو /repos/{owner}/{repo}/code-scanning/ai-scan.
- نفذ PATCH وفق مخطط REST الرسمي واضبط repository_scan إلى enabled على نطاق تجريبي واحد فقط، مع الحفاظ على قيمة pr_scan إذا كانت مطلوبة.
- أعد GET للتحقق من الإعداد؛ ثم شغّل فحصاً يدوياً بصلاحية الكتابة عندما تكون الميزانية والسياسات جاهزة، وراقب الرصيد والنتائج.
كيف تتأكد من نجاح التطبيق؟
احتفظ بسجل قبل وبعد التغيير يوضح اسم المشروع والإعداد المعتمد وصاحب الموافقة ونتيجة الاختبار. نفّذ اختباراً وظيفياً مماثلاً لما يجري في العمل اليومي، ثم افحص الصلاحيات وظهور الأخطاء والفواتير عند الاقتضاء. لا تعتمد على رسالة نجاح واحدة؛ فبعض الإعدادات تصبح فعالة تدريجياً أو تتأثر بسياسة أعلى مستوى. أعد الاختبار من حساب مستخدم عادي، لا من حساب المدير وحده.
ماذا تفعل عند ظهور مشكلة؟
أوقف التوسع في النشر، وسجّل نص الخطأ والوقت وإصدار العميل دون تسجيل أي أسرار. قارن النتيجة بالوثائق الرسمية ثم أعد الإعداد السابق إذا كانت هناك آلية تراجع موثقة. لا تستخدم تجاوزات أمنية مؤقتة في بيئة الإنتاج لمجرد إنجاح التجربة.
القيود والتوافق والتكلفة
إرجاع HTTP 422 قد يعني تعارض سياسة المؤسسة أو إعدادات غير مسموحة، وعند رفض تعديل مزدوج لا يتغير أي من الإعدادين. GitHub Enterprise Server غير مدعوم بهذه الإمكانية حالياً. ميّز دائماً بين تفعيل الميزة واستخدامها فعلياً؛ فالتحكم الإداري والتشغيل والفوترة قد تكون عمليات منفصلة. تحقق من المنطقة والحساب ونوع الترخيص قبل كتابة سياسة عامة للشركة، وتجنب تعميم نتائج اختبار واحد على كل فرق العمل.
خلاصة عملية
الخطوة الأهم هي التعامل مع الإعلان بوصفه تغييراً قابلاً للقياس، وليس مجرد ميزة جديدة. عيّن مالكاً للتنفيذ، واختبر على نطاق ضيق، وسجّل التوافق والقيود، ثم انقل الإعداد إلى المشاريع الأخرى تدريجياً. ويمكن لفرق التطوير الاستعانة بصفحة Brightery للتعرف على خدمات تطوير البرمجيات، دون أن يغني ذلك عن مراجعة الوثائق الرسمية للمزوّد.
0 Responses
Share your perspective and continue the conversation.
No responses yet
Be the first to share your thoughts.
Join the conversation