كيفية تفعيل تسجيل الدخول باستخدام Google وApple

هذا الدليل مخصص للوسطاء الذين يرغبون في تمكين عملائهم من تسجيل الدخول أو التسجيل باستخدام حساب Google أو Apple، بالإضافة إلى البريد الإلكتروني وكلمة المرور (أو بدلاً منهما). يشرح ما تحتاج إلى إعداده من جانبك وما يحدث بعد تزويد B2Broker بالمعلومات.

ما الذي ستحصل عليه

• زر "تسجيل الدخول باستخدام Google" و/أو "تسجيل الدخول باستخدام Apple" في صفحات تسجيل الدخول والتسجيل.
• يتم إنشاء المستخدمين الجدد الذين يسجلون بهذه الطريقة تلقائيًا — دون الحاجة إلى نموذج تسجيل منفصل.
• يمكن للمستخدمين الذين لديهم حساب بكلمة مرور بالفعل ربط حساب Google/Apple لاحقًا أيضًا (يتم الربط عبر عنوان البريد الإلكتروني).

قبل البدء

• أكد مع مدير حساب B2Broker الخاص بك أن تسجيل الدخول عبر الشبكات الاجتماعية متاح لمثيل B2CORE الخاص بك. يعتمد ذلك على استخدامك بالفعل لمنصة الهوية الحالية.
• حدد موفري الخدمة الذين تريدهم: Google فقط أو Apple فقط أو كليهما. يتطلب Apple حساب Apple Developer مدفوعًا، لذا خطط لذلك إذا كنت تريده.
• ستحتاج إلى شخص من جانبك لديه صلاحية الوصول إلى حسابات Google Cloud / Apple Developer الخاصة بشركتك (أو لديه القدرة على إنشاء حسابات جديدة).

ما تحتاج إلى إعداده — Google

1. مشروع Google Cloud. استخدم مشروعًا حاليًا للشركة أو أنشئ مشروعًا جديدًا مخصصًا لتسجيل الدخول.
2. شاشة موافقة OAuth. قم بإعداد:
   • اسم التطبيق، وبريد الدعم الإلكتروني، والشعار (هذا ما سيراه المستخدمون في نافذة موافقة Google).
   • النطاقات: openid، email، profile.
   • حالة النشر: أثناء وجود التطبيق في وضع Testing، يمكن فقط لمستخدمي الاختبار المضافين صراحةً تسجيل الدخول — وسيحصل أي شخص آخر على access_denied. انقل التطبيق إلى حالة Published قبل الإطلاق.
3. معرّف عميل OAuth 2.0 (نوع التطبيق: Web application).

   • سنزوّدك بعنوان Authorized redirect URI الدقيق لتسجيله — وهو مرتبط باسم مضيف مثيل B2CORE الخاص بك ويبدو كالتالي:

     https://<your-api-host>/srvsz/auth/clients/v1/self-service/methods/oidc/callback/google

   • أضف المضيف نفسه (دون مسار) كـ Authorized JavaScript origin.

4. انسخ Client ID وClient secret الناتجين.

ما تحتاج إلى إعداده — Apple

يحتوي إعداد Apple على أجزاء أكثر ويتطلب عضوية نشطة في Apple Developer Program.

1. App ID مع تفعيل إمكانية Sign In with Apple (أعد استخدام App ID موجودًا إذا كان لديك واحد، أو أنشئ واحدًا جديدًا).
2. Services ID — وهو عميل OAuth الفعلي الذي يستخدمه Apple. عند إعداده:
   • Domain: مضيف API لمثيل B2CORE الخاص بك (دون مخطط أو مسار).
   • Return URL: عنوان URL الخاص باستدعاء Apple الذي نوفره، بنفس صيغة عنوان Google أعلاه ولكن منتهيًا بـ /apple.
3. مفتاح خاص "Sign in with Apple" (ملف .p8) يتم إنشاؤه ضمن قسم Keys في Apple، مع ربط إمكانية Sign In with Apple بـ App ID الخاص بك.

4. Team ID الخاص بك (مكوّن من 10 أحرف وأرقام، ويظهر في رأس حساب Apple Developer الخاص بك).
5. Key ID للمفتاح الذي أنشأته في الخطوة 3.

تسليم بيانات الاعتماد إلى B2Broker

أرسل لنا:

• Google: Client ID + Client secret.
• Apple: Services ID وTeam ID وKey ID وملف المفتاح الخاص .p8.

ما الذي يحدث بعد ذلك

بمجرد حصولنا على بيانات الاعتماد الخاصة بك، نقوم بتفعيل الميزة على مثيل B2CORE الخاص بك وإجراء النشر.

الاختبار بعد الإطلاق

1. افتح صفحة تسجيل الدخول الخاصة بك — ينبغي أن ترى زر/أزرار Google/Apple.
2. سجّل الدخول باستخدام حساب حقيقي لكل موفر مفعّل.
3. تأكد من أن المستخدم يصل وهو مسجل الدخول، وأن بريده الإلكتروني واسمه يظهران بشكل صحيح في لوحة الإدارة.
4. إذا كان Google لا يزال في وضع Testing، فلن يتمكن من تسجيل الدخول إلا مستخدمو الاختبار الذين أضفتهم إلى شاشة الموافقة — بينما سيرى الجميع الآخرون access_denied. انشر التطبيق قبل الإعلان عن الميزة للمستخدمين الفعليين.

معلومات مفيدة

الأسئلة / الدعم

تواصل مع مدير حساب B2Broker الخاص بك أو قناة الدعم، مع ذكر اسم وسيطك وموفر الخدمة الذي تقوم بإعداده.