انتقل إلى المحتوى الرئيسي

Google

إعداد موفر المصادقة عبر Google OAuth 2.0​

لدمج المصادقة عبر Google في مشروعك، يجب إنشاء مشروع في Google Cloud Console، والحصول على بيانات الاعتماد، وإعداد اتفاقية OAuth. ستوجهك هذه التعليمات خطوة بخطوة خلال هذه العملية.

البيانات المطلوبة لنموذجك:

  • موفر OAuth: Google
  • معرف عميل OAuth: Ваш_Client_ID.apps.googleusercontent.com
  • المفتاح السري للتحقق من بيانات OAuth: Ваш_Client_Secret
  • رابط مصادقة موفر OAuth: https://accounts.google.com/o/oauth2/v2/auth
  • معرف مشروع OAuth: معرف المشروع من الخطوة 1
  • رابط رأس أصول OAuth: https://www.googleapis.com
  • رابط تبادل الرموز (افتراضي - من إعداد الموفر) — حقل اختياري، يتم استخدام https://oauth2.googleapis.com/token بشكل افتراضي

الخطوة 1: إنشاء مشروع في Google Cloud Console​

  1. انتقل إلى Google Cloud Console: https://console.cloud.google.com/.
  2. إذا لم يكن لديك مشروع بعد، قم بإنشائه:
    • انقر على قائمة المشاريع المنسدلة في الشريط العلوي.
    • انقر على "مشروع جديد".
    • أدخل اسمًا واضحًا للمشروع (مثل My App Auth).
    صفحة 'New Project' في Google Cloud مع الحقلين 'Project name' و'Location' والزر 'Create'.
    • إذا لزم الأمر، اختر منظمة وانقر على "إنشاء".

الخطوة 2: إعداد شاشة الموافقة لـ OAuth​

قبل إنشاء بيانات الاعتماد، يجب إعداد الشاشة التي سيرىها المستخدمون عند السماح بالوصول إلى تطبيقك.

  1. في القائمة اليسرى، اختر "APIs والخدمات" -> "شاشة الموافقة لـ OAuth". قائمة Google Cloud: ضمن 'APIs & Services' يظهر العنصر 'OAuth consent screen'. صفحة 'OAuth Overview' في Google Auth Platform: لم يتم الإعداد بعد، مع الزر 'Get started'.
  2. معلومات حول التطبيق
    • اسم التطبيق: أدخل الاسم العام لتطبيقك الذي سيراه المستخدمون.
    • عناوين البريد الإلكتروني لدعم العملاء: بريد إلكتروني للتواصل في حال وجود استفسارات من المستخدمين.
    خطوة 'App Information': الحقل 'App name' معبأ، ويليه الحقل 'User support email' والزر 'Next'.
  3. اختر نوع المستخدم ("خارجي" للتطبيقات المتاحة لأي مستخدم لديه حساب Google). خطوة 'Audience': نوع المستخدم 'External' محدد، وأسفله الزر 'Next'.
  4. أدخل بريدك الإلكتروني للتواصل: خطوة 'Contact Information' مع الحقل 'Email addresses' والزر 'Next'.
  5. انقر على "إنشاء". خطوة 'Finish': تم تحديد الموافقة على 'Google API Services: User Data Policy'، مع الزرين 'Continue' و'Create'.
  6. انقر على "حفظ ومتابعة". يمكن كتابة الخطوات التالية (المجالات، المستخدمون التجريبيون) أو تخطيها والعودة إليها لاحقًا.

الخطوة 3: إنشاء بيانات الاعتماد (معرف العميل والسر)​

  1. في القائمة اليسرى، اختر "APIs والخدمات" -> "بيانات الاعتماد".

    قائمة Google Cloud: ضمن 'APIs & Services' يظهر العنصر 'Credentials'.
  2. انقر على "إنشاء بيانات اعتماد" في أعلى الصفحة واختر "معرف عميل OAuth".

    صفحة 'Credentials' في 'APIs & Services' مع الزر 'Create credentials' في الأعلى وجداول مفاتيح فارغة. قائمة 'Create credentials' مفتوحة مع تمييز الخيار 'OAuth client ID'.
  3. اختر نوع التطبيق: تطبيق ويب. أدخل اسم التطبيق.

    صفحة 'Create OAuth client ID': الخيار 'Web application' مميز في قائمة 'Application type'.
  4. حدد URI المعاد توجيهه المصرح به:

    • مثال: https://ваш-сайт.com/
  5. انقر على "إنشاء".

  6. ستظهر نافذة منبثقة تحتوي على مفاتيحك. احفظها في مكان آمن.

    • "معرف العميل" هو معرف عميل OAUTH الخاص بك.
    • "سر العميل" هو المفتاح السري للتحقق من بيانات OAUTH.

ملء النموذج في مشروعك​

قسم 'Additional settings' للمزوّد في OneEntry: حقول مفتاح JWT ومدة صلاحية الرموز و'OAuth client ID' و'OAuth project ID' وعناوين OAuth.

الآن، باستخدام البيانات التي حصلت عليها، املأ نموذج إنشاء الموفر في مشروعك:

الحقل في نموذجكالقيمة لـ Google OAuthالملاحظات
موفر OAuthGoogleاختر Google من قائمة الخدمات.
معرف عميل OAuthxxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.comمعرف العميل من الخطوة 3.
رابط مصادقة موفر OAuthhttps://accounts.google.com/o/oauth2/v2/authنقطة النهاية القياسية لبدء المصادقة.
المفتاح السري للتحقق من بيانات OAuthGOCSPX-xxxxxxxxxxxxxxxxxxxxxxxxxxسر العميل من الخطوة 3.
معرف مشروع OAuthID_вашего_проектаمعرف المشروع الذي تم إنشاؤه في الخطوة 1.
رابط رأس أصول OAuthhttps://www.googleapis.comيحدد من أي نطاق مسموح بالطلبات.
رابط تبادل الرموز (افتراضي - من إعداد الموفر)يمكن تركه فارغًاحقل اختياري. يتم استخدام https://oauth2.googleapis.com/token بشكل افتراضي.