أضافت GitHub CLI رموز OAuth منتهية الصلاحية: كيفية التفعيل وفحص التكاملات

قد يتوقف رمز نُسخ مرة واحدة إلى متغير أو برنامج نصي عن العمل بعد انتهاء صلاحيته. في 21 أكتوبر 2026، أعلنت GitHub عن معاينة عامة لبيانات اعتماد OAuth منتهية الصلاحية مع تجديد تلقائي في GitHub CLI. يُفعّل هذا الوضع اختياريًا، وهو مخصص لسير العمل الذي تتولى فيه CLI إدارة المصادقة بنفسها.

كيفية تفعيل بيانات الاعتماد القابلة للتجديد

يلزم استخدام GitHub CLI بالإصدار 2.103.0 أو إصدار أحدث. لإجراء تسجيل دخول منفرد، أضف الخيار --expiring:

gh auth login --expiring

لتفعيل طلب بيانات الاعتماد القابلة للتجديد عند عمليات تسجيل الدخول اللاحقة، نفّذ:

gh config set expiring_credentials enabled

تخزّن CLI رمز وصول منتهي الصلاحية مع رمز تحديث دوّار، وتجدّد بيانات الاعتماد عند الحاجة إليها. ويعرض الأمر gh auth status حالة المصادقة ومدة صلاحية الرمز الحالي. يطلب الخيار بيانات اعتماد قابلة للتجديد، لكن إصدارها يعتمد على إمكانات المضيف وإعداد تطبيق OAuth. إذا لم يكن الخادم يدعمها، تستخدم CLI رمزًا عاديًا غير منتهي الصلاحية.

اضبط Git ليستخدم بيانات الاعتماد

للمستودعات التي تستخدم HTTPS، اضبط GitHub CLI كمساعد لبيانات اعتماد Git:

gh auth setup-git

عندئذٍ يطلب Git بيانات الاعتماد من gh، التي تستطيع تجديدها قبل استخدامها. توصي GitHub باستخدام Git بالإصدار 2.46 أو إصدار أحدث؛ إذ يتيح هذا الإصدار لـCLI وضع علامة على بيانات الاعتماد المنتهية الصلاحية، كي لا يخزّنها Git مؤقتًا بعد انتهاء صلاحيتها. تعمل GitHub CLI مع الإصدارات الأقدم من Git أيضًا، لكنها تطلب التحديث مرة واحدة.

بعد الإعداد، اختبر عملية Git اعتيادية عبر HTTPS، مثل قراءة حالة المستودع البعيد. تأكد من أن Git يحصل على بيانات الاعتماد عبر المساعد؛ فهذا يختبر مسار المصادقة كاملًا، لا تسجيل الدخول إلى CLI وحده.

افحص البرامج النصية والتطبيقات الخارجية

تكمن نقطة الضعف في برنامج نصي أو إضافة تشغّل gh auth token مرة واحدة، ثم تحفظ السلسلة وتعيد استخدامها لاحقًا؛ فقد تنتهي صلاحية رمز الوصول هذا. إذا كانت عملية خارجية تحتاج إلى رمز، فاطلب رمزًا جديدًا عند كل تشغيل باستخدام gh auth token. ويجب أن يتمكن التطبيق المستهلك من استخدام القيمة المحدّثة ومراعاة انتهاء صلاحية الرمز.

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

أين تتوفر الميزة

أعلنت GitHub دعم الميزة على github.com وghe.com. ويصدر GitHub Enterprise Server بيانات الاعتماد هذه بدءًا من الإصدار 3.23؛ أما الإصدارات الأقدم، فتحوّل طلب البيانات القابلة للتجديد إلى رمز عادي غير منتهي الصلاحية. لا يزال تفعيل الوضع اختياريًا؛ وتخطط GitHub لجعله الإعداد الافتراضي لعمليات تسجيل الدخول الجديدة بمرور الوقت.

الترتيب العملي هو تحديث GitHub CLI، وتفعيل طلب بيانات الاعتماد القابلة للتجديد، وضبط Git باستخدام gh auth setup-git، ثم فحص العمليات الخارجية بحثًا عن أي تخزين للرمز. ويساعد ذلك على اكتشاف حالات عدم التوافق قبل الانتقال.

نشرت GitHub التفاصيل في إعلان المعاينة وفي توثيق الأمر gh auth login.