আপনার ব্যবহারকারীদের ইমেল আইডি ও পাসওয়ার্ড ব্যবহার করে Firebase-এর মাধ্যমে প্রমাণিত করতে এবং আপনার অ্যাপের পাসওয়ার্ড-ভিত্তিক অ্যাকাউন্ট ম্যানেজ করতে, আপনি Firebase Authentication ব্যবহার করতে পারবেন।
শুরু করার আগে
- আপনার C++ প্রোজেক্টে Firebase যোগ করুন।
- আপনি এখনও Firebase প্রোজেক্টের সাথে অ্যাপ কানেক্ট না করে থাকলে, Firebase কনসোল থেকে এটি করুন।
-
আপনার Firebase প্রোজেক্টের জন্য সাইন-ইন পরিষেবা প্রদানকারী হিসেবে ইমেল/পাসওয়ার্ড চালু করুন:
- Firebase কনসোলে গিয়ে নিরাপত্তা > যাচাইকরণ বিকল্পে যান।
- সাইন-ইন পদ্ধতি ট্যাবে, ইমেল/পাসওয়ার্ড সাইন-ইন প্রদানকারীকে চালু করুন।
- সেভ করুন বিকল্পে ক্লিক করুন।
firebase::auth::Auth ক্লাসে অ্যাক্সেস করা
Auth ক্লাস হল সব API কলের গেটওয়ে।
- Auth ও App হেডার ফাইল যোগ করুন:
#include <cassert> #include <cstdint> #include "firebase/app.h" #include "firebase/auth.h"
- আপনার ইনিশিয়ালাইজেশন কোডে, একটি
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__)
- আপনার
firebase::App-এর জন্যfirebase::auth::Authক্লাস পান।AppওAuth-এর মধ্যে এক-এক ম্যাপিং আছে।firebase::auth::Auth* auth = firebase::auth::Auth::GetAuth(app);
পাসওয়ার্ড-ভিত্তিক অ্যাকাউন্ট তৈরি করা
পাসওয়ার্ড সহ নতুন ব্যবহারকারীর অ্যাকাউন্ট তৈরি করতে, আপনার অ্যাপের সাইন-ইন কোডে নিচের ধাপগুলি সম্পূর্ণ করুন:
- কোনও নতুন ব্যবহারকারী আপনার অ্যাপের সাইন-আপ ফর্ম ব্যবহার করে সাইন-আপ করলে, আপনার অ্যাপের প্রয়োজনীয় নতুন অ্যাকাউন্ট যাচাইকরণ ধাপগুলি সম্পূর্ণ করুন, যেমন নতুন অ্যাকাউন্টের পাসওয়ার্ড সঠিকভাবে লেখা হয়েছে কিনা এবং সেটি আপনার জটিলতা সংক্রান্ত প্রয়োজনীয়তা পূরণ করছে কিনা তা যাচাই করা।
- নতুন ব্যবহারকারীর ইমেল আইডি ও পাসওয়ার্ড
Auth::CreateUserWithEmailAndPassword-এ দিয়ে নতুন অ্যাকাউন্ট তৈরি করুন:firebase::Future<firebase::auth::AuthResult> result = auth->CreateUserWithEmailAndPassword(email, password);
- আপনার প্রোগ্রামে যদি নিয়মিত আপডেট লুপ চলে (যেমন, প্রতি সেকেন্ডে ৩০ বা ৬০
বার), তাহলে আপনি
Auth::CreateUserWithEmailAndPasswordLastResult-এর মাধ্যমে প্রতি আপডেটে একবার করে ফলাফল চেক করতে পারবেন: অথবা, আপনার প্রোগ্রাম ইভেন্ট-নির্ভর হলে, আপনি Future-এ কলব্যাক রেজিস্টার করতে পারেন।firebase::Future<firebase::auth::AuthResult> result = auth->CreateUserWithEmailAndPasswordLastResult(); if (result.status() == firebase::kFutureStatusComplete) { if (result.error() == firebase::auth::kAuthErrorNone) { const firebase::auth::AuthResult auth_result = *result.result(); printf("Create user succeeded for email %s\n", auth_result.user.email().c_str()); } else { printf("Created user failed with error '%s'\n", result.error_message()); } }
ইমেল আইডি ও পাসওয়ার্ড দিয়ে কোনও ব্যবহারকারীকে সাইন-ইন করানো
পাসওয়ার্ড দিয়ে কোনও ব্যবহারকারীকে সাইন-ইন করানোর ধাপগুলি নতুন অ্যাকাউন্ট তৈরি করার ধাপগুলির মতোই। আপনার অ্যাপের সাইন-ইন ফাংশনে, নিম্নলিখিত কাজগুলি করুন:
- কোনও ব্যবহারকারী আপনার অ্যাপে সাইন-ইন করলে, ব্যবহারকারীর ইমেল আইডি ও
পাসওয়ার্ড
firebase::auth::Auth::SignInWithEmailAndPassword-এ পাস করুন:firebase::Future<firebase::auth::AuthResult> result = auth->SignInWithEmailAndPassword(email, password);
- আপনার প্রোগ্রামে যদি নিয়মিত আপডেট লুপ চলে (যেমন, প্রতি সেকেন্ডে ৩০ বা ৬০
বার), তাহলে আপনি
Auth::SignInWithEmailAndPasswordLastResult-এর মাধ্যমে প্রতি আপডেটে একবার করে ফলাফল চেক করতে পারবেন: অথবা, আপনার প্রোগ্রাম ইভেন্ট-নির্ভর হলে, আপনি Future-এ কলব্যাক রেজিস্টার করতে পারেন।firebase::Future<firebase::auth::AuthResult> result = auth->SignInWithEmailAndPasswordLastResult(); if (result.status() == firebase::kFutureStatusComplete) { if (result.error() == firebase::auth::kAuthErrorNone) { const firebase::auth::AuthResult auth_result = *result.result(); printf("Sign in succeeded for email %s\n", auth_result.user.email().c_str()); } else { printf("Sign in failed with error '%s'\n", result.error_message()); } }
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 Authentication পাসওয়ার্ড নীতিতে নিম্নলিখিত পাসওয়ার্ড সংক্রান্ত প্রয়োজনীয়তা মেনে চলা হয়:
ছোট হাতের অক্ষর প্রয়োজন
বড় হাতের অক্ষর প্রয়োজন
সংখ্যাসূচক অক্ষর প্রয়োজন
বর্ণসাংখ্যিক অক্ষর ছাড়া অন্য অক্ষর প্রয়োজন
নিম্নলিখিত অক্ষরগুলি বর্ণসাংখ্যিক অক্ষর নয় সংক্রান্ত প্রয়োজনীয়তা পূরণ করে:
^ $ * . [ ] { } ( ) ? " ! @ # % & / \ , > < ' : ; | _ ~পাসওয়ার্ডের ন্যূনতম দৈর্ঘ্য (৬ থেকে ৩০টি অক্ষরের মধ্যে; ডিফল্ট হিসেবে ৬টি অক্ষর)
পাসওয়ার্ডের সর্বাধিক দৈর্ঘ্য (সর্বাধিক ৪০৯৬টি অক্ষর)
আপনি দুটি মোডে পাসওয়ার্ড নীতি এনফোর্সমেন্ট চালু করতে পারবেন:
প্রয়োজনীয়: ব্যবহারকারী আপনার নীতি মেনে চলে এমন পাসওয়ার্ড দিয়ে আপডেট না করা পর্যন্ত সাইন-আপ করার প্রচেষ্টা সফল হবে না।
বিজ্ঞপ্তি: ব্যবহারকারীরা নীতি মেনে চলে না এমন পাসওয়ার্ড দিয়ে সাইন-আপ করতে পারবেন। এই মোড ব্যবহার করার সময়, ব্যবহারকারীর পাসওয়ার্ড ক্লায়েন্ট-সাইড নীতি মেনে চলছে কিনা তা আপনাকে চেক করতে হবে এবং না চললে, কোনওভাবে ব্যবহারকারীকে তার পাসওয়ার্ড আপডেট করার জন্য প্রম্পট করতে হবে।
নতুন ব্যবহারকারীদের সবসময় এমন পাসওয়ার্ড বেছে নিতে হয় যা আপনার নীতি মেনে চলে।
আপনার অ্যাক্টিভ ব্যবহারকারী থাকলে, সাইন-ইন করার সময় জোর করে আপগ্রেড করার সুবিধা চালু না করার জন্য আমরা সাজেস্ট করি যদি না আপনি এমন ব্যবহারকারীদের অ্যাক্সেস ব্লক করতে চান যাদের পাসওয়ার্ড আপনার নীতি মেনে চলে না। পরিবর্তে, 'বিজ্ঞপ্তি' মোড ব্যবহার করুন, যা ব্যবহারকারীদের তাদের বর্তমান পাসওয়ার্ড দিয়ে সাইন-ইন করতে দেয় এবং তাদের পাসওয়ার্ডে কী কী প্রয়োজন নেই সেই সম্পর্কে জানায়।
সাজেস্ট করা: ইমেল এনুমেরেশন সুরক্ষা চালু করুন
কিছু Firebase Authentication পদ্ধতি, যেগুলি ইমেল আইডিকে প্যারামিটার হিসেবে নেয়, সেগুলি নির্দিষ্ট সমস্যা দেখায় যদি ইমেল আইডিটি রেজিস্টার করা না থাকে, যেখানে সেটি রেজিস্টার করা উচিত (যেমন, ইমেল আইডি ও পাসওয়ার্ড দিয়ে সাইন-ইন করার সময়) অথবা রেজিস্টার করা থাকে যেখানে সেটি ব্যবহার করা উচিত নয় (যেমন, ব্যবহারকারীর ইমেল আইডি পরিবর্তন করার সময়)। এটি ব্যবহারকারীদের নির্দিষ্ট সমাধান সাজেস্ট করার ব্যাপারে সহায়ক হলেও, আপনার ব্যবহারকারীদের রেজিস্টার করা ইমেল আইডি খুঁজে পেতে, খারাপ উদ্দেশ্য নিয়ে কাজ করা ব্যক্তিরা এর অপব্যবহার করতে পারে।
এই ঝুঁকি কমানোর জন্য, আমরা সাজেস্ট করি যে আপনার প্রোজেক্টের জন্য ইমেল এনুমেরেশন সুরক্ষা চালু করা আছে কিনা তা নিশ্চিত করুন। আপনি Firebase কনসোলে এই সেটিং চেক করতে পারবেন: নিরাপত্তা > যাচাইকরণ > সেটিংস ট্যাব-এ যান, এবং তারপর ব্যবহারকারীর অ্যাকশন বিকল্পে ক্লিক করুন।
মনে রাখবেন, এই ফিচার চালু করলে Firebase Authenticationএর জন্য সমস্যার রিপোর্ট করার আচরণ পরিবর্তন হয়ে যায়, তাই আপনার অ্যাপ যাতে আরও নির্দিষ্ট সমস্যার উপর নির্ভর না করে তা নিশ্চিত করুন।
পরবর্তী ধাপ
কোনও ব্যবহারকারী প্রথমবার সাইন-ইন করার পরে, একটি নতুন ব্যবহারকারীর অ্যাকাউন্ট তৈরি করা হয় এবং ক্রেডেনশিয়ালের সাথে লিঙ্ক করা হয়—অর্থাৎ, ব্যবহারকারীর নাম এবং পাসওয়ার্ড, ফোন নম্বর বা ব্যবহারকারী যে তথ্য দিয়ে সাইন-ইন করেছেন তা প্রদানকারীর তথ্য। এই নতুন অ্যাকাউন্ট আপনার 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();