Google OAuth - Gorbit Documentation

قم بتكوين Gorbit لاستخدام Google OAuth لمصادقة المستخدمين، مما يوفر تجربة تسجيل دخول سلسة من خلال حسابات Google الحالية. المتطلبات الأساسية:

وصول إلى Google Cloud Console
أذونات إدارية لتكوين تطبيقات OAuth

الدليل

إنشاء مشروع Google Cloud

انتقل إلى صفحة إنشاء المشروع في Google Cloud Console واملأ الحقول المطلوبة.

Google Cloud Console Project Creation Page

تفعيل Google People API

انتقل إلى APIs & Services وابحث عن Google People API.تأكد من أن مشروعك المنشأ حديثًا محدد في الشريط العلوي وانقر Enable.

Google Cloud Console People API Enable Page

إنشاء منصة Google Auth

افتح الشريط الجانبي وانتقل إلى APIs & Services → OAuth Consent Screen.بمجرد الوصول إلى صفحة Overview، انقر Get Started.

Google Cloud Console OAuth Consent Screen Page

تكوين مشروع OAuth وشاشة الموافقة

املأ حقول App name و User support email.اختر Audience. إذا كان لديك منظمة Google Workspace، اختر Internal. إن لم يكن، اختر External.

إذا اخترت External، ستحتاج إلى إضافة مستخدميك يدويًا في تبويب Audience تحت Test users.

املأ أي حقول مطلوبة أخرى وأنهِ التكوين.

إنشاء عميل OAuth

انتقل إلى صفحة APIs & Services → OAuth Consent Screen → Clients.انقر ”+ Create Client” واختر Web Application.

Google Cloud Console OAuth Client Creation Page

تكوين عميل OAuth

الاسم: Gorbitيعتمد Authorized JavaScript origins و Authorized redirect URIs على بيئة نشرك.إذا كنت تستضيف Gorbit محليًا استخدم:

http://localhost:3000
http://localhost:3000/auth/oauth/callback

إذا كنت تستضيف Gorbit على نطاق مخصص استخدم:

https://YOUR_GORBIT_DOMAIN.com
https://YOUR_GORBIT_DOMAIN.com/auth/oauth/callback

تأكد أن عناوين URI التي تدخلها هنا تطابق URI الذي تستخدمه للوصول إلى Gorbit!

حفظ بيانات اعتماد OAuth

انقر Create → Download JSON لحفظ بيانات اعتماد عميل OAuth. بدلاً من ذلك، احفظ Client ID و Client Secret في مدير كلمات مرور أو أسرار.

تكوين Gorbit

قم بتكوين Gorbit مع متغيرات البيئة التالية في ملف .env أو values.yaml (Docker و Kubernetes، على التوالي).

.env

AUTH_TYPE=google_oauth
OAUTH_CLIENT_ID=YOUR_CLIENT_ID
OAUTH_CLIENT_SECRET=YOUR_CLIENT_SECRET

# إذا كنت تنشر على نطاق مخصص، ستحتاج إلى ضبط متغير البيئة `WEB_DOMAIN`.
WEB_DOMAIN=https://YOUR_GORBIT_DOMAIN.com

إذا كنت تستخدم Docker ولكن ليس لديك ملف .env، انسخ gorbit/deployment/docker_compose/env.prod.template إلى ملف .env جديد في نفس المجلد.

values.yaml

auth:
  secrets:
    OAUTH_CLIENT_ID: <CLIENT_ID_FROM_GOOGLE>
    OAUTH_CLIENT_SECRET:<CLIENT_SECRET_FROM_GOOGLE>
configMap:
  AUTH_TYPE: google_oauth

​الدليل

الدليل