Xác thực bằng GitHub và C++

Bạn có thể cho phép người dùng xác thực bằng Firebase bằng tài khoản GitHub của họ bằng cách tích hợp xác thực GitHub vào ứng dụng của bạn.

Trước khi bắt đầu

  1. Thêm Firebase vào dự án C++ của bạn .
  2. Trong bảng điều khiển Firebase , hãy mở phần Xác thực .
  3. Trên tab Phương thức đăng nhập , kích hoạt nhà cung cấp GitHub .
  4. Thêm ID khách hàngBí mật khách hàng từ bảng điều khiển dành cho nhà phát triển của nhà cung cấp đó vào cấu hình nhà cung cấp:
    1. Đăng ký ứng dụng của bạn với tư cách là ứng dụng dành cho nhà phát triển trên GitHub và nhận ID ứng dụng khách OAuth 2.0 và Bí mật ứng dụng khách của ứng dụng của bạn.
    2. Đảm bảo URI chuyển hướng Firebase OAuth của bạn (ví dụ: my-app-12345.firebaseapp.com/__/auth/handler ) được đặt làm URL gọi lại Ủy quyền trong trang cài đặt ứng dụng của bạn trên config của ứng dụng GitHub .
  5. Nhấp vào để lưu .

Truy cập lớp firebase::auth::Auth

Lớp Auth là cổng cho tất cả lệnh gọi API.
  1. Thêm tệp tiêu đề Xác thực và Ứng dụng:
    #include "firebase/app.h"
    #include "firebase/auth.h"
    
  2. Trong mã khởi tạo 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__)
    
  3. Có được lớp firebase::auth::Auth cho firebase::App của bạn. Có ánh xạ một-một giữa AppAuth .
    firebase::auth::Auth* auth = firebase::auth::Auth::GetAuth(app);
    

Xác thực với Firebase

  1. Làm theo hướng dẫn dành cho AndroidiOS+ để nhận mã thông báo cho người dùng GitHub đã đăng nhập.
  2. Sau khi người dùng đăng nhập thành công, hãy đổi mã thông báo lấy thông tin xác thực Firebase và xác thực với Firebase bằng thông tin xác thực Firebase:
    firebase::auth::Credential credential =
        firebase::auth::GitHubAuthProvider::GetCredential(token);
    firebase::Future<firebase::auth::AuthResult> result =
        auth->SignInAndRetrieveDataWithCredential(credential);
    
  3. 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 (giả sử ở tốc độ 30 hoặc 60 lần 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::SignInAndRetrieveDataWithCredentialLastResult :
    firebase::Future<firebase::auth::AuthResult> result =
        auth->SignInAndRetrieveDataWithCredentialLastResult();
    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 được điều khiển theo sự kiện, bạn có thể thích để đăng ký cuộc gọi lại trên Future .

Đăng ký cuộc gọi lại trên Tương lai

Một số chương trình có chức năng Update được gọi là 30 hoặc 60 lần mỗi giây. Ví dụ, nhiều trò chơi theo mô hình này. Các chương trình này có thể gọi hàm LastResult để thăm dò các cuộc gọi không đồng bộ. Tuy nhiên, nếu chương trình của bạn hướng đến sự kiện, bạn có thể muốn đăng ký các hàm gọi lại. Hàm gọi lại được gọi sau khi hoàn thành Tương lai.
void OnCreateCallback(const firebase::Future<firebase::auth::User*>& result,
                      void* user_data) {
  // The callback is called when the Future enters the `complete` state.
  assert(result.status() == firebase::kFutureStatusComplete);

  // Use `user_data` to pass-in program context, if you like.
  MyProgramContext* program_context = static_cast<MyProgramContext*>(user_data);

  // Important to handle both success and failure situations.
  if (result.error() == firebase::auth::kAuthErrorNone) {
    firebase::auth::User* user = *result.result();
    printf("Create user succeeded for email %s\n", user->email().c_str());

    // Perform other actions on User, if you like.
    firebase::auth::User::UserProfile profile;
    profile.display_name = program_context->display_name;
    user->UpdateUserProfile(profile);

  } else {
    printf("Created user failed with error '%s'\n", result.error_message());
  }
}

void CreateUser(firebase::auth::Auth* auth) {
  // Callbacks work the same for any firebase::Future.
  firebase::Future<firebase::auth::AuthResult> result =
      auth->CreateUserWithEmailAndPasswordLastResult();

  // `&my_program_context` is passed verbatim to OnCreateCallback().
  result.OnCompletion(OnCreateCallback, &my_program_context);
}
Hàm gọi lại cũng có thể là lambda, nếu bạn thích.
void CreateUserUsingLambda(firebase::auth::Auth* auth) {
  // Callbacks work the same for any firebase::Future.
  firebase::Future<firebase::auth::AuthResult> result =
      auth->CreateUserWithEmailAndPasswordLastResult();

  // The lambda has the same signature as the callback function.
  result.OnCompletion(
      [](const firebase::Future<firebase::auth::User*>& result,
         void* user_data) {
        // `user_data` is the same as &my_program_context, below.
        // Note that we can't capture this value in the [] because std::function
        // is not supported by our minimum compiler spec (which is pre C++11).
        MyProgramContext* program_context =
            static_cast<MyProgramContext*>(user_data);

        // Process create user result...
        (void)program_context;
      },
      &my_program_context);
}

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à liên kết với thông tin xác thực—tức là tên người dùng và mật khẩu, số điện thoại hoặc thông tin nhà cung cấp dịch vụ xác thực—mà người dùng đã đăng nhập. Tài khoản mới này được lưu trữ như một phần của dự án Firebase của bạn và có thể được sử dụng để xác định 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 Quy tắc bảo mật cơ sở dữ liệu thời gian thực và lưu trữ đám mây của Firebase, bạn có thể lấy ID người dùng duy nhất của người dùng đã đăng nhập từ biến auth và sử dụng nó để kiểm soát dữ liệu nào 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 nhà cung cấp xác thực bằng cách liên kết thông tin xác thực của nhà cung cấp xác thực với tài khoản người dùng hiện có.

Để đăng xuất người dùng, hãy gọi SignOut() :

auth->SignOut();