اربط حسابك في GitHub باستخدام رمز لكي يتم نشر مواقعك من مستودع

ما يفعله الاتصال من أجلكم

يتيح ربط GitHub باستخدام رمز مميز إمكانية نشر موقع من أحد مستودعاتكم: أدخلوا التغييرات إلى الفرع وسيتم تحديث الموقع. كما يتيح لنا النشر على GitHub Pages في حسابكم عندما تختارون ذلك كمضيف للموقع.

إذا كانت مستودعاتكم تنتمي إلى مؤسسة، ففضلوا استخدام تطبيق Zinn® GitHub بدلاً من ذلك — راجعوا تثبيت تطبيق Zinn® GitHub. ينتمي الرمز المميز إلى شخص واحد ويتوقف عن العمل عندما يغادر ذلك الشخص.

قبل أن تبدؤوا

حساب GitHub مع إمكانية الوصول إلى المستودعات التي ترغبون في نشرها. إذا كانت تنتمي إلى مؤسسة، فقد يتعين على المالك الموافقة على الرموز المميزة دقيقة الصلاحيات لها.

1. أنشئوا المفتاح على GitHub

على GitHub، انقروا على صورة ملفكم الشخصي، ثم الإعدادات (Settings) ← إعدادات المطور (Developer settings) ← الرموز المميزة للوصول الشخصي (Personal access tokens) ← الرموز المميزة دقيقة الصلاحيات (Fine-grained tokens) ← إنشاء رمز مميز جديد (Generate new token). قوموا بتسميته واختيار تاريخ انتهاء الصلاحية. تحت الوصول إلى المستودع (Repository access)، اختاروا تحديد مستودعات فقط (Only select repositories) واختاروا المستودعات التي تقومون بنشرها — وهي أصغر نطاق وصول ممكن يعمل.

تحت أذونات المستودع (Repository permissions)، امنحوا صلاحية قراءة وكتابة (Read and write) على:

• المحتويات (Contents)
• الصفحات (Pages)
• الإدارة (Administration)

اضغطوا على إنشاء رمز مميز (Generate token) واقسخوه — يعرضه GitHub مرة واحدة.

2. اربطوه هنا

افتحوا التكاملات (Integrations) في لوحة التحكم الخاصة بكم واختاروا ربط حساب (Connect an account). اختاروا استضافة الكود (Code hosting) كمجموعة وGitHub كحساب، واملؤوا حقل رمز API المميز (API token)، ثم اضغطوا على ربط الحساب (Connect account).

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

ماذا يحدث بعد ذلك

• يمكن للموقع النشر مباشرة من مستودع على هذا الحساب: اختاروه في اتصال مستودع الموقع، وحددوا المستودع والفرع، وسيقوم إدخال التغييرات بالنشر.
• يمكن لجميع الفروع الأخرى الحصول على معاينة خاصة بها، مما يتيح لكم التحقق من أي تغيير قبل وصوله إلى الموقع المباشر.
• تستخدم الجهات المضيفة الثابتة المبنية على Git مثل Render وAzure Static Web Apps هذا الاتصال كصدر لكود الموقع.

إذا لم يتم الاتصال

لا يظهر أحد المستودعات. لا يتضمن وصول المستودع الخاص بالرمز المميز ذلك المستودع. قم بتحرير الرمز المميز على GitHub وأضف المستودع.

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

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

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

قطع الاتصال

افتحوا التكاملات (Integrations)، وابحثوا عن الحساب واضغطوا على قطع الاتصال (Disconnect). يؤدي ذلك إلى حذف المفتاح المخزن فوراً. يتوقف أي شيء كان يخدمه عند إجرائه التالي، وتوضح الشاشات التي كانت تعتمد عليه ذلك بدلاً من الفشل بصمت.

لا يؤدي قطع الاتصال إلى التراجع عما تم إنجازه بالفعل — فالجلانات أو عمليات النشر أو الإعدادات التي قمنا بتغييرها على حسابكم تبقى كما هي. إذا كنتم ترجحون أن المفتاح نفسه قد تسرب، فقم بإبطاله أيضاً لدى المورد؛ إزالة الاتصال تزيل نسختنا، وليس نسختهم.