Catch up on everthing we announced at this year's Firebase Summit. Learn more

Quản lý người dùng trong Firebase

Tạo người dùng

Bạn tạo một người dùng mới trong dự án căn cứ hỏa lực của bạn bằng cách gọi CreateUserWithEmailAndPassword phương pháp hoặc bằng cách đăng nhập người dùng lần đầu tiên sử dụng một nhà cung cấp danh tính liên kết, chẳng hạn như Google đăng nhập hoặc Facebook Login .

Bạn cũng có thể tạo người dùng mật khẩu xác thực mới từ phần xác thực của các căn cứ hỏa lực console , trên trang Users.

Nhận người dùng hiện đã đăng nhập

Cách được đề xuất để có được người dùng hiện tại là bằng cách thiết lập trình lắng nghe trên đối tượng Auth:

class MyAuthStateListener : public firebase::auth::AuthStateListener {
 public:
  void OnAuthStateChanged(firebase::auth::Auth* auth) override {
    firebase::auth::User* user = auth->current_user();
    if (user != nullptr) {
      // 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);

Bằng cách sử dụng trình lắng nghe, bạn đảm bảo rằng đối tượng Auth không ở trạng thái trung gian — chẳng hạn như khởi tạo — khi bạn có được người dùng hiện tại.

Bạn cũng có thể nhận được hiện nay người dùng đăng nhập bằng cách gọi current_user . Nếu người dùng không đăng nhập, current_user lợi nhuận nullptr.

Duy trì thông tin đăng nhập của người dùng

Thông tin đăng nhập của người dùng sẽ được lưu trữ trong kho khóa cục bộ sau khi người dùng đăng nhập. Bộ nhớ cache cục bộ của thông tin đăng nhập người dùng có thể bị xóa bằng cách đăng xuất người dùng. Kho khóa dành riêng cho nền tảng:

Nhận hồ sơ của người dùng

Để có được thông tin hồ sơ của người dùng, sử dụng các phương pháp accessor của một thể hiện của firebase::auth::User . Ví dụ:

firebase::auth::User* user = auth->current_user();
if (user != nullptr) {
  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();
}

Nhận thông tin hồ sơ nhà cung cấp cụ thể của người dùng

Để có được thông tin hồ sơ lấy ra từ lần đăng nhập các nhà cung cấp liên quan đến một người sử dụng, sử dụng ProviderData phương pháp. Ví dụ:

firebase::auth::User* user = auth->current_user();
if (user != nullptr) {
  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();
  }
}

Cập nhật hồ sơ của người dùng

Bạn có thể cập nhật URL với tên hiển thị và ảnh hồ sơ của người dùng thông tin hồ sơ cá nhân cơ bản của người sử dụng các UpdateUserProfile phương pháp. Ví dụ:

firebase::auth::User* user = auth->current_user();
if (user != nullptr) {
  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.
}

Đặt địa chỉ email của người dùng

Bạn có thể đặt địa chỉ email của người dùng với các UpdateEmail phương pháp. Ví dụ:

firebase::auth::User* user = auth->current_user();
if (user != nullptr) {
  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);
}

Gửi cho người dùng một email xác minh

Bạn có thể gửi một email xác minh địa chỉ cho một người dùng với SendEmailVerification phương pháp. Ví dụ:

firebase::auth::User* user = auth->current_user();
if (user != nullptr) {
  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);
}

Bạn có thể tùy chỉnh các mẫu email được sử dụng trong phần xác thực của các căn cứ hỏa lực console , trên Email trang mẫu. Xem Templates Email trong Trung tâm trợ giúp căn cứ hỏa lực.

Đặt mật khẩu của người dùng

Bạn có thể đặt mật khẩu của người dùng với các UpdatePassword phương pháp. Ví dụ:

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

if (user != nullptr) {
  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);
}

Gửi email đặt lại mật khẩu

Bạn có thể gửi một email khôi phục mật khẩu cho một người dùng với SendPasswordResetEmail phương pháp. Ví dụ:

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

Bạn có thể tùy chỉnh các mẫu email được sử dụng trong phần xác thực của các căn cứ hỏa lực console , trên Email trang mẫu. Xem Templates Email trong Trung tâm trợ giúp căn cứ hỏa lực.

Bạn cũng có thể gửi email đặt lại mật khẩu từ bảng điều khiển Firebase.

Xóa người dùng

Bạn có thể xóa một tài khoản người dùng với Delete phương pháp. Ví dụ:

firebase::auth::User* user = auth->current_user();
if (user != nullptr) {
  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);
}

Bạn cũng có thể sử dụng xóa từ phần xác thực của các căn cứ hỏa lực console , trên trang Users.

Xác thực lại người dùng

Một số hành động chẳng hạn an ninh nhạy cảm như xóa tài khoản , thiết lập một địa chỉ email chính , và thay đổi mật khẩu -require mà người dùng vừa đăng nhập. Nếu bạn thực hiện một trong những hành động này, và người sử dụng đăng nhập quá lâu trước, hành động không thành công.

Khi điều này xảy ra, tái xác thực người dùng bằng cách đăng nhập mới thông tin từ người sử dụng và đi qua các chứng chỉ để Reauthenticate . Ví dụ:

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

Nhập tài khoản người dùng

Bạn có thể nhập tài khoản người dùng từ một tập tin vào dự án căn cứ hỏa lực của bạn bằng cách sử dụng các căn cứ hỏa lực CLI của auth:import lệnh. Ví dụ:

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