HandyCafe Docs
owner it-admin

OAuth سوشل لاگ ان کیسے سیٹ اپ کریں

یہ گائیڈ سوشل لاگ ان ترتیب دینے کے مراحل سے گزارتی ہے تاکہ صارفین اپنے Google، Facebook، Apple، X، یا Discord اکاؤنٹس سے کلائنٹ PC پر سائن ان کر سکیں۔ HandyCafe Device Authorization Grant فلو (RFC 8628) استعمال کرتا ہے۔ صارفین تصدیق کے لیے اپنے فون سے QR کوڈ اسکین کرتے ہیں۔


Google OAuth کیسے سیٹ اپ کریں

حصہ الف: Google Cloud اسناد بنائیں

  1. اپنے براؤزر میں Google Cloud Console کھولیں: https://console.cloud.google.com
  2. نیا پروجیکٹ بنائیں۔ نام "HandyCafe OAuth" رکھیں۔
  3. APIs & Services > OAuth consent screen پر جائیں۔
  4. صارف قسم External منتخب کریں۔
  5. لازمی خانے بھریں: ایپ نام، سپورٹ ای میل، ڈیولپر رابطہ ای میل۔
  6. Scopes اور Test Users سیکشنز سے Save and Continue کریں۔
  7. APIs & Services > Credentials پر جائیں۔
  8. Create Credentials > OAuth client ID کلک کریں۔
  9. Application type کے لیے TVs and Limited Input devices منتخب کریں۔ یہ اہم ہے۔
  10. کلائنٹ کا نام درج کریں (مثلاً "HandyCafe Device Flow")۔
  11. Create کلک کریں۔
  12. تصدیقی ڈائیلاگ سے Client ID اور Client Secret کاپی کریں۔

حصہ ب: HandyCafe سرور ترتیب دیں

  1. HandyCafe سرور ایپلیکیشن کھولیں۔
  2. سیٹنگز > OAuth ٹیب پر جائیں۔
  3. صفحے کے اوپر OAuth ٹوگل فعال کریں۔
  4. فراہم کنندگان فہرست میں Google قطار تلاش کریں۔
  5. Google ٹوگل فعال کریں۔
  6. مرحلہ 12 سے Client ID پیسٹ کریں۔
  7. Client Secret پیسٹ کریں۔
  8. محفوظ کریں کلک کریں۔

حصہ ج: لاگ ان فلو ٹیسٹ کریں

  1. جڑے ہوئے کلائنٹ PC پر جائیں۔ آئیڈل اسکرین Google لاگ ان بٹن دکھائے۔
  2. Google لاگ ان بٹن کلک کریں۔
  3. کلائنٹ QR کوڈ اور یوزر کوڈ دکھاتا ہے۔
  4. اپنے فون سے QR کوڈ اسکین کریں۔ Google تصدیق صفحہ کھلتا ہے۔
  5. Google اکاؤنٹ سے سائن ان کریں اور ایپلیکیشن کی اجازت دیں۔

متوقع نتیجہ: سرور پر نوٹیفکیشن آواز بجتی ہے اور درخواستوں صفحے پر نیا اندراج ظاہر ہوتا ہے۔


لاگ ان درخواست کیسے منظور کریں

  1. درخواستیں صفحے پر جائیں۔
  2. زیر التوا درخواست فراہم کنندہ نام، ظاہری نام، ای میل، کلائنٹ PC اور ٹائم اسٹیمپ دکھاتی ہے۔
  3. درخواست تفصیلات کا جائزہ لیں۔
  4. درخواست قبول کرنے کے لیے منظور کلک کریں۔

متوقع نتیجہ: نیا رکن اکاؤنٹ خودکار بنتا ہے یا موجودہ رکن سے لنک ہوتا ہے۔ صارف لاگ ان ہوتا ہے اور کلائنٹ PC آن لائن صفحے پر منتقل ہوتا ہے۔


Facebook OAuth کیسے سیٹ اپ کریں

  1. Facebook Developer Portal کھولیں: https://developers.facebook.com
  2. نئی ایپ بنائیں۔ Consumer ایپ قسم منتخب کریں۔
  3. Settings > Basic سے App ID اور App Secret نوٹ کریں۔
  4. HandyCafe سرور میں سیٹنگز > OAuth پر Facebook ٹوگل فعال کریں، Client ID اور Client Secret پیسٹ کریں۔
  5. محفوظ کریں کلک کریں۔

Discord OAuth کیسے سیٹ اپ کریں

  1. Discord Developer Portal کھولیں: https://discord.com/developers/applications
  2. نئی ایپلیکیشن بنائیں۔
  3. OAuth2 سیکشن سے Client ID اور Client Secret کاپی کریں۔
  4. HandyCafe سرور میں Discord ٹوگل فعال کریں، اسناد پیسٹ کریں۔
  5. محفوظ کریں کلک کریں۔

عام غلطیوں سے بچیں

  • Google Cloud Console میں غلط OAuth کلائنٹ قسم استعمال کرنا۔ آپ کو "TVs and Limited Input devices" منتخب کرنا ضروری ہے۔
  • عالمی OAuth ٹوگل فعال نہ کرنا۔ انفرادی فراہم کنندگان فعال کرنا کافی نہیں۔ ماسٹر OAuth ٹوگل بھی آن ہونا ضروری ہے۔
  • لاگ ان درخواستیں منظور نہ کرنا۔ OAuth لاگ انز کو سرور سے واضح منظوری درکار ہے۔
  • اسناد میں اضافی خالی جگہ۔ Client ID یا Client Secret کاپی کرتے وقت شروع یا آخر میں خالی جگہ نہ ہو یقینی بنائیں۔