Twitter ও C++ ব্যবহার করে যাচাইকরণ

আপনার অ্যাপে Twitter যাচাইকরণ ইন্টিগ্রেট করে, আপনার ব্যবহারকারীদের Twitter অ্যাকাউন্ট ব্যবহার করে Firebase-এর মাধ্যমে যাচাই করিয়ে নিতে পারবেন।

শুরু করার আগে

  1. আপনার C++ প্রোজেক্টে Firebase যোগ করুন।
  2. Firebase কনসোলে গিয়ে নিরাপত্তা > যাচাইকরণ বিকল্পে যান।
  3. সাইন-ইন পদ্ধতি ট্যাবে, Twitter সাইন-ইন প্রদানকারী চালু করুন।
  4. প্রোভাইডার কনফিগারেশনে সেই প্রোভাইডারের ডেভেলপার কনসোল থেকে API কী ও API সিক্রেট যোগ করুন:
    1. Twitter-এ ডেভেলপার অ্যাপ্লিকেশন হিসেবে আপনার অ্যাপ রেজিস্টার করুন এবং আপনার অ্যাপের OAuth API কী ও API সিক্রেট পান।
    2. আপনার Firebase OAuth রিডাইরেক্ট URI (যেমন, my-app-12345.firebaseapp.com/__/auth/handler) আপনার অ্যাপের সেটিংস পৃষ্ঠায় আপনার Twitter অ্যাপের কনফিগারেশনে অনুমোদন কলব্যাক URL হিসেবে সেট করা আছে কিনা তা ভালো করে দেখে নিন।
  5. সেভ করুন বিকল্পে ক্লিক করুন।

firebase::auth::Auth ক্লাসে অ্যাক্সেস করা

Auth ক্লাস হল সব API কলের গেটওয়ে।
  1. Auth ও App হেডার ফাইল যোগ করুন:
    #include <cassert>
    #include <cstdint>
    
    #include "firebase/app.h"
    #include "firebase/auth.h"
  2. আপনার ইনিশিয়ালাইজেশন কোডে, একটি 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. আপনার firebase::App-এর জন্য firebase::auth::Auth ক্লাস পান। App ও Auth-এর মধ্যে এক-এক ম্যাপিং আছে।
    firebase::auth::Auth* auth = firebase::auth::Auth::GetAuth(app);

Firebase-এর মাধ্যমে যাচাইকরণ

  1. OAuth অ্যাক্সেস টোকেন ও OAuth সিক্রেট পেতে Twitter-এর মাধ্যমে সাইন-ইন করুন ডকুমেন্টেশন ফলো করুন।
  2. ব্যবহারকারী সফলভাবে সাইন-ইন করার পরে, Firebase ক্রেডেনশিয়ালের জন্য টোকেন ও সিক্রেট এক্সচেঞ্জ করুন এবং Firebase ক্রেডেনশিয়াল ব্যবহার করে Firebase-এর সাথে যাচাই করুন:
    firebase::auth::Credential credential =
        firebase::auth::TwitterAuthProvider::GetCredential(token, secret);
    firebase::Future<firebase::auth::AuthResult> result =
        auth->SignInAndRetrieveDataWithCredential(credential);
  3. আপনার প্রোগ্রামে যদি নিয়মিত আপডেট লুপ চলে (যেমন, প্রতি সেকেন্ডে ৩০ বা ৬০ বার), তাহলে আপনি 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());
      }
    }
    অথবা, আপনার প্রোগ্রাম ইভেন্ট-নির্ভর হলে, আপনি Future-এ কলব্যাক রেজিস্টার করতে পারেন।

Future-এ কলব্যাক রেজিস্টার করা

কিছু প্রোগ্রামে Update ফাংশন আছে যা প্রতি সেকেন্ডে ৩০ বা ৬০ বার কল করা হয়। যেমন, অনেক গেম এই মডেল অনুসরণ করে। অ্যাসিঙ্ক্রোনাস কল পোল করার জন্য এইসব প্রোগ্রাম LastResult ফাংশন কল করতে পারে। তবে, আপনার প্রোগ্রাম ইভেন্ট-নির্ভর হলে, আপনি কলব্যাক ফাংশন রেজিস্টার করতে পারেন। Future সম্পূর্ণ হলে কলব্যাক ফাংশন কল করা হয়।
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);
}
আপনি চাইলে কলব্যাক ফাংশন ল্যামডা হিসেবেও ব্যবহার করতে পারেন।
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);
}

পরবর্তী ধাপ

কোনও ব্যবহারকারী প্রথমবার সাইন-ইন করার পরে, একটি নতুন ব্যবহারকারীর অ্যাকাউন্ট তৈরি করা হয় এবং ক্রেডেনশিয়ালের সাথে লিঙ্ক করা হয়—অর্থাৎ, ব্যবহারকারীর নাম এবং পাসওয়ার্ড, ফোন নম্বর বা ব্যবহারকারী যে তথ্য দিয়ে সাইন-ইন করেছেন তা প্রদানকারীর তথ্য। এই নতুন অ্যাকাউন্ট আপনার Firebase প্রোজেক্টের অংশ হিসেবে স্টোর করা হয় এবং ব্যবহারকারী কীভাবে সাইন-ইন করেছেন তা নির্বিশেষে, আপনার প্রোজেক্টের প্রতিটি অ্যাপ জুড়ে কোনও ব্যবহারকারীকে শনাক্ত করতে ব্যবহার করা যেতে পারে।

  • আপনার অ্যাপে, আপনি 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();
    }
  • আপনার Firebase Realtime Database এবং Cloud Storage নিরাপত্তা বিধিতে, আপনি auth ভেরিয়েবল থেকে সাইন-ইন করা ব্যবহারকারীর অনন্য ব্যবহারকারী আইডি পেতে এবং ব্যবহারকারী কোন ডেটা অ্যাক্সেস করতে পারবেন তা নিয়ন্ত্রণ করতে এটি ব্যবহার করতে পারবেন।

আপনি আগে থেকে থাকা ব্যবহারকারীর অ্যাকাউন্টের সাথে অনুমোদন প্রদানকারীর ক্রেডেনশিয়াল লিঙ্ক করে একাধিক অনুমোদন প্রদানকারীর মাধ্যমে আপনার অ্যাপে সাইন-ইন করার জন্য ব্যবহারকারীদের অনুমতি দিতে পারেন।

কোনও ব্যবহারকারীকে সাইন-আউট করতে, SignOut()-এ কল করুন:

auth->SignOut();