قم بإنشاء مستخدم
يمكنك إنشاء مستخدم جديد في مشروع Firebase الخاص بك عن طريق استدعاء طريقة createUserWithEmailAndPassword
أو عن طريق تسجيل دخول مستخدم لأول مرة باستخدام موفر هوية متحد ، مثل تسجيل الدخول إلى Google أو تسجيل الدخول إلى Facebook .
يمكنك أيضًا إنشاء مستخدمين جدد مصادق عليهم بكلمة مرور من قسم المصادقة في وحدة تحكم Firebase في صفحة المستخدمين.
احصل على المستخدم المسجل حاليًا
الطريقة الموصى بها للحصول على المستخدم الحالي هي من خلال استدعاء طريقة getCurrentUser
. إذا لم يتم تسجيل دخول أي مستخدم ، فإن getCurrentUser
ترجع قيمة خالية:
Java
FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser(); if (user != null) { // User is signed in } else { // No user is signed in }
Kotlin+KTX
val user = Firebase.auth.currentUser if (user != null) { // User is signed in } else { // No user is signed in }
هناك بعض الحالات التي يقوم فيها getCurrentUser
بإرجاع FirebaseUser
غير فارغ ولكن الرمز الأساسي غير صالح. يمكن أن يحدث هذا ، على سبيل المثال ، إذا تم حذف المستخدم من جهاز آخر ولم يتم تحديث الرمز المميز المحلي. في هذه الحالة ، قد تحصل على مستخدم صالح getCurrentUser
ولكن ستفشل المكالمات اللاحقة للموارد المصادقة.
قد getCurrentUser
أيضًا قيمة null
لأن كائن المصادقة لم ينته من التهيئة.
إذا قمت بإرفاق AuthStateListener ، فسوف تحصل على رد اتصال في كل مرة تتغير فيها حالة الرمز الأساسي. يمكن أن يكون هذا مفيدًا للرد على حالات الحافة مثل تلك المذكورة أعلاه.
احصل على ملف تعريف المستخدم
للحصول على معلومات ملف تعريف المستخدم ، استخدم طرق الموصل لمثيل FirebaseUser
. علي سبيل المثال:
Java
FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser(); if (user != null) { // Name, email address, and profile photo Url String name = user.getDisplayName(); String email = user.getEmail(); Uri photoUrl = user.getPhotoUrl(); // Check if user's email is verified boolean emailVerified = user.isEmailVerified(); // 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 // FirebaseUser.getIdToken() instead. String uid = user.getUid(); }
Kotlin+KTX
val user = Firebase.auth.currentUser user?.let { // Name, email address, and profile photo Url val name = user.displayName val email = user.email val photoUrl = user.photoUrl // Check if user's email is verified val emailVerified = user.isEmailVerified // 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 // FirebaseUser.getToken() instead. val uid = user.uid }
احصل على معلومات ملف التعريف الخاصة بموفر المستخدم
للحصول على معلومات الملف الشخصي التي يتم استردادها من موفري تسجيل الدخول المرتبطين بمستخدم ، استخدم طريقة getProviderData
. علي سبيل المثال:
Java
FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser(); if (user != null) { for (UserInfo profile : user.getProviderData()) { // Id of the provider (ex: google.com) String providerId = profile.getProviderId(); // UID specific to the provider String uid = profile.getUid(); // Name, email address, and profile photo Url String name = profile.getDisplayName(); String email = profile.getEmail(); Uri photoUrl = profile.getPhotoUrl(); } }
Kotlin+KTX
val user = Firebase.auth.currentUser user?.let { for (profile in it.providerData) { // Id of the provider (ex: google.com) val providerId = profile.providerId // UID specific to the provider val uid = profile.uid // Name, email address, and profile photo Url val name = profile.displayName val email = profile.email val photoUrl = profile.photoUrl } }
تحديث ملف تعريف المستخدم
يمكنك تحديث معلومات الملف الشخصي الأساسية للمستخدم - اسم العرض للمستخدم وعنوان URL لصورة الملف الشخصي - باستخدام طريقة updateProfile
. علي سبيل المثال:
Java
FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser(); UserProfileChangeRequest profileUpdates = new UserProfileChangeRequest.Builder() .setDisplayName("Jane Q. User") .setPhotoUri(Uri.parse("https://example.com/jane-q-user/profile.jpg")) .build(); user.updateProfile(profileUpdates) .addOnCompleteListener(new OnCompleteListener<Void>() { @Override public void onComplete(@NonNull Task<Void> task) { if (task.isSuccessful()) { Log.d(TAG, "User profile updated."); } } });
Kotlin+KTX
val user = Firebase.auth.currentUser val profileUpdates = userProfileChangeRequest { displayName = "Jane Q. User" photoUri = Uri.parse("https://example.com/jane-q-user/profile.jpg") } user!!.updateProfile(profileUpdates) .addOnCompleteListener { task -> if (task.isSuccessful) { Log.d(TAG, "User profile updated.") } }
حدد عنوان البريد الإلكتروني للمستخدم
يمكنك تعيين عنوان البريد الإلكتروني للمستخدم باستخدام طريقة updateEmail
. علي سبيل المثال:
Java
FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser(); user.updateEmail("user@example.com") .addOnCompleteListener(new OnCompleteListener<Void>() { @Override public void onComplete(@NonNull Task<Void> task) { if (task.isSuccessful()) { Log.d(TAG, "User email address updated."); } } });
Kotlin+KTX
val user = Firebase.auth.currentUser user!!.updateEmail("user@example.com") .addOnCompleteListener { task -> if (task.isSuccessful) { Log.d(TAG, "User email address updated.") } }
إرسال بريد إلكتروني للتحقق للمستخدم
يمكنك إرسال بريد إلكتروني للتحقق من العنوان إلى مستخدم باستخدام طريقة sendEmailVerification
. علي سبيل المثال:
Java
FirebaseAuth auth = FirebaseAuth.getInstance(); FirebaseUser user = auth.getCurrentUser(); user.sendEmailVerification() .addOnCompleteListener(new OnCompleteListener<Void>() { @Override public void onComplete(@NonNull Task<Void> task) { if (task.isSuccessful()) { Log.d(TAG, "Email sent."); } } });
Kotlin+KTX
val user = Firebase.auth.currentUser user!!.sendEmailVerification() .addOnCompleteListener { task -> if (task.isSuccessful) { Log.d(TAG, "Email sent.") } }
يمكنك تخصيص قالب البريد الإلكتروني المستخدم في قسم المصادقة بوحدة تحكم Firebase ، في صفحة قوالب البريد الإلكتروني. راجع قوالب البريد الإلكتروني في مركز مساعدة Firebase.
من الممكن أيضًا تمرير الحالة عبر عنوان URL للمتابعة لإعادة التوجيه مرة أخرى إلى التطبيق عند إرسال بريد إلكتروني للتحقق.
بالإضافة إلى ذلك ، يمكنك ترجمة رسالة التحقق من خلال تحديث رمز اللغة على مثيل المصادقة قبل إرسال البريد الإلكتروني. علي سبيل المثال:
Java
auth.setLanguageCode("fr"); // To apply the default app language instead of explicitly setting it. // auth.useAppLanguage();
Kotlin+KTX
auth.setLanguageCode("fr") // To apply the default app language instead of explicitly setting it. // auth.useAppLanguage()
قم بتعيين كلمة مرور المستخدم
يمكنك تعيين كلمة مرور المستخدم باستخدام طريقة updatePassword
. علي سبيل المثال:
Java
FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser(); String newPassword = "SOME-SECURE-PASSWORD"; user.updatePassword(newPassword) .addOnCompleteListener(new OnCompleteListener<Void>() { @Override public void onComplete(@NonNull Task<Void> task) { if (task.isSuccessful()) { Log.d(TAG, "User password updated."); } } });
Kotlin+KTX
val user = Firebase.auth.currentUser val newPassword = "SOME-SECURE-PASSWORD" user!!.updatePassword(newPassword) .addOnCompleteListener { task -> if (task.isSuccessful) { Log.d(TAG, "User password updated.") } }
إرسال بريد إلكتروني لإعادة تعيين كلمة المرور
يمكنك إرسال بريد إلكتروني لإعادة تعيين كلمة المرور إلى مستخدم باستخدام طريقة sendPasswordResetEmail
. علي سبيل المثال:
Java
FirebaseAuth auth = FirebaseAuth.getInstance(); String emailAddress = "user@example.com"; auth.sendPasswordResetEmail(emailAddress) .addOnCompleteListener(new OnCompleteListener<Void>() { @Override public void onComplete(@NonNull Task<Void> task) { if (task.isSuccessful()) { Log.d(TAG, "Email sent."); } } });
Kotlin+KTX
val emailAddress = "user@example.com" Firebase.auth.sendPasswordResetEmail(emailAddress) .addOnCompleteListener { task -> if (task.isSuccessful) { Log.d(TAG, "Email sent.") } }
يمكنك تخصيص قالب البريد الإلكتروني المستخدم في قسم المصادقة بوحدة تحكم Firebase ، في صفحة قوالب البريد الإلكتروني. راجع قوالب البريد الإلكتروني في مركز مساعدة Firebase.
من الممكن أيضًا تمرير الحالة عبر عنوان URL للمتابعة لإعادة التوجيه مرة أخرى إلى التطبيق عند إرسال بريد إلكتروني لإعادة تعيين كلمة المرور.
بالإضافة إلى ذلك ، يمكنك ترجمة البريد الإلكتروني الخاص بإعادة تعيين كلمة المرور عن طريق تحديث رمز اللغة في مثيل المصادقة قبل إرسال البريد الإلكتروني. علي سبيل المثال:
Java
auth.setLanguageCode("fr"); // To apply the default app language instead of explicitly setting it. // auth.useAppLanguage();
Kotlin+KTX
auth.setLanguageCode("fr") // To apply the default app language instead of explicitly setting it. // auth.useAppLanguage()
يمكنك أيضًا إرسال رسائل بريد إلكتروني لإعادة تعيين كلمة المرور من وحدة تحكم Firebase.
حذف مستخدم
يمكنك حذف حساب مستخدم بطريقة delete
. علي سبيل المثال:
Java
FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser(); user.delete() .addOnCompleteListener(new OnCompleteListener<Void>() { @Override public void onComplete(@NonNull Task<Void> task) { if (task.isSuccessful()) { Log.d(TAG, "User account deleted."); } } });
Kotlin+KTX
val user = Firebase.auth.currentUser!! user.delete() .addOnCompleteListener { task -> if (task.isSuccessful) { Log.d(TAG, "User account deleted.") } }
يمكنك أيضًا حذف المستخدمين من قسم المصادقة بوحدة تحكم Firebase في صفحة المستخدمين.
أعد مصادقة المستخدم
تتطلب بعض الإجراءات الحساسة للأمان - مثل حذف حساب ، وتعيين عنوان بريد إلكتروني أساسي ، وتغيير كلمة مرور - أن يكون المستخدم قد قام بتسجيل الدخول مؤخرًا. إذا قمت بتنفيذ أحد هذه الإجراءات ، وكان المستخدم قد سجل الدخول منذ فترة طويلة جدًا ، فشل الإجراء FirebaseAuthRecentLoginRequiredException
. عند حدوث ذلك ، أعد مصادقة المستخدم عن طريق الحصول على بيانات اعتماد تسجيل دخول جديدة من المستخدم وتمرير بيانات الاعتماد لإعادة reauthenticate
. علي سبيل المثال:
Java
FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser(); // 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. AuthCredential credential = EmailAuthProvider .getCredential("user@example.com", "password1234"); // Prompt the user to re-provide their sign-in credentials user.reauthenticate(credential) .addOnCompleteListener(new OnCompleteListener<Void>() { @Override public void onComplete(@NonNull Task<Void> task) { Log.d(TAG, "User re-authenticated."); } });
Kotlin+KTX
val user = Firebase.auth.currentUser!! // 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. val credential = EmailAuthProvider .getCredential("user@example.com", "password1234") // Prompt the user to re-provide their sign-in credentials user.reauthenticate(credential) .addOnCompleteListener { Log.d(TAG, "User re-authenticated.") }
استيراد حسابات المستخدمين
يمكنك استيراد حسابات المستخدمين من ملف إلى مشروع Firebase الخاص بك باستخدام الأمر auth:import
الخاص بـ Firebase CLI. علي سبيل المثال:
firebase auth:import users.json --hash-algo=scrypt --rounds=8 --mem-cost=14