المصادقة مع Firebase دون الكشف عن الهوية باستخدام C++

يمكنك استخدام Firebase Authentication لإنشاء حسابات مؤقتة مجهولة الهوية واستخدامها للمصادقة مع Firebase. يمكن استخدام هذه الحسابات المؤقتة المجهولة الهوية للسماح للمستخدمين الذين لم يشتركوا بعد في تطبيقك بالعمل مع البيانات المحمية بموجب قواعد الأمان. إذا قرّر مستخدم مجهول الهوية الاشتراك في تطبيقك، يمكنك ربط بيانات اعتماده الخاصة بتسجيل الدخول بالحساب المجهول الهوية ليتمكّن من مواصلة العمل باستخدام بياناته المحمية في الجلسات المستقبلية.

قبل البدء

1. أضِف Firebase إلى مشروع C++‎.
2. إذا لم يسبق لك ربط تطبيقك بمشروعك على Firebase، يمكنك إجراء ذلك من خلال وحدة تحكّم Firebase.
3. تفعيل المصادقة بدون الكشف عن الهوية:
   1. في Firebase وحدة التحكّم، انتقِل إلى الأمان > المصادقة.
   2. في علامة التبويب طريقة تسجيل الدخول، فعِّل موفِّر تسجيل الدخول بدون تحديد الهوية.
   3. اختياري: إذا كنت قد رقّيت مشروعك إلى Firebase Authentication with Identity Platform، يمكنك تفعيل ميزة التنظيف التلقائي. عند تفعيل هذا الإعداد، سيتم تلقائيًا حذف الحسابات المجهولة التي مرّ عليها أكثر من 30 يومًا. في المشاريع التي تم تفعيل ميزة التنظيف التلقائي فيها، لن يتم احتساب المصادقة المجهولة الهوية ضمن حدود الاستخدام أو حصص الفوترة. اطّلِع على مقالة التنظيف التلقائي.

المصادقة باستخدام Firebase بدون الكشف عن الهوية

عندما يستخدم مستخدم سجّل الخروج ميزة في التطبيق تتطلّب المصادقة باستخدام Firebase، سجِّل دخول المستخدم بشكل مجهول الهوية من خلال إكمال الخطوات التالية:

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

   #include <cassert>
   #include <cstdint>
   
   #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::Future<firebase::auth::AuthResult> result =
    auth->SignInAnonymously();

firebase::Future<firebase::auth::AuthResult> result =
    auth->SignInAnonymouslyLastResult();
if (result.status() == firebase::kFutureStatusComplete) {
  if (result.error() == firebase::auth::kAuthErrorNone) {
    firebase::auth::AuthResult auth_result = *result.result();
    printf("Sign in succeeded for `%s`\n",
           auth_result.user.display_name().c_str());
  } else {
    printf("Sign in failed with error '%s'\n", result.error_message());
  }
}

تحويل حساب مجهول إلى حساب دائم

عندما يشترك مستخدم مجهول الهوية في تطبيقك، قد تريد السماح له بمواصلة عمله باستخدام حسابه الجديد، مثلاً، قد تريد إتاحة السلع التي أضافها المستخدم إلى سلّة التسوّق قبل الاشتراك في سلّة التسوّق الخاصة بحسابه الجديد. لإجراء ذلك، أكمل الخطوات التالية:

1. عندما يسجّل المستخدم، أكمل عملية تسجيل الدخول لمقدّم خدمة المصادقة الخاص بالمستخدم حتى، ولكن بدون، استدعاء إحدى طرق Auth::SignInWith. على سبيل المثال، يمكنك الحصول على رمز تعريف Google أو رمز الدخول إلى Facebook أو عنوان البريد الإلكتروني وكلمة المرور الخاصين بالمستخدم.

2. احصل على auth::Credential لمقدّم المصادقة الجديد:

   تسجيل الدخول باستخدام حساب Google

   firebase::auth::Credential credential =
       firebase::auth::GoogleAuthProvider::GetCredential(google_id_token,
                                                         nullptr);

   تسجيل الدخول باستخدام Facebook

   firebase::auth::Credential credential =
       firebase::auth::FacebookAuthProvider::GetCredential(access_token);

   تسجيل الدخول باستخدام عنوان البريد الإلكتروني وكلمة المرور

   firebase::auth::Credential credential =
       firebase::auth::EmailAuthProvider::GetCredential(email, password);

3. مرِّر العنصر auth::Credential إلى الطريقة LinkWithCredential الخاصة بالمستخدم الذي سجّل الدخول:

   // Link the new credential to the currently active user.
   firebase::auth::User current_user = auth->current_user();
   firebase::Future<firebase::auth::AuthResult> result =
       current_user.LinkWithCredential(credential);

في حال نجاح طلب LinkWithCredential، يمكن للحساب الجديد للمستخدم الوصول إلى بيانات Firebase الخاصة بالحساب المخفي الهوية.

التنظيف التلقائي

إذا كنت قد رقّيت مشروعك إلى Firebase Authentication with Identity Platform، يمكنك تفعيل ميزة التنظيف التلقائي في وحدة تحكّم Firebase. عند تفعيل هذه الميزة، تسمح لخدمة Firebase بحذف الحسابات المجهولة تلقائيًا إذا مرّ عليها أكثر من 30 يومًا. في المشاريع التي تم تفعيل ميزة التنظيف التلقائي فيها، لن يتم احتساب المصادقة المجهولة ضمن حدود الاستخدام أو حصص الفوترة.

• قد يتم تلقائيًا حذف أي حسابات مجهولة الهوية تم إنشاؤها بعد تفعيل ميزة التنظيف التلقائي في أي وقت بعد مرور 30 يومًا على إنشائها.
• ستكون الحسابات المجهولة الحالية مؤهَّلة للحذف التلقائي بعد 30 يومًا من تفعيل ميزة التنظيف التلقائي.
• إذا أوقفت ميزة التنظيف التلقائي، ستبقى أي حسابات مجهولة الهوية مجدوَلة للحذف.
• إذا "رقّيت" حسابًا مجهول الهوية من خلال ربطه بأي طريقة لتسجيل الدخول، لن يتم حذف الحساب تلقائيًا.

إذا أردت معرفة عدد المستخدمين المتأثرين قبل تفعيل هذه الميزة، وكنت قد رقّيت مشروعك إلى Firebase Authentication with Identity Platform، يمكنك الفلترة حسب is_anon في تسجيل الدخول إلى السحابة الإلكترونية.

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

بعد أن أصبح بإمكان المستخدمين إثبات ملكية حساباتهم باستخدام Firebase، يمكنك التحكّم في إذن وصولهم إلى البيانات في قاعدة بيانات Firebase باستخدام قواعد Firebase.