المصادقة باستخدام Microsoft وC++

يمكنك السماح للمستخدمين بالمصادقة باستخدام Firebase من خلال موفّري OAuth، مثل Microsoft Azure Active Directory، عن طريق دمج تسجيل الدخول العام المستند إلى الويب باستخدام بروتوكول OAuth في تطبيقك باستخدام حزمة Firebase SDK لتنفيذ عملية تسجيل الدخول من البداية إلى النهاية. بما أنّ هذه العملية تتطلّب استخدام حِزم Firebase SDK المستندة إلى الهاتف، فهي متوافقة فقط مع منصّتَي Android وApple.

قبل البدء

1. أضِف Firebase إلى مشروعك بلغة C++‎.
2. في وحدة تحكّم Firebase، انتقِل إلى الأمان > المصادقة.
3. في علامة التبويب طريقة تسجيل الدخول ، فعِّل موفّر تسجيل الدخول Microsoft.
4. أضِف معرّف العميل وسر العميل من وحدة تحكّم المطوّرين التابعة لموفّر الخدمة إلى إعدادات الموفّر:
   1. لتسجيل عميل OAuth من Microsoft، اتّبِع التعليمات الواردة في مقالة التشغيل السريع: تسجيل تطبيق باستخدام نقطة النهاية Azure Active Directory v2.0. يُرجى العِلم أنّ نقطة النهاية هذه تتيح تسجيل الدخول باستخدام حسابات Microsoft الشخصية وحسابات Azure Active Directory. مزيد من المعلومات عن Azure Active Directory v2.0.
   2. عند تسجيل التطبيقات باستخدام موفّري الخدمة هؤلاء، احرص على تسجيل النطاق *.firebaseapp.com لمشروعك كنطاق إعادة التوجيه لتطبيقك.
5. انقر على حفظ.

الوصول إلى الفئة firebase::auth::Auth

الفئة Auth هي بوابة جميع طلبات البيانات من واجهة برمجة التطبيقات.

1. أضِف ملفَي رأس Auth وApp:

   #include "firebase/app.h"
   #include "firebase/auth.h"

2. في رمز الإعداد، أنشِئ فئة firebase::App.

   #if defined(__ANDROID__)
     firebase::App* app =
         firebase::App::Create(firebase::AppOptions(), my_jni_env, my_activity);
   #else
     firebase::App* app = firebase::App::Create(firebase::AppOptions());
   #endif  // defined(__ANDROID__)

3. احصل على الفئة firebase::auth::Auth لـ firebase::App. هناك علاقة فردية بين App وAuth.

   firebase::auth::Auth* auth = firebase::auth::Auth::GetAuth(app);

التعامل مع عملية تسجيل الدخول باستخدام حزمة Firebase SDK

للتعامل مع عملية تسجيل الدخول باستخدام حزمة Firebase SDK، اتّبِع الخطوات التالية:

1. أنشِئ مثيلاً من FederatedOAuthProviderData تم إعداده باستخدام رقم تعريف الموفّر المناسب لـ Microsoft.

   firebase::auth::FederatedOAuthProviderData
       provider_data(firebase::auth::MicrosoftAuthProvider::kProviderId);
   

2. اختياري: حدِّد مَعلمات OAuth المخصّصة الإضافية التي تريد إرسالها مع طلب OAuth.

   // Prompt user to re-authenticate to Microsoft.
   provider_data.custom_parameters["prompt"] = "login";
   
   // Target specific email with login hint.
   provider_data.custom_parameters["login_hint"] =
       "[e-mail]";
   

   للاطّلاع على المَعلمات التي تتيحها Microsoft، يُرجى الرجوع إلى مستندات Microsoft OAuth. يُرجى العِلم أنّه لا يمكنك تمرير المَعلمات المطلوبة من Firebase باستخدام setCustomParameters(). هذه المَعلمات هي client_id، response_type، redirect_uri، state، scope و response_mode.

   للسماح للمستخدمين من مستأجر معيّن في Azure AD فقط بتسجيل الدخول إلى التطبيق، يمكن استخدام اسم النطاق المألوف لمستأجر Azure AD أو المعرِّف الفريد العالمي (GUID) للمستأجر. يمكن إجراء ذلك عن طريق تحديد الحقل "tenant" في عنصر المَعلمات المخصّصة.

   // Optional "tenant" parameter in case you are using an Azure AD tenant.
   // eg. '8eaef023-2b34-4da1-9baa-8bc8c9d6a490' or 'contoso.onmicrosoft.com'
   // or "common" for tenant-independent tokens.
   // The default value is "common".
   provider_data.custom_parameters["tenant"] ="TENANT_ID";
   

3. اختياري: حدِّد نطاقات OAuth 2.0 الإضافية التي تريد طلبها من موفّر المصادقة، بالإضافة إلى الملف الشخصي الأساسي.

   provider_data.scopes.push_back("mail.read");
   provider_data.scopes.push_back("calendars.read");
   

   لمزيد من المعلومات، يُرجى الرجوع إلى مستندات الأذونات والموافقة من Microsoft.

4. بعد إعداد بيانات الموفّر، استخدِمها لإنشاء FederatedOAuthProvider.

   // Construct a FederatedOAuthProvider for use in Auth methods.
   firebase::auth::FederatedOAuthProvider provider(provider_data);
   

5. صادِق باستخدام Firebase من خلال عنصر موفّر المصادقة. يُرجى العِلم أنّه على عكس عمليات FirebaseAuth الأخرى، سيتحكّم هذا الإجراء في واجهة المستخدم من خلال عرض طريقة عرض ويب يمكن للمستخدم من خلالها إدخال بيانات الاعتماد.

   لبدء عملية تسجيل الدخول، استخدِم SignInWithProvider:

   firebase::Future<firebase::auth::AuthResult> result =
     auth->SignInWithProvider(provider_data);
   

   يمكن لتطبيقك الانتظار أو تسجيل ردّ الاتصال في Future.

   باستخدام رمز الدخول إلى OAuth، يمكنك استدعاء Microsoft Graph API.

   على عكس موفّري الخدمة الآخرين الذين تتيحهم Firebase Auth، لا يقدّم Microsoft عنوان URL لصورة، وبدلاً من ذلك، يجب طلب البيانات الثنائية لصورة الملف الشخصي من خلال Microsoft Graph API.

6. في حين أنّ الأمثلة أعلاه تركّز على عمليات تسجيل الدخول، يمكنك أيضًا ربط موفّر Microsoft Azure Active Directory بمستخدم حالي باستخدام LinkWithProvider. على سبيل المثال، يمكنك ربط عدّة موفّري خدمة بالمستخدم نفسه، ما يسمح له بتسجيل الدخول باستخدام أيّ منهم.

   firebase::Future<firebase::auth::AuthResult> result = user.LinkWithProvider(provider_data);
   

7. يمكن استخدام النمط نفسه مع ReauthenticateWithProvider الذي يمكن استخدامه لاسترداد بيانات اعتماد جديدة للعمليات الحسّاسة التي تتطلّب تسجيل دخول حديثًا.

   firebase::Future<firebase::auth::AuthResult> result =
     user.ReauthenticateWithProvider(provider_data);
   

   يمكن لتطبيقك الانتظار أو تسجيل ردّ الاتصال في Future.

إجراء متقدِّم: التعامل مع عملية تسجيل الدخول يدويًا

على عكس موفّري OAuth الآخرين الذين تتيحهم Firebase، مثل Google وFacebook، وTwitter، حيث يمكن تسجيل الدخول مباشرةً باستخدام بيانات الاعتماد المستندة إلى رمز الدخول إلى OAuth، لا تتيح Firebase Auth الإمكانية نفسها لموفّري الخدمة مثل Microsoft بسبب عدم قدرة خادم Firebase Auth على التحقّق من جمهور رموز الدخول إلى OAuth من Microsoft. هذا شرط أمان أساسي وقد يعرّض التطبيقات والمواقع الإلكترونية لهجمات إعادة التشغيل حيث يمكن استخدام رمز الدخول إلى OAuth من Microsoft الذي تم الحصول عليه لمشروع واحد (المهاجم) لتسجيل الدخول إلى مشروع آخر (الضحية). بدلاً من ذلك، تتيح Firebase Auth إمكانية التعامل مع عملية OAuth بالكامل و تبادل رمز التفويض باستخدام معرّف عميل OAuth والسرّ الذي تم إعدادهما في وحدة تحكّم Firebase. بما أنّه لا يمكن استخدام رمز التفويض إلا مع معرّف عميل/سرّ معيّنَين، لا يمكن استخدام رمز تفويض تم الحصول عليه لمشروع واحد مع مشروع آخر.

إذا كان من الضروري استخدام موفّري الخدمة هؤلاء في بيئات غير متوافقة، يجب استخدام مكتبة OAuth تابعة لجهة خارجية والمصادقة المخصّصة في Firebase سيحتاج إلى استخدامها. الأولى مطلوبة للمصادقة مع موفّر الخدمة والأخيرة لتبادل بيانات اعتماد موفّر الخدمة مقابل رمز مخصّص.

الخطوات التالية

بعد أن يُسجِّل المستخدم الدخول للمرة الأولى، يتم إنشاء حساب مستخدم جديد وربطه ببيانات الاعتماد، أي اسم المستخدم وكلمة المرور أو رقم الهاتف أو معلومات موفّر المصادقة التي سجّل المستخدم الدخول بها. يتم تخزين هذا الحساب الجديد كجزء من مشروع Firebase، ويمكن استخدامه لتحديد هوية المستخدم في كل تطبيق في مشروعك، بغض النظر عن طريقة تسجيل الدخول.

• في تطبيقاتك، يمكنك الحصول على معلومات الملف الشخصي الأساسية للمستخدم من الـ firebase::auth::User object:

  firebase::auth::User user = auth->current_user();
  if (user.is_valid()) {
    std::string name = user.display_name();
    std::string email = user.email();
    std::string photo_url = user.photo_url();
    // The user's ID, unique to the Firebase project.
    // Do NOT use this value to authenticate with your backend server,
    // if you have one. Use firebase::auth::User::Token() instead.
    std::string uid = user.uid();
  }

• في Firebase Realtime Database وCloud Storage قواعد الأمان، يمكنك الحصول على رقم تعريف المستخدم الفريد للمستخدم الذي سجّل الدخول من متغيّر auth، واستخدامه للتحكّم في البيانات التي يمكن للمستخدم الوصول إليها.

يمكنك السماح للمستخدمين بتسجيل الدخول إلى تطبيقك باستخدام عدّة موفّري مصادقة عن طريق ربط بيانات اعتماد موفّر المصادقة بحساب مستخدم حالي.

لتسجيل خروج مستخدم، استخدِم SignOut():

auth->SignOut();