Xác thực bằng Firebase bằng Hệ thống xác thực tuỳ chỉnh và C++
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Bạn có thể tích hợp Firebase Authentication với một hệ thống xác thực tuỳ chỉnh bằng cách
sửa đổi máy chủ xác thực của mình để tạo mã thông báo tuỳ chỉnh đã ký khi người dùng
đăng nhập thành công. Ứng dụng của bạn sẽ nhận được mã thông báo này và dùng mã đó để xác thực
với Firebase.
Trước khi bắt đầu
- Thêm Firebase vào C++ của bạn
dự án.
- Lấy khoá máy chủ của dự án:
- Chuyển đến phần Tài khoản dịch vụ
trong phần cài đặt của dự án.
- Nhấp vào Tạo khoá riêng tư mới ở cuối
Mục SDK quản trị của Firebase trên trang Tài khoản dịch vụ.
- Cặp khoá công khai/riêng tư của tài khoản dịch vụ mới sẽ tự động
đã lưu trên máy tính của bạn. Sao chép tệp này vào máy chủ xác thực của bạn.
Xác thực bằng Firebase
Lớp
Auth
là cổng vào cho tất cả lệnh gọi API.
- Thêm tệp tiêu đề Ứng dụng và Xác thực:
#include "firebase/app.h"
#include "firebase/auth.h"
- Trong mã khởi chạy của bạn, hãy tạo một
Lớp
firebase::App
.
#if defined(__ANDROID__)
firebase::App* app =
firebase::App::Create(firebase::AppOptions(), my_jni_env, my_activity);
#else
firebase::App* app = firebase::App::Create(firebase::AppOptions());
#endif // defined(__ANDROID__)
- Mua lớp
firebase::auth::Auth
cho firebase::App
của bạn.
Có một mối liên kết một với một giữa App
và Auth
.
firebase::auth::Auth* auth = firebase::auth::Auth::GetAuth(app);
Gọi
Auth::SignInWithCustomToken
bằng mã thông báo từ máy chủ xác thực của bạn.
- Khi người dùng đăng nhập vào ứng dụng của bạn, hãy gửi thông tin đăng nhập của họ (cho
tên người dùng và mật khẩu) vào máy chủ xác thực của bạn. Thông tin
máy chủ kiểm tra thông tin xác thực và trả về một
mã thông báo tuỳ chỉnh
nếu hợp lệ.
- Sau khi bạn nhận được mã thông báo tuỳ chỉnh từ máy chủ xác thực, hãy chuyển
truy cập vào
Auth::SignInWithCustomToken
để đăng nhập vào tài khoản của người dùng:
firebase::Future<firebase::auth::AuthResult> result =
auth->SignInWithCustomToken(custom_token);
- Nếu chương trình của bạn có vòng lặp cập nhật chạy thường xuyên (chẳng hạn như ở mức 30 hoặc 60
thời gian mỗi giây), bạn có thể kiểm tra kết quả một lần mỗi lần cập nhật bằng
Auth::SignInWithCustomTokenLastResult
:
firebase::Future<firebase::auth::AuthResult> result =
auth->SignInWithCustomTokenLastResult();
if (result.status() == firebase::kFutureStatusComplete) {
if (result.error() == firebase::auth::kAuthErrorNone) {
firebase::auth::AuthResult auth_result = *result.result();
printf("Sign in succeeded for `%s`\n",
auth_result.user.display_name().c_str());
} else {
printf("Sign in failed with error '%s'\n", result.error_message());
}
}
Hoặc nếu chương trình của bạn hướng đến sự kiện, bạn có thể thích
đăng ký gọi lại trên
Tương lai.
Các bước tiếp theo
Sau khi người dùng đăng nhập lần đầu tiên, một tài khoản người dùng mới sẽ được tạo và
được liên kết với thông tin đăng nhập—tức là tên người dùng và mật khẩu, số điện thoại
số hoặc thông tin của nhà cung cấp dịch vụ xác thực – người dùng đã đăng nhập. Thông tin mới này
được lưu trữ như một phần của dự án Firebase và có thể được dùng để xác định
một người dùng trên mọi ứng dụng trong dự án của bạn, bất kể người dùng đăng nhập bằng cách nào.
-
Trong ứng dụng của mình, bạn có thể lấy thông tin hồ sơ cơ bản của người dùng từ
Đối tượng 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();
}
Trong Firebase Realtime Database và Cloud Storage của bạn
Quy tắc bảo mật, bạn có thể
lấy mã nhận dạng người dùng duy nhất của người dùng đã đăng nhập từ biến auth
,
để kiểm soát loại dữ liệu mà người dùng có thể truy cập.
Bạn có thể cho phép người dùng đăng nhập vào ứng dụng của mình bằng nhiều phương thức xác thực
bằng cách liên kết thông tin đăng nhập của nhà cung cấp dịch vụ xác thực với
tài khoản người dùng hiện có.
Để đăng xuất một người dùng, hãy gọi
SignOut()
:
auth->SignOut();
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-16 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-16 UTC."],[],[],null,["# Authenticate with Firebase Using a Custom Authentication System and C++\n\nYou can integrate Firebase Authentication with a custom authentication system by\nmodifying your authentication server to produce custom signed tokens when a user\nsuccessfully signs in. Your app receives this token and uses it to authenticate\nwith Firebase.\n\nBefore you begin\n----------------\n\n1. [Add Firebase to your C++\n project](/docs/cpp/setup#note_select_platform).\n2. Get your project's server keys:\n 1. Go to the [Service Accounts](https://console.firebase.google.com/project/_/settings/serviceaccounts/adminsdk) page in your project's settings.\n 2. Click *Generate New Private Key* at the bottom of the *Firebase Admin SDK* section of the *Service Accounts* page.\n 3. The new service account's public/private key pair is automatically saved on your computer. Copy this file to your authentication server.\n\nAuthenticate with Firebase\n--------------------------\n\nThe `Auth` class is the gateway for all API calls.\n\n1. Add the Auth and App header files: \n\n ```c++\n #include \"firebase/app.h\"\n #include \"firebase/auth.h\"\n ```\n2. In your initialization code, create a [`firebase::App`](/docs/reference/cpp/class/firebase/app) class. \n\n ```c++\n #if defined(__ANDROID__)\n firebase::App* app =\n firebase::App::Create(firebase::AppOptions(), my_jni_env, my_activity);\n #else\n firebase::App* app = firebase::App::Create(firebase::AppOptions());\n #endif // defined(__ANDROID__)\n ```\n3. Acquire the `firebase::auth::Auth` class for your `firebase::App`. There is a one-to-one mapping between `App` and `Auth`. \n\n ```c++\n firebase::auth::Auth* auth = firebase::auth::Auth::GetAuth(app);\n ```\n\nCall `Auth::SignInWithCustomToken` with the token from your authentication server.\n\n1. When users sign in to your app, send their sign-in credentials (for example, their username and password) to your authentication server. Your server checks the credentials and returns a [custom token](/docs/auth/admin/create-custom-tokens) if they are valid.\n2. After you receive the custom token from your authentication server, pass it to `Auth::SignInWithCustomToken` to sign in the user: \n\n ```c++\n firebase::Future\u003cfirebase::auth::AuthResult\u003e result =\n auth-\u003eSignInWithCustomToken(custom_token);\n ```\n3. If your program has an update loop that runs regularly (say at 30 or 60 times per second), you can check the results once per update with `Auth::SignInWithCustomTokenLastResult`: \n\n ```c++\n firebase::Future\u003cfirebase::auth::AuthResult\u003e result =\n auth-\u003eSignInWithCustomTokenLastResult();\n if (result.status() == firebase::kFutureStatusComplete) {\n if (result.error() == firebase::auth::kAuthErrorNone) {\n firebase::auth::AuthResult auth_result = *result.result();\n printf(\"Sign in succeeded for `%s`\\n\",\n auth_result.user.display_name().c_str());\n } else {\n printf(\"Sign in failed with error '%s'\\n\", result.error_message());\n }\n }\n ```\n Or, if your program is event driven, you may prefer to [register a callback on the\n Future](#register_callback_on_future).\n\nNext steps\n----------\n\nAfter a user signs in for the first time, a new user account is created and\nlinked to the credentials---that is, the user name and password, phone\nnumber, or auth provider information---the user signed in with. This new\naccount is stored as part of your Firebase project, and can be used to identify\na user across every app in your project, regardless of how the user signs in.\n\n- In your apps, you can get the user's basic profile information from the\n [`firebase::auth::User`](/docs/reference/cpp/class/firebase/auth/user) object:\n\n ```c++\n firebase::auth::User user = auth-\u003ecurrent_user();\n if (user.is_valid()) {\n std::string name = user.display_name();\n std::string email = user.email();\n std::string photo_url = user.photo_url();\n // The user's ID, unique to the Firebase project.\n // Do NOT use this value to authenticate with your backend server,\n // if you have one. Use firebase::auth::User::Token() instead.\n std::string uid = user.uid();\n }\n ```\n- In your Firebase Realtime Database and Cloud Storage\n [Security Rules](/docs/database/security/user-security), you can\n get the signed-in user's unique user ID from the `auth` variable,\n and use it to control what data a user can access.\n\nYou can allow users to sign in to your app using multiple authentication\nproviders by [linking auth provider credentials to an\nexisting user account.](/docs/auth/cpp/account-linking)\n\nTo sign out a user, call [`SignOut()`](/docs/reference/cpp/class/firebase/auth/auth#signout): \n\n```c++\nauth-\u003eSignOut();\n```"]]