تمكين مزامنة المجموعة من Google Workplace (تجريبي)

توثيق التكاملات
,
1

:warning: هذا تجريبي. قد تتغير الميزة دون إشعار.

للبدء، قم بتكوين تسجيل الدخول إلى Google وفقًا لهذه التعليمات:

ثم اتبع هذه الخطوات:

  1. في لوحة تحكم Google لتكامل OAuth الخاص بك، انتقل إلى “APIs & Services”، وأضف “Admin SDK”

    Screenshot 2022-05-11 at 18.13.09
    Screenshot 2022-05-11 at 18.13.091920×481 50.3 KB
    →
    Screenshot 2022-05-11 at 18.13.26
    Screenshot 2022-05-11 at 18.13.263014×962 193 KB
    →
    Screenshot 2022-05-11 at 18.29.40
    Screenshot 2022-05-11 at 18.29.403016×736 105 KB

  2. انتقل إلى “IAM & Admin” → “Service Accounts” → “Create Service Account” وقم بإعداد حساب. الخطوتان الاختياريتان غير مطلوبتين - تخطاهما.

    Screenshot 2022-09-19 at 16.50.50
    Screenshot 2022-09-19 at 16.50.501678×1378 271 KB

  3. في قائمة حسابات الخدمة، انقر فوق الحساب الذي تم إنشاؤه حديثًا، وسجل “unique id” لوقت لاحق، ثم انتقل إلى علامة التبويب “keys”. قم بإنشاء مفتاح جديد بتنسيق “JSON” واحفظ الملف لوقت لاحق.

  4. انتقل إلى admin.google.com، وقم بزيارة قسم “security”. افتح “API Controls”، “Manage Third Party App Access”. ثم “Add App”، “OAuth App Name or Client ID”. أدخل معرف العميل لتطبيق OAuth الخاص بك، ثم حدده من القائمة. اتبع الخطوات، وتأكد من تعيين التطبيق على “Trusted”. يجب أن يظهر بعد ذلك في القائمة:

    Screenshot 2022-05-12 at 10.55.35
    Screenshot 2022-05-12 at 10.55.351920×675 53.4 KB

  5. عد إلى قسم “API Controls”، قم بالتمرير لأسفل، واختر “Manage Domain Wide Delegation”. اختر “Add New”، وأدخل معرف العميل لحساب الخدمة الذي أنشأته سابقًا. ضمن “scopes”، الصق القيمة

    https://www.googleapis.com/auth/admin.directory.group.readonly

  6. في لوحة تحكم Discourse الخاصة بك، انتقل إلى علامة التبويب “settings” وابحث عن “google oauth2 hd”. قم بتكوين الإعدادات التالية:

    google oauth2 hd: اسم نطاق Google Workspace الخاص بك

    google_oauth2_hd_groups_service_account_json: الصق محتويات ملف مفتاح حساب الخدمة الذي أنشأته سابقًا

    google_oauth2_hd_groups_service_account_admin_email: أدخل عنوان البريد الإلكتروني لأي حساب مسؤول في Google Workspace. سيتم استخدام هذا الهوية بواسطة حساب الخدمة عند جلب معلومات مجموعات Google

    google oauth2 hd groups: ممكّن

في المرة القادمة التي يقوم فيها المستخدم بتسجيل الدخول، سيقوم Discourse بجلب وتخزين معلومات مجموعات Google في الخلفية.

لربط مجموعة Google بمجموعة Discourse، قم بزيارة تكوين المجموعة في Discourse، وانتقل إلى قسم Manage → Membership. ضمن “Automatic”، سترى قائمة منسدلة جديدة تتيح لك ربط أي عدد من مجموعات Google بمجموعة Discourse:

Screenshot 2022-05-12 at 10.48.28
Screenshot 2022-05-12 at 10.48.282390×960 198 KB

يجب أن تسري التغييرات على هذا الإعداد على الفور. ستسري التغييرات على عضوية المجموعة في Google عند تسجيل دخول المستخدم التالي.

شكر كبير لـ @angus على عمله على هذه الميزة. نأمل في توسيع نظام مزامنة المجموعات هذا إلى طرق تسجيل دخول أخرى في المستقبل القريب.

8 إعجابات
2

أود استخدام هذا مع “generic oauth2” (لـ auth0 تحديدًا). هل هناك موضوع آخر أو مشكلة على GitHub يمكنني متابعتها لهذا الغرض؟

3 إعجابات
3

@david أو @angus هل يمكنك تقديم المزيد من التفاصيل للعنصر 6.

> اقتباس google oauth2 hd: اسم النطاق الخاص بك في Google Workspace

  1. هل تقصد نطاقي (ebsp.org) الذي يحتوي على حساب Workspace؟ أم النطاق الفعلي لـ Workspace.
  2. هل هو مجرد عنوان URL؟

> اقتباس google_oauth2_hd_groups_service_account_json: الصق محتويات ملف مفتاح حساب الخدمة الذي أنشأته سابقًا
انسخ والصق المحتويات بأكملها من JSON؟

4

@angus @david لقد اتبعت هذه التعليمات كما هي موضحة. لدي مربع للبحث عن مجموعة، ولكن لا توجد مجموعات تظهر. أي أفكار؟

6

مرحباً تشارلي، google oauth2 hd يأتي من Google OIDC API (المستندات هنا). يقولون إنه:

النطاق المرتبط بمؤسسة Google Workspace أو Cloud للمستخدم

لإعطاء مثال، إذا كنت أقوم بإعداد هذا داخليًا لموظفينا، فسأقوم بتعيين القيمة على discourse.org.

نعم!

ستظهر مجموعات Google في Discourse فقط بمجرد تسجيل عضو في تلك المجموعة في Discourse باستخدام Google. ليس لدينا أي نظام لسردها مقدمًا.

إعجاب واحد (1)
7

@david لقد تمكنت أخيرًا من تشغيله. اضطررت إلى إيقاف تشغيل بعض الأشياء. الطريقة التي تم بها إعداد موقعي، تم تسجيل دخول المستخدمين تلقائيًا عبر Google Oauth. قمت بإيقاف تشغيل ذلك و Discourse Connect وعمل الأمر. غير متأكد من أي منهما كان يتسبب في قطع الاتصال. بمجرد تسجيل الدخول فعليًا باستخدام Google، تم ملء كل شيء.

إعجاب واحد (1)
8

هل لا يزال قراءة مجموعات Google تجريبية؟ هل تغيرت هذه التعليمات؟

إعجاب واحد (1)
9

مثل @John_Faig، أتساءل عما إذا كان هذا لا يزال تجريبيًا.

لقد رأيت هذه الميزة للتو ولدي ثلاث مجموعات Google أود ترحيلها. إن إقناع الأشخاص بـ “التغيير” أمر صعب للغاية. نحتاج إلى أسباب وجيهة للخروج من منطقة راحتنا. ثم لا نريد عقبات في العملية. إنشاء تسجيل دخول (Discourse) في موقع ويب آخر هو إزعاج للأشخاص المستثمرين بالفعل في GG. إذا كانت هذه الميزة مستقرة، تتم إزالة العقبة المحتملة، ويمكننا التركيز على تقديم أسباب مقنعة للجمهور للترحيل.

شكرا!