สร้างผู้ใช้
คุณสร้างผู้ใช้ใหม่ในโครงการ Firebase ของคุณโดยเรียกใช้เมธอด CreateUserWithEmailAndPassword
หรือโดยการลงชื่อเข้าใช้ผู้ใช้เป็นครั้งแรกโดยใช้ผู้ให้บริการข้อมูลประจำตัวแบบรวมศูนย์ เช่น Google Sign-In หรือ Facebook Login
คุณยังสามารถสร้างผู้ใช้ที่ตรวจสอบสิทธิ์ด้วยรหัสผ่านใหม่ได้จากส่วนการตรวจสอบสิทธิ์ของ คอนโซล Firebase ในหน้าผู้ใช้
รับผู้ใช้ที่ลงชื่อเข้าใช้อยู่ในปัจจุบัน
วิธีที่แนะนำในการรับผู้ใช้ปัจจุบันคือการตั้งค่าผู้ฟังบนวัตถุ Auth:
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);
เมื่อใช้ Listener คุณจะมั่นใจได้ว่าวัตถุ Auth ไม่ได้อยู่ในสถานะระดับกลาง เช่น การเริ่มต้น เมื่อคุณได้รับผู้ใช้ปัจจุบัน
คุณยังสามารถรับผู้ใช้ที่ลงชื่อเข้าใช้อยู่ในปัจจุบันได้ด้วยการเรียก current_user
หากผู้ใช้ไม่ได้ลงชื่อเข้าใช้ เมธอด is_valid
ของผู้ใช้จะคืนค่าเป็นเท็จ
ยืนยันข้อมูลประจำตัวของผู้ใช้
ข้อมูลรับรองของผู้ใช้จะถูกจัดเก็บไว้ในที่เก็บคีย์ในเครื่องหลังจากที่ผู้ใช้ลงชื่อเข้าใช้ แคชในเครื่องของข้อมูลรับรองผู้ใช้สามารถลบออกได้โดยการลงชื่อผู้ใช้ออก ที่เก็บคีย์เป็นแพลตฟอร์มเฉพาะ:
- แพลตฟอร์ม Apple: บริการพวงกุญแจ
- Android: ที่เก็บคีย์ Android
- Windows: API การจัดการข้อมูลประจำตัว
- OS X: บริการพวงกุญแจ
- Linux: libsecret ซึ่งผู้ใช้ต้องติดตั้ง
รับโปรไฟล์ของผู้ใช้
ในการรับข้อมูลโปรไฟล์ของผู้ใช้ ให้ใช้เมธอด accessor ของอินสแตนซ์ของ 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 CLI ตัวอย่างเช่น:
firebase auth:import users.json --hash-algo=scrypt --rounds=8 --mem-cost=14