تسجيل الدخول الموحّد باستخدام Google
يتطلب رصيدًا أنفاق HTTP
في هذه الصفحة 4 أقسام
دع الزوار يسجّلون الدخول بحساب Google الخاص بهم قبل أن يتمكنوا من فتح نفق HTTP. تنشئ عميل OAuth في Google Cloud، وتضيفه إلى Localtonet بوصفه مزوّدًا، ثم تفعّله للنفق.
قبل أن تبدأ #
- نفق HTTP ورصيد في حسابك. راجع نظرة عامة على تسجيل الدخول الموحّد.
- حساب Google يمكنه الوصول إلى وحدة تحكم Google Cloud ومشروع فيها.
الخطوات #
-
أنشئ عميل OAuth في Google Cloud #
تغيّر Google وحدة التحكم الخاصة بها من حين لآخر. ودليلها الرسمي هو Manage OAuth Clients. باختصار:
- في وحدة تحكم Google Cloud افتح Google Auth Platform لمشروعك. وإذا كان المشروع جديدًا، تطلب منك وحدة التحكم إعداد التطبيق أولًا: اسم التطبيق وبريد الدعم والجمهور ومعلومات الاتصال.
- ضمن Audience اختر من يُسمح له بتسجيل الدخول. راجع الجدول أدناه.
- افتح Clients واختر Create client.
- اضبط Application type على Web application وأعطِ العميل اسمًا.
- ضمن Authorized redirect URIs أضف عنوان إعادة التوجيه أدناه. يمكن ترك Authorized JavaScript origins فارغًا.
- اختر Create، ثم انسخ Client ID وClient secret. تعرض Google السر كاملًا في هذه المرحلة فقط.
Authorized redirect URIhttp://auth.localtonet.com/auth/callbackالجمهور (Audience) في Google من يمكنه تسجيل الدخول Internal أعضاء مؤسسة Google Cloud الخاصة بك فقط. External، حالة النشر Testing مستخدمو الاختبار الذين تدرجهم في Google، حتى 100. وتستثني Google التطبيقات التي تطلب الاسم وعنوان البريد الإلكتروني والملف الشخصي للمستخدم فقط: لا يحتاج المستخدمون فيها إلى أن يكونوا في القائمة. لا تعتمد على قائمة مستخدمي الاختبار لإبعاد الناس؛ واستخدم قواعد الوصول في Localtonet. External، حالة النشر In production أي شخص لديه حساب Google. استخدم قواعد الوصول في Localtonet لتضييق ذلك. يطلب تسجيل الدخول النطاقات
openidوemailوprofile. وإذا طلبت منك Google اختيار نطاقات للتطبيق، فهذه الثلاثة تكفي.تذكر Google أن تغيير العميل قد يستغرق من 5 دقائق إلى بضع ساعات ليسري.
-
أضف المزوّد في Localtonet #
افتح أنفاقي › HTTP واختر SSO أعلى الصفحة. في مربع حوار مزوّدو SSO اختر إضافة مزوّد.
الحقل القيمة اسم المزوّد أي اسم، مثل Company Google. يظهر لك في إعدادات النفق.نوع المزوّد Google. يؤدي تغيير نوع مزوّد محفوظ إلى تفريغ معرّف العميل (Client ID)، لذا أدخل معرّف العميل وسر العميل مرة أخرى. نشط مفعّل معرّف العميل (Client ID) معرّف العميل من Google. سر العميل (Client Secret) سر العميل من Google. لا يُعرض أبدًا بعد الحفظ. ضمن نقاط النهاية ورابط الاستدعاء تُملأ عناوين Google القياسية تلقائيًا. اتركها كما هي:
الحقل القيمة المملوءة نقطة نهاية التفويض https://accounts.google.com/o/oauth2/v2/authنقطة نهاية التوكن (Token) https://oauth2.googleapis.com/tokenنقطة نهاية معلومات المستخدم https://openidconnect.googleapis.com/v1/userinfoمسار الاستدعاء (Callback) /auth/callback/googleيمكنك اختياريًا ملء قواعد الوصول عبر البريد الإلكتروني. لقبول شركتك فقط، أدخل نطاقها، مثل
example.com، ضمن نطاقات البريد الإلكتروني المسموح بها. ثم اختر حفظ المزوّد. -
فعّله لنفق #
ضمن أنفاقك اختر الإعدادات للنفق، ثم إدارة بجانب مزوّدو SSO. في مربع حوار تسجيل الدخول الموحّد فعّل اشتراط تسجيل الدخول ومفتاح مزوّد Google لديك. ثم اختر حفظ.
القوائم ضمن من يمكنه تسجيل الدخول ومسارات تسجيل الدخول اختيارية. وهي مشروحة في النظرة العامة.
-
اختبره #
افتح رابط النفق في نافذة متصفح خاصة. تعرض Localtonet Sign in to continue مع زر لمزوّدك. وبعد تسجيل الدخول في Google تُعاد إلى النفق وتُحمَّل خدمتك.
استكشاف الأخطاء وإصلاحها #
تبلّغ Google عن redirect_uri_mismatch
عنوان إعادة التوجيه في الطلب ليس أحد Authorized redirect URIs للعميل. أضف http://auth.localtonet.com/auth/callback بالضبط إلى العميل في Google وانتظر بعض الوقت ليسري التغيير.
لا تقبل وحدة تحكم Google عنوان إعادة التوجيه
تتحقق Google من عناوين إعادة التوجيه وفق قواعد التحقق الخاصة بها. تذكر الرسالة المجاورة للحقل القاعدة التي لم تتحقق.
ترفض Google الحساب، مثلًا بالخطأ org_internal
رفضت Google الحساب قبل أن تراه Localtonet. مع الجمهور Internal لا يستطيع تسجيل الدخول إلا أعضاء مؤسستك، وتبلّغ Google عن org_internal لكل من سواهم. ومع External في حالة Testing، تحقّق من قائمة مستخدمي الاختبار في Google.
تبلّغ Google عن invalid_client
لا تقبل Google العميل. تحقّق من معرّف العميل (Client ID) وسر العميل (Client Secret) المحفوظين في Localtonet، ومن أن العميل لا يزال موجودًا في Google. الصق كليهما مرة أخرى واختر حفظ المزوّد. وإذا لم يعد السر لديك، فأنشئ سرًّا جديدًا في Google.
"403 - Access Denied" بعد تسجيل دخول ناجح عبر Google
رفضت إحدى قواعد Localtonet الحساب. قارن العنوان الذي سجّل الزائر الدخول به بكل من نطاقات البريد الإلكتروني المسموح بها ونطاقات البريد الإلكتروني المحظورة وعناوين البريد الإلكتروني المحظورة الخاصة بالمزوّد، وبـ من يمكنه تسجيل الدخول في النفق.
لا يوجد زر Google في صفحة تسجيل الدخول
المزوّد غير مفعّل لهذا النفق، أو هو مضبوط على غير نشط. تحقّق من الأمرين.