اپنے GitHub اکاؤنٹ کو ٹوکن کے ساتھ مربوط کریں تاکہ آپ کی سائٹس کسی ذخیرے سے تعینات کی جا سکیں

اسے مربوط کرنے سے آپ کو کیا فائدہ ہوتا ہے

GitHub کو ٹوکن کے ساتھ مربوط کرنے سے کسی سائٹ کو آپ کی ریپوزٹریز میں سے ایک سے تعینات کرنے کی اجازت ملتی ہے: برانچ میں پش کریں اور سائٹ اپ ڈیٹ ہو جاتی ہے۔ یہ ہمیں آپ کے اکاؤنٹ پر GitHub Pages پر شائع کرنے کی بھی اجازت دیتا ہے جہاں آپ اسے سائٹ کے میزبان کے طور پر منتخب کرتے ہیں۔

اگر آپ کی ریپوزٹریز کسی تنظیم کی ملکیت ہیں، تو اس کے بجائے Zinn® GitHub ایپ کو ترجیح دیں — دیکھیں Zinn® GitHub ایپ انسٹال کریں۔ ایک ٹوکن ایک فرد سے تعلق رکھتا ہے اور ان کے چلے جانے پر کام کرنا بند کر دیتا ہے۔

شروع کرنے سے پہلے

ایک ایسا GitHub اکاؤنٹ جس کی ان ریپوزٹریز تک رسائی ہو جنہیں آپ تعینات کرنا چاہتے ہیں۔ اگر وہ کسی تنظیم کی ملکیت ہیں، تو ممکن ہے کسی مالک کو اس کے لیے fine-grained ٹوکنز کی منظوری دینی پڑے۔

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 token درج کریں، اور Connect account دبائیں۔

کچھ بھی محفوظ ہونے سے پہلے ہم آپ کے چسپاں کردہ مواد کی جانچ کرتے ہیں۔ جو کلید کام نہیں کرتی اسے کبھی محفوظ نہیں کیا جاتا، اور جواب بتاتا ہے کہ اس میں کیا خرابی تھی۔ جو کلید کام کرتی ہے اسے ہمارے سیکریٹس والٹ میں انکرپٹ کر کے رکھا جاتا ہے — کبھی بھی ہمارے ڈیٹا بیس میں نہیں — اور اسے دوبارہ کبھی نہیں دکھایا جاتا، خود آپ کو بھی نہیں۔

آگے کیا ہوتا ہے

• ایک سائٹ اس اکاؤنٹ پر موجود ریپوزٹری سے براہ راست تعینات ہو سکتی ہے: اسے سائٹ کے ریپوزٹری کنکشن پر منتخب کریں، ریپوزٹری اور برانچ منتخب کریں، اور پش کرنے پر تعیناتی ہو جاتی ہے۔
• ہر دوسری برانچ اپنا پیش منظر حاصل کر سکتی ہے، تاکہ آپ لائیو سائٹ پر پہنچنے سے پہلے تبدیلی کی جانچ کر سکیں۔
• Git سے بننے والے اسٹیٹک ہوسٹس جیسے کہ Render اور Azure Static Web Apps اس کنکشن کو سائٹ کے کوڈ کے ماخذ کے طور پر استعمال کرتے ہیں۔

اگر یہ مربوط نہ ہو

ایک ریپوزٹری ظاہر نہیں ہوتی۔ ٹوکن کی ریپوزٹری رسائی میں یہ شامل نہیں ہے۔ GitHub پر ٹوکن میں ترمیم کریں اور ریپوزٹری شامل کریں۔

اس نے کام کیا اور پھر بند ہو گیا۔ Fine-grained ٹوکنز آپ کی منتخب کردہ تاریخ پر ختم ہو جاتے ہیں۔ ایک نیا تیار کریں اور اسے مربوط کریں؛ ٹوکن کی میعاد ختم ہونے سے پہلے GitHub آپ کو ای میل بھیجتا ہے۔

یہ کہتا ہے کہ کلید مسترد کر دی گئی۔ تقریباً ہمیشہ تین چیزوں میں سے ایک: اس کے ساتھ کاپی ہونے والا اسپیس یا لائن بریک، ایک ایسی کلید جس کی میعاد ختم ہو چکی ہے، یا ایسی کلید جسے آپ کے کاپی کرنے کے بعد منسوخ یا دوبارہ تیار کیا گیا تھا۔ ایک نئی کلید بنائیں اور اسے دوبارہ چسپاں کریں۔

یہ مربوط ہو جاتا ہے، لیکن بعد میں کوئی عمل ناکام ہو جاتا ہے۔ کلید کی توثیق تو ہو جاتی ہے لیکن اس میں اس اجازت کی کمی ہوتی ہے جس کی عمل کو ضرورت ہے۔ اوپر دی گئی اجازتوں کے ساتھ ایک نئی کلید بنائیں، پھر پرانے کنکشن کو منقطع کریں اور نئی کلید کو مربوط کریں۔

رابطہ منقطع کرنا

Integrations کھولیں، اکاؤنٹ تلاش کریں اور Disconnect دبائیں۔ اس سے محفوظ شدہ کلید فوری طور پر حذف ہو جاتی ہے۔ کوئی بھی چیز جو اسے استعمال کر رہی تھی وہ اپنے اگلے عمل پر رک جاتی ہے، اور جو اسکرینیں اس پر منحصر تھیں وہ خاموشی سے ناکام ہونے کے بجائے اس کی وضاحت کرتی ہیں۔

منقطع کرنے سے وہ چیزیں واپس نہیں ہوتیں جو پہلے ہی کی جا چکی ہیں — ریکارڈز، تعیناتیاں یا ترتیبات جو ہم نے آپ کے اکاؤنٹ پر تبدیل کی ہیں وہ ویسی ہی رہتی ہیں۔ اگر آپ کو لگتا ہے کہ خود کلید افشا ہو سکتی ہے، تو وینڈر کے پاس بھی جا کر اسے منسوخ کریں؛ منقطع کرنے سے ہماری کاپی ہٹتی ہے، ان کی نہیں۔