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