اپنے ذاتی Azure Static Web Apps اکاؤنٹ میں ایک جامد سائٹ تعینات کریں

اسے منسلک کرنے سے آپ کو کیا فائدہ حاصل ہوتا ہے

اپنے Azure Static Web Apps اکاؤنٹ کو منسلک کرنے سے آپ اپنے Zinn® ڈیش بورڈ سے اپنے Azure Static Web Apps اکاؤنٹ پر ایک اسٹیٹک سائٹ شائع کر سکتے ہیں۔ پروجیکٹ اور بلنگ کے مالک آپ ہی رہتے ہیں؛ ہم ڈیپلائمنٹ، کسٹم ڈومین اور DNS ریکارڈز کا انتظام سنبھالتے ہیں۔

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

ایک Azure سبسکرپشن، سائٹس کے لیے ایک ریسورس گروپ، اور ایک منسلک شدہ GitHub، GitLab یا Bitbucket اکاؤنٹ جس میں کوڈ موجود ہو — Azure Static Web Apps کسی ریپوزیٹری سے تعمیر کرتا ہے۔ Azure کا مفت پلان تجارتی استعمال اور فی ایپ دو کسٹم ڈومینز کی اجازت دیتا ہے۔

1. Azure Static Web Apps پر کلید (key) بنائیں

Azure اسے service principal کہتا ہے۔ Microsoft Entra کے ایڈمن سینٹر میں Entra ID ← App registrations ← New registration کھولیں، اسے ایک نام دیں اور اسے Register کریں۔ ایپ کے اوور ویو پیج پر Application (client) ID اور Directory (tenant) ID کو کاپی کریں۔ پھر Certificates & secrets ← Client secrets ← New client secret کھولیں، ایک مدت منتخب کریں اور اسے Add کریں — سیکرٹ کی ویلیو فوری طور پر کاپی کر لیں، Azure اسے صرف ایک بار دکھاتا ہے۔

Azure پورٹل میں، وہ ریسورس گروپ کھولیں جسے آپ چاہتے ہیں کہ ہم استعمال کریں، پھر Access control (IAM) ← Add ← Add role assignment پر جائیں۔ Contributor کا کردار منتخب کریں، اسے User, group, or service principal کو تفویض کریں، ایپ کو نام سے تلاش کریں، اور Review + assign کریں۔ ریسورس گروپ کا نام اور وہ Subscription ID نوٹ کر لیں جس سے اس کا تعلق ہے (پورٹل میں Subscriptions تلاش کریں)۔

2. اسے یہاں منسلک کریں

اپنے ڈیش بورڈ میں Integrations کھولیں اور Connect an account منتخب کریں۔ گروپ کے طور پر Static hosting (Netlify, Vercel) اور اکاؤنٹ کے طور پر Azure Static Web Apps منتخب کریں، Client ID، Client secret، Tenant ID، Subscription ID اور Resource group درج کریں، اور Connect account پر کلک کریں۔

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

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

• جب آپ کوئی اسٹیٹک سائٹ بناتے ہیں یا منتقل کرتے ہیں، تو یہ اکاؤنٹ ڈیپلائی کے ہدف کے طور پر ظاہر ہوتا ہے۔

Azure Static Web Apps کسی ریپوزیٹری سے تعمیر کرتا ہے — اس میں اپ لوڈ کی گئی تعمیر کو قبول کرنے کا کوئی طریقہ نہیں ہے — لہٰذا سائٹ کا کوڈ کسی منسلک شدہ GitHub، GitLab یا Bitbucket ریپوزیٹری سے آنا چاہیے۔ اگر آپ نے اب تک منسلک نہیں کیا ہے تو پہلے اسے منسلک کریں۔

• ہم آپ کے اکاؤنٹ پر سروس بناتے ہیں، اسے ریپوزیٹری کی طرف ری ڈائریکٹ کرتے ہیں، آپ کا کسٹم ڈومین منسلک کرتے ہیں اور ڈیپلائمنٹ شروع کرتے ہیں۔ ڈومین کا صفحہ وہ تمام DNS ریکارڈز دکھاتا ہے جن کی Azure Static Web Apps کو ضرورت ہوتی ہے۔
• استعمال اور بلنگ آپ کے اکاؤنٹ پر ہوتی ہے، جو آپ کے اپنے وینڈر ڈیش بورڈ میں دکھائی دیتی ہے۔
• ایک ایپیکس ڈومین کی تصدیق TXT ریکارڈ سے اور سب ڈومین کی تصدیق اس کے CNAME سے ہوتی ہے؛ ڈومین کا صفحہ دکھاتا ہے کہ آپ کے ڈومین کو کس چیز کی ضرورت ہے۔

اگر یہ منسلک نہ ہو

Azure نے service principal کو مسترد کر دیا۔ یا تو کلائنٹ سیکرٹ کی میعاد ختم ہو چکی ہے — آپ کی منتخب کردہ مدت کے مطابق ان کی میعاد ہمیشہ ختم ہو جاتی ہے — یا پھر ایپ کے پاس اب ریسورس گروپ پر Contributor کے اختیارات موجود نہیں ہیں۔ دونوں پیغامات ایک جیسے دکھائی دیتے ہیں، اس لیے نیا سیکرٹ بنانے سے پہلے رول اسائنمنٹ کی جانچ کر لیں۔

کچھ نہیں ملا۔ چیک کریں کہ Subscription ID اور Resource group وہی ہیں جن پر آپ نے کردار تفویض کیا تھا، اور یہ کہ Tenant ID وہی ڈائریکٹری ہے جس میں ایپ رجسٹرڈ ہے۔

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

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

منقطع کرنا

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

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