ফোন নম্বর ও C++ ব্যবহার করে Firebase-এর মাধ্যমে যাচাইকরণ

আপনি Firebase Authentication ব্যবহার করে ব্যবহারকারীর ফোনে এসএমএস মেসেজ পাঠিয়ে সাইন-ইন করতে পারবেন। ব্যবহারকারী এসএমএস মেসেজে থাকা একবার ব্যবহারযোগ্য কোড ব্যবহার করে সাইন-ইন করেন।

Firebase SDK ব্যবহার করে কীভাবে ফোন নম্বর সাইন-ইন ফ্লো প্রয়োগ করতে হয় তা এই ডকুমেন্টে বর্ণনা করা হয়েছে।

শুরু করার আগে

  1. আপনার C++ প্রোজেক্টে Firebase যোগ করুন।
  2. আপনি এখনও Firebase প্রোজেক্টের সাথে অ্যাপ কানেক্ট না করে থাকলে, Firebase কনসোল থেকে তা করুন।
  3. ফোন নম্বর দিয়ে সাইন-ইন করার জন্য প্ল্যাটফর্মের প্রয়োজনীয়তা বুঝুন:
    • ফোন নম্বর দিয়ে সাইন-ইন করার সুবিধা শুধুমাত্র মোবাইল প্ল্যাটফর্মের জন্য।
    • iOS-এ, ফোন নম্বর সাইন-ইন করার জন্য একটি ফিজিক্যাল ডিভাইস প্রয়োজন এবং এটি সিমুলেটরে কাজ করবে না।

নিরাপত্তা সংক্রান্ত উদ্বেগ

শুধুমাত্র ফোন নম্বর ব্যবহার করে যাচাইকরণ করা সুবিধাজনক হলেও, অন্যান্য উপলভ্য পদ্ধতির তুলনায় কম সুরক্ষিত, কারণ ফোন নম্বরের মালিকানা ব্যবহারকারীদের মধ্যে ট্রান্সফার করা যেতে পারে। এছাড়াও, একাধিক ব্যবহারকারীর প্রোফাইল আছে এমন ডিভাইসে, যেসব ব্যবহারকারী এসএমএস মেসেজ পেতে পারেন, তারা ডিভাইসের ফোন নম্বর ব্যবহার করে অ্যাকাউন্টে সাইন-ইন করতে পারবেন।

আপনার অ্যাপে ফোন নম্বর ভিত্তিক সাইন-ইন ব্যবহার করলে, আরও সুরক্ষিত সাইন-ইন পদ্ধতির পাশাপাশি আপনাকে এটি অফার করতে হবে এবং ফোন নম্বর সাইন-ইন ব্যবহার করার নিরাপত্তা ট্রেডঅফ সম্পর্কে ব্যবহারকারীদের জানাতে হবে।

আপনার Firebase প্রোজেক্টের জন্য ফোন নম্বর সাইন-ইন চালু করুন

এসএমএসের মাধ্যমে ব্যবহারকারীদের সাইন-ইন করতে, আপনাকে প্রথমে আপনার Firebase প্রোজেক্টের জন্য ফোন নম্বর সাইন-ইন পদ্ধতি চালু করতে হবে:

  1. Firebase কনসোলে, নিরাপত্তা > যাচাইকরণ বিকল্পে যান।
  2. সাইন-ইন পদ্ধতি ট্যাবে, ফোন সাইন-ইন প্রদানকারী চালু করুন।
  3. আপনি যেসব অঞ্চলে এসএমএস মেসেজ পাঠানোর অনুমতি দিতে বা প্রত্যাখ্যান করতে চান, সেগুলির জন্য একটি নীতি সেট করুন। এসএমএস অঞ্চল সংক্রান্ত নীতি সেট করলে, আপনার অ্যাপকে এসএমএস অপব্যবহার থেকে সুরক্ষিত রাখতে সাহায্য করতে পারে। নতুন প্রোজেক্টের ক্ষেত্রে, ডিফল্ট নীতি কোনও অঞ্চলকে অনুমতি দেয় না।
    1. Firebase কনসোলে, নিরাপত্তা > যাচাইকরণ > সেটিংস ট্যাব বিকল্পে যান।
    2. এসএমএস অঞ্চল নীতি বিভাগে, আপনার এসএমএস অঞ্চল নীতি সেট-আপ করুন।

APNs বিজ্ঞপ্তি (Apple প্ল্যাটফর্ম) পাওয়া শুরু করুন

Apple প্ল্যাটফর্মে ফোন নম্বর যাচাইকরণ ব্যবহার করতে, আপনার অ্যাপকে Firebase থেকে APNs বিজ্ঞপ্তি গ্রহণ করতে সক্ষম হতে হবে। আপনি যখন কোনও ডিভাইসে প্রথমবার কোনও ব্যবহারকারীকে তার ফোন নম্বর দিয়ে সাইন-ইন করান, তখন Firebase Authentication ডিভাইসে একটি সাইলেন্ট পুশ বিজ্ঞপ্তি পাঠায় যাতে ফোন নম্বর সাইন-ইন করার অনুরোধটি আপনার অ্যাপ থেকে এসেছে কিনা তা যাচাই করা যায়। (এই কারণে, সিমুলেটরে ফোন নম্বর সাইন-ইন ব্যবহার করা যাবে না।)

Firebase Authentication-এর সাথে ব্যবহার করার জন্য APNs বিজ্ঞপ্তি চালু করতে:

  1. Xcode-এ, আপনার প্রোজেক্টের জন্য পুশ বিজ্ঞপ্তি চালু করুন।
  2. Firebase-এ আপনার APNs সার্টিফিকেট আপলোড করুন। আপনার কাছে আগে থেকে APNs সার্টিফিকেট না থাকলে, Apple Developer Member Center-এ একটি তৈরি করতে ভুলবেন না।

    1. Firebase কনসোলে, সেটিংস > সাধারণ বিকল্পে যান। তারপর, ক্লাউড মেসেজিং ট্যাব-এ ক্লিক করুন।
    2. আপনার ডেভেলপমেন্ট সার্টিফিকেট, প্রোডাকশন সার্টিফিকেট বা দুটির জন্যই সার্টিফিকেট আপলোড করুন বিকল্পে ক্লিক করুন। অন্তত একটি প্রয়োজন।
    3. প্রতিটি সার্টিফিকেটের জন্য, .p12 ফাইল বেছে নিন এবং পাসওয়ার্ড থাকলে তা লিখুন। এই সার্টিফিকেটের বান্ডেল আইডি আপনার অ্যাপের বান্ডেল আইডির সাথে ম্যাচ করছে কিনা তা নিশ্চিত করুন। সেভ করুন বিকল্পে ক্লিক করুন।

ব্যবহারকারীর ফোনে যাচাইকরণ কোড পাঠান

ফোন নম্বর দিয়ে সাইন-ইন করার প্রসেস শুরু করতে, ব্যবহারকারীকে এমন একটি ইন্টারফেস দেখান যা তাদের ফোন নম্বর দিতে প্রম্পট করে এবং তারপরে PhoneAuthProvider::VerifyPhoneNumber-এ কল করে Firebase-কে অনুরোধ করে যাতে ব্যবহারকারীর ফোনে এসএমএসের মাধ্যমে একটি যাচাইকরণ কোড পাঠানো হয়:

  1. ব্যবহারকারীর ফোন নম্বর পান।

    আইনি প্রয়োজনাদি আলাদা আলাদা হয়, তবে পেশাদার পদ্ধতি হিসেবে এবং আপনার ব্যবহারকারীদের প্রত্যাশা সেট করতে, তাদের জানানো উচিত যে তারা যদি ফোন সাইন-ইন ব্যবহার করে, তাহলে তারা যাচাইকরণের জন্য একটি এসএমএস মেসেজ পেতে পারে এবং স্ট্যান্ডার্ড রেট প্রযোজ্য হয়।

  2. PhoneAuthProvider::VerifyPhoneNumber-কে কল করুন, তাকে ব্যবহারকারীর ফোন নম্বর দিন।
    class PhoneListener : public PhoneAuthProvider::Listener {
     public:
      ~PhoneListener() override {}
    
      void OnVerificationCompleted(PhoneAuthCredential credential) override {
        // Auto-sms-retrieval or instant validation has succeeded (Android only).
        // There's no need for the end user to input the verification code manually.
        // `credential` can't be used instead of calling GetCredential().
      }
    
      void OnVerificationFailed(const std::string& error) override {
        // Verification code not sent.
      }
    
      void OnCodeSent(const std::string& verification_id,
                      const PhoneAuthProvider::ForceResendingToken&
                          force_resending_token) override {
        // Verification code successfully sent via SMS.
        // Show the Screen to enter the Code.
        // Developer may want to save that verification_id along with other app states in case
        // the app is terminated before the user gets the SMS verification code.
      }
    };
    
    PhoneListener phone_listener;
    PhoneAuhtOptions options;
    options.timeout_milliseconds = kAutoVerifyTimeOut;
    options.phone_number = phone_number;
    PhoneAuthProvider& phone_provider = PhoneAuthProvider::GetInstance(auth);
    phone_provider->VerifyPhoneNumber(options, &phone_listener);
    আপনি PhoneAuthProvider::VerifyPhoneNumber, Firebase-কে কল করলে,
    • (iOS-এ) আপনার অ্যাপে সাইলেন্ট পুশ বিজ্ঞপ্তি পাঠায়,
    • নির্দিষ্ট ফোন নম্বরে একটি যাচাইকরণ কোড সহ একটি এসএমএস মেসেজ পাঠায় এবং আপনার সম্পূর্ণকরণ ফাংশনে একটি যাচাইকরণ আইডি পাস করে। ব্যবহারকারীকে সাইন-ইন করাতে আপনার যাচাইকরণ কোড এবং যাচাইকরণ আইডি, দুটিই প্রয়োজন হবে।
  3. যাচাইকরণ আইডি সেভ করুন এবং আপনার অ্যাপ লোড হলে এটি রিস্টোর করুন। এটি করলে, ব্যবহারকারী সাইন-ইন ফ্লো সম্পূর্ণ করার আগে আপনার অ্যাপ বন্ধ হয়ে গেলেও (যেমন, এসএমএস অ্যাপে পরিবর্তন করার সময়) আপনার কাছে যে এখনও একটি বৈধ যাচাইকরণ আইডি আছে তা নিশ্চিত করতে পারবেন।

    আপনি যেকোনও উপায়ে যাচাইকরণ আইডি রাখতে পারেন। আপনি যদি ক্রস-প্ল্যাটফর্ম C++ ফ্রেমওয়ার্কের মাধ্যমে কোড লেখেন, তাহলে অ্যাপ বন্ধ ও রিস্টোর করার জন্য এটি বিজ্ঞপ্তি প্রদান করবে। এইসব ইভেন্টে, আপনি যাচাইকরণ আইডি যথাক্রমে সেভ ও রিস্টোর করতে পারবেন।

VerifyPhoneNumber-এ কল করার ফলে আপনার লিসনারে OnCodeSent-এ কল করা হলে, ব্যবহারকারী এসএমএস মেসেজে যাচাইকরণ কোড পেলে আপনি তাকে সেটি টাইপ করার জন্য প্রম্পট করতে পারেন।

অন্যদিকে, VerifyPhoneNumber-এ কল করার ফলে যদি OnVerificationCompleted হয়, তাহলে অটোমেটিক যাচাইকরণ সফল হয়েছে এবং আপনার কাছে এখন একটি PhoneAuthCredential থাকবে যা আপনি নিচে বর্ণনা করা পদ্ধতি অনুযায়ী ব্যবহার করতে পারবেন।

যাচাইকরণ কোড দিয়ে ব্যবহারকারীকে সাইন-ইন করান

ব্যবহারকারী এসএমএস মেসেজ থেকে পাওয়া যাচাইকরণ কোড আপনার অ্যাপে দেওয়ার পরে, যাচাইকরণ কোড ও যাচাইকরণ আইডি থেকে একটি PhoneAuthCredential অবজেক্ট তৈরি করে এবং সেই অবজেক্ট Auth::SignInWithCredential-এ পাস করে ব্যবহারকারীকে সাইন-ইন করান।

  1. ব্যবহারকারীর থেকে যাচাইকরণ কোড পান।
  2. যাচাইকরণ কোড ও যাচাইকরণ আইডি থেকে একটি Credential অবজেক্ট তৈরি করুন এবং যাচাইকরণ আইডি।
    PhoneAuthCredential credential = phone_auth_provider->GetCredential(
        verification_id_.c_str(), verification_code.c_str());
        
  3. Credential অবজেক্টের মাধ্যমে ব্যবহারকারীকে সাইন-ইন করান:
    Future<User> future = auth_->SignInWithCredential(credential);
    future.OnCompletion(
        [](const Future<User*>& result, void*) {
          if (result.error() == kAuthErrorNone) {
            // Successful.
            // User is signed in.
            User user = *result.result();
    
            // This should display the phone number.
            printf("Phone number: %s", user.phone_number().c_str());
    
            // The phone number provider UID is the phone number itself.
            printf("Phone provider uid: %s", user.uid().c_str());
    
            // The phone number providerID is 'phone'
            printf("Phone provider ID: %s", user.provider_id().c_str());
          } else {
            // Error.
            printf("Sign in error: %s", result.error_message().c_str());
          }
        },
        nullptr);

পরবর্তী ধাপ

ব্যবহারকারী প্রথমবার সাইন-ইন করার পরে, একটি নতুন ব্যবহারকারীর অ্যাকাউন্ট তৈরি করা হয় এবং ক্রেডেনশিয়ালের সাথে লিঙ্ক করা হয়—অর্থাৎ, ব্যবহারকারীর নাম এবং পাসওয়ার্ড, ফোন নম্বর, বা প্রমাণীকরণ প্রদানকারীর তথ্য—যার মাধ্যমে ব্যবহারকারী সাইন-ইন করেছেন। এই নতুন অ্যাকাউন্ট আপনার 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();