إدارة المستخدمين في Firebase

إنشاء مستخدم

يمكنك إنشاء مستخدِم جديد في مشروع Firebase من خلال استدعاء CreateUserWithEmailAndPassword أو من خلال تسجيل دخول المستخدم لأول مرة باستخدام هوية موحدة مثل تسجيل الدخول باستخدام حساب Google تسجيل الدخول إلى Facebook.

يمكنك أيضًا إنشاء مستخدمين جدد تمت مصادقتهم بكلمة المرور من خلال صفحة قسم وحدة تحكم Firebase في صفحة "المستخدمون".

الحصول على المستخدم المُسجِّل الدخول حاليًا

الطريقة الموصى بها للوصول إلى المستخدم الحالي هي ضبط مستمع على عنصر المصادقة:

class MyAuthStateListener : public firebase::auth::AuthStateListener {
 public:
  void OnAuthStateChanged(firebase::auth::Auth* auth) override {
    firebase::auth::User user = auth->current_user();
    if (user.is_valid()) {
      // User is signed in
      printf("OnAuthStateChanged: signed_in %s\n", user.uid().c_str());
    } else {
      // User is signed out
      printf("OnAuthStateChanged: signed_out\n");
    }
    // ...
  }
};
// ... initialization code
// Test notification on registration.
MyAuthStateListener state_change_listener;
auth->AddAuthStateListener(&state_change_listener);

بالاستعانة بأداة استماع، فإنك تضمن أن كائن المصادقة ليس في وسيط الحالة - مثل التهيئة - عندما تحصل على المستخدم الحالي.

يمكنك أيضًا الحصول على المستخدم المُسجِّل الدخول حاليًا من خلال الاتصال بالرقم current_user. إذا لم يسجّل المستخدم الدخول، ستعرض طريقة is_valid للمستخدم القيمة "false".

الاحتفاظ ببيانات اعتماد المستخدم

سيتم تخزين بيانات اعتماد المستخدم في مخزن المفاتيح المحلي بعدما تم تسجيل الدخول إليه. يمكن حذف ذاكرة التخزين المؤقت المحلية لبيانات اعتماد المستخدم من خلال التوقيع المستخدم. ملف تخزين المفاتيح مخصص للنظام الأساسي:

• منصات Apple: خدمات سلسلة المفاتيح
• Android: ملف تخزين مفاتيح Android
• نظام التشغيل Windows: واجهة برمجة التطبيقات لإدارة بيانات الاعتماد
• OS X: خدمات سلسلة المفاتيح.
• نظام التشغيل Linux: libsecret، والذي يجب أن يكون المستخدم قد ثبَّته

الحصول على ملف شخصي للمستخدم

للحصول على معلومات الملف الشخصي لأحد المستخدمين، استخدم طرق الموصّل لمثيل firebase::auth::User على سبيل المثال:

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();
}

الحصول على معلومات الملف الشخصي الخاصة بمقدّم خدمة المستخدِم

لاسترداد معلومات الملف الشخصي من مقدّمي الخدمات الذين يستخدمون تسجيل الدخول المرتبطين بخدمة للمستخدم، يُرجى استخدام الطريقة ProviderData. على سبيل المثال:

firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
  for (auto it = user.provider_data().begin();
       it != user.provider_data().end(); ++it) {
    firebase::auth::UserInfoInterface profile = *it;
    // Id of the provider (ex: google.com)
    std::string providerId = profile.provider_id();

    // UID specific to the provider
    std::string uid = profile.uid();

    // Name, email address, and profile photo Url
    std::string name = profile.display_name();
    std::string email = profile.email();
    std::string photoUrl = profile.photo_url();
  }
}

تعديل الملف الشخصي للمستخدم

يمكنك تعديل معلومات الملف الشخصي الأساسية للمستخدم، مثل الاسم المعروض للمستخدم. وعنوان URL لصورة الملف الشخصي باستخدام الطريقة UpdateUserProfile. على سبيل المثال:

firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
  firebase::auth::User::UserProfile profile;
  profile.display_name = "Jane Q. User";
  profile.photo_url = "https://example.com/jane-q-user/profile.jpg";
  user.UpdateUserProfile(profile).OnCompletion(
      [](const firebase::Future<void>& completed_future, void* user_data) {
        // We are probably in a different thread right now.
        if (completed_future.error() == 0) {
          printf("User profile updated.");
        }
      },
      nullptr);  // pass user_data here.
}

ضبط عنوان البريد الإلكتروني للمستخدم

يمكنك ضبط عنوان البريد الإلكتروني للمستخدم باستخدام الطريقة UpdateEmail. على سبيل المثال:

firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
  user.UpdateEmail("user@example.com")
      .OnCompletion(
          [](const firebase::Future<void>& completed_future,
             void* user_data) {
            // We are probably in a different thread right now.
            if (completed_future.error() == 0) {
              printf("User email address updated.");
            }
          },
          nullptr);
}

إرسال رسالة تحقق إلى المستخدم

يمكنك إرسال رسالة إلكترونية لإثبات صحة العنوان إلى مستخدم لديه طريقة SendEmailVerification. على سبيل المثال:

firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
  user.SendEmailVerification().OnCompletion(
      [](const firebase::Future<void>& completed_future, void* user_data) {
        // We are probably in a different thread right now.
        if (completed_future.error() == 0) {
          printf("Email sent.");
        }
      },
      nullptr);
}

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

ضبط كلمة مرور مستخدم

يمكنك ضبط كلمة مرور المستخدم باستخدام الطريقة UpdatePassword. على سبيل المثال:

firebase::auth::User user = auth->current_user();
std::string newPassword = "SOME-SECURE-PASSWORD";

if (user.is_valid()) {
  user.UpdatePassword(newPassword.c_str())
      .OnCompletion(
          [](const firebase::Future<void>& completed_future,
             void* user_data) {
            // We are probably in a different thread right now.
            if (completed_future.error() == 0) {
              printf("password updated.");
            }
          },
          nullptr);
}

إرسال رسالة إلكترونية لإعادة ضبط كلمة المرور

يمكنك إرسال رسالة إلكترونية لإعادة ضبط كلمة المرور إلى مستخدم باستخدام SendPasswordResetEmail . على سبيل المثال:

std::string emailAddress = "user@example.com";

auth->SendPasswordResetEmail(emailAddress.c_str())
    .OnCompletion(
        [](const firebase::Future<void>& completed_future,
           void* user_data) {
          // We are probably in a different thread right now.
          if (completed_future.error() == 0) {
            // Email sent.
          } else {
            // An error happened.
            printf("Error %d: %s", completed_future.error(),
                   completed_future.error_message());
          }
        },
        nullptr);

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

يمكنك أيضًا إرسال رسائل إلكترونية لإعادة ضبط كلمة المرور من وحدة تحكُّم Firebase.

حذف مستخدم

يمكنك حذف حساب مستخدم من خلال الطريقة Delete. على سبيل المثال:

firebase::auth::User user = auth->current_user();
if (user.is_valid()) {
  user.Delete().OnCompletion(
      [](const firebase::Future<void>& completed_future, void* user_data) {
        if (completed_future.error() == 0) {
          // User deleted.
        } else {
          // An error happened.
          printf("Error %d: %s", completed_future.error(),
                 completed_future.error_message());
        }
      },
      nullptr);
}

يمكنك أيضًا حذف المستخدمين من قسم المصادقة في وحدة تحكم Firebase في صفحة "المستخدمون".

إعادة مصادقة مستخدم

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

عند حدوث ذلك، عليك إعادة مصادقة المستخدم من خلال الحصول على بيانات اعتماد تسجيل دخول جديدة. من المستخدم وتمرير بيانات الاعتماد إلى Reauthenticate. على سبيل المثال:

firebase::auth::User user = auth->current_user();

// Get auth credentials from the user for re-authentication. The example
// below shows email and password credentials but there are multiple
// possible providers, such as GoogleAuthProvider or FacebookAuthProvider.
firebase::auth::Credential credential =
    firebase::auth::EmailAuthProvider::GetCredential("user@example.com",
                                                     "password1234");

if (user.is_valid()) {
  user.Reauthenticate(credential)
      .OnCompletion(
          [](const firebase::Future<void>& completed_future,
             void* user_data) {
            if (completed_future.error() == 0) {
              printf("User re-authenticated.");
            }
          },
          nullptr);
}

استيراد حسابات المستخدمين

يمكنك استيراد حسابات المستخدمين من ملف إلى مشروعك على Firebase باستخدام الأمر auth:import في واجهة سطر الأوامر في Firebase. على سبيل المثال:

firebase auth:import users.json --hash-algo=scrypt --rounds=8 --mem-cost=14