Apple প্ল্যাটফর্মে ইমেল লিঙ্ক ব্যবহার করে Firebase-এর মাধ্যমে যাচাইকরণ

আপনি Firebase Authentication ব্যবহার করে কোনও ব্যবহারকারীকে লিঙ্ক সহ ইমেল পাঠিয়ে সাইন-ইন করাতে পারেন, যে লিঙ্কে ক্লিক করে তিনি সাইন-ইন করতে পারবেন। এই প্রসেসে, ব্যবহারকারীর ইমেল আইডিও যাচাই করা হয়।

ইমেল দিয়ে সাইন-ইন করার অনেক সুবিধা আছে:

  • সহজে সাইন-আপ ও সাইন-ইন করা।
  • বিভিন্ন অ্যাপ্লিকেশন জুড়ে পাসওয়ার্ড পুনরায় ব্যবহার করার ঝুঁকি কমায়, যা এমনকি ভালভাবে বেছে নেওয়া পাসওয়ার্ডের নিরাপত্তাকেও দুর্বল করতে পারে।
  • ব্যবহারকারীকে যাচাই করার পাশাপাশি তিনি যে ইমেল আইডির বৈধ মালিক তাও যাচাই করার ক্ষমতা।
  • সাইন-ইন করার জন্য ব্যবহারকারীর শুধু অ্যাক্সেসযোগ্য ইমেল অ্যাকাউন্ট প্রয়োজন। কোনও ফোন নম্বর বা সোশ্যাল মিডিয়া অ্যাকাউন্টের মালিকানা প্রয়োজন নেই।
  • ব্যবহারকারী পাসওয়ার্ড না দিয়েই (বা মনে না রেখেই) নিরাপদে সাইন-ইন করতে পারবেন, যা মোবাইল ডিভাইসে করাটা ঝামেলার হতে পারে।
  • আগে থেকে আছেন এমন ব্যবহারকারী যিনি আগে ইমেল আইডেন্টিফায়ার (পাসওয়ার্ড বা ফেডারেটেড) দিয়ে সাইন-ইন করেছেন, তাকে শুধু ইমেল দিয়ে সাইন-ইন করার জন্য আপগ্রেড করা যেতে পারে। যেমন, কোনও ব্যবহারকারী পাসওয়ার্ড ভুলে গেলেও, পাসওয়ার্ড রিসেট না করেই সাইন-ইন করতে পারবেন।

শুরু করার আগে

Firebase ডিপেন্ডেন্সি ইনস্টল ও ম্যানেজ করতে Swift প্যাকেজ ম্যানেজার ব্যবহার করুন।

আপনার Apple প্রোজেক্টে Firebase SDK যোগ করার বিভিন্ন উপায় সম্পর্কে জানতে
  1. Xcode-এ, আপনার অ্যাপ প্রোজেক্ট খোলা রেখে, ফাইল > প্যাকেজ যোগ করুন বিকল্পে নেভিগেট করুন।
  2. প্রম্পট করা হলে, Firebase Apple প্ল্যাটফর্ম SDK রিপোজিটরি যোগ করুন:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Firebase Authentication লাইব্রেরি বেছে নিন।
  5. আপনার টার্গেটের বিল্ড সেটিংসের অন্যান্য লিঙ্কার ফ্ল্যাগ বিভাগে -ObjC ফ্ল্যাগ যোগ করুন।
  6. হয়ে গেলে, Xcode অটোমেটিক ব্যাকগ্রাউন্ডে আপনার ডিপেন্ডেন্সি সমাধান ও ডাউনলোড করা শুরু করবে।

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

  1. Firebase কনসোলে, নিরাপত্তা > যাচাইকরণ বিকল্পে যান।

  2. সাইন-ইন পদ্ধতি ট্যাবে, ইমেল/পাসওয়ার্ড সাইন-ইন প্রদানকারী চালু করুন। মনে রাখবেন যে ইমেল লিঙ্ক সাইন-ইন ব্যবহার করতে ইমেল/পাসওয়ার্ড সাইন-ইন চালু থাকতে হবে।

  3. একই বিভাগে, ইমেল লিঙ্ক (পাসওয়ার্ড ছাড়া সাইন-ইন) প্রোভাইডার চালু করুন।

  4. সেভ করুন বিকল্পে ক্লিক করুন।

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

  1. ActionCodeSettings অবজেক্ট তৈরি করুন, যা Firebase-কে ইমেল লিঙ্ক কীভাবে তৈরি করতে হবে সেই বিষয়ে নির্দেশাবলী প্রদান করে। নিম্নলিখিত ফিল্ড সেট করুন:

    • url: এম্বেড করার জন্য ডিপ লিঙ্ক এবং এর সাথে পাস করার জন্য যেকোনও অতিরিক্ত স্টেট। আপনি আগে থেকে না করে থাকলে, অনুমোদিত ডোমেনের তালিকায় আপনার ডোমেন যোগ করুন:

      1. Firebase কনসোলে, নিরাপত্তা > যাচাইকরণ > সেটিংস ট্যাব বিকল্পে যান।

      2. অনুমোদিত ডোমেন বিভাগে, ডোমেন যোগ করুন বিকল্পে ক্লিক করে আপনার ডোমেন যোগ করুন।

    • iOSBundleID এবং androidPackageName: Firebase Authentication-কে নির্ধারণ করতে সাহায্য করে যে এটি শুধুমাত্র ওয়েব বা মোবাইল লিঙ্ক তৈরি করবে কিনা যা Android বা Apple ডিভাইসে খোলা হয়।
    • handleCodeInApp: 'সত্য' হিসেবে সেট করা হয়েছে। সাইন-ইন করার অপারেশন সবসময় অ্যাপেই সম্পূর্ণ করতে হবে, অন্যান্য আউট অফ ব্যান্ড ইমেল অ্যাকশনের (পাসওয়ার্ড রিসেট ও ইমেল যাচাইকরণ) মতো নয়। এর কারণ হল, ফ্লোয়ের শেষে, ব্যবহারকারী সাইন-ইন করবেন এবং অ্যাপে তার Auth স্টেট সেভ থাকবে বলে আশা করা হয়।
    • linkDomain: কোনও প্রোজেক্টের জন্য কাস্টম Hosting লিঙ্ক ডোমেন নির্দিষ্ট করা থাকলে, নির্দিষ্ট মোবাইল অ্যাপের মাধ্যমে লিঙ্ক খোলার সময় কোনটি ব্যবহার করা হবে তা উল্লেখ করুন। অন্যথায়, ডিফল্ট ডোমেন অটোমেটিক বেছে নেওয়া হয় (যেমন, PROJECT_ID.firebaseapp.com)।
    • dynamicLinkDomain: বন্ধ করে দেওয়া হয়েছে। এই প্যারামিটার নির্দিষ্ট করবেন না।

    Swift

    let actionCodeSettings = ActionCodeSettings()
    actionCodeSettings.url = URL(string: "https://www.example.com")
    // The sign-in operation has to always be completed in the app.
    actionCodeSettings.handleCodeInApp = true
    actionCodeSettings.setIOSBundleID(Bundle.main.bundleIdentifier!)
    actionCodeSettings.setAndroidPackageName("com.example.android",
                                             installIfNotAvailable: false, minimumVersion: "12")

    Objective-C

    FIRActionCodeSettings *actionCodeSettings = [[FIRActionCodeSettings alloc] init];
    [actionCodeSettings setURL:[NSURL URLWithString:@"https://www.example.com"]];
    // The sign-in operation has to always be completed in the app.
    actionCodeSettings.handleCodeInApp = YES;
    [actionCodeSettings setIOSBundleID:[[NSBundle mainBundle] bundleIdentifier]];
    [actionCodeSettings setAndroidPackageName:@"com.example.android"
                        installIfNotAvailable:NO
                               minimumVersion:@"12"];

    ActionCodeSettings সম্পর্কে আরও জানতে, ইমেল অ্যাকশনে স্টেট পাস করা বিভাগটি দেখুন।

  2. ব্যবহারকারীকে তার ইমেল আইডি লিখতে বলুন।

  3. ব্যবহারকারীর ইমেলে যাচাইকরণ লিঙ্ক পাঠান এবং ব্যবহারকারীর ইমেল সেভ করুন যাতে ব্যবহারকারী একই ডিভাইসে ইমেল সাইন-ইন সম্পূর্ণ করতে পারেন।

    Swift

    Auth.auth().sendSignInLink(toEmail: email,
                               actionCodeSettings: actionCodeSettings) { error in
      // ...
        if let error = error {
          self.showMessagePrompt(error.localizedDescription)
          return
        }
        // The link was successfully sent. Inform the user.
        // Save the email locally so you don't need to ask the user for it again
        // if they open the link on the same device.
        UserDefaults.standard.set(email, forKey: "Email")
        self.showMessagePrompt("Check your email for link")
        // ...
    }

    Objective-C

    [[FIRAuth auth] sendSignInLinkToEmail:email
                       actionCodeSettings:actionCodeSettings
                               completion:^(NSError *_Nullable error) {
      // ...
        if (error) {
          [self showMessagePrompt:error.localizedDescription];
           return;
        }
        // The link was successfully sent. Inform the user.
        // Save the email locally so you don't need to ask the user for it again
        // if they open the link on the same device.
        [NSUserDefaults.standardUserDefaults setObject:email forKey:@"Email"];
        [self showMessagePrompt:@"Check your email for link"];
        // ...
    }];

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

সাইন-ইন লিঙ্ক ব্যবহার করে যাতে কোনও অনাকাঙ্ক্ষিত ব্যবহারকারী বা অনাকাঙ্ক্ষিত ডিভাইস থেকে সাইন-ইন করা না যায়, সেই জন্য Firebase Auth-এর ক্ষেত্রে সাইন-ইন করার প্রসেস সম্পূর্ণ করার সময় ব্যবহারকারীর ইমেল আইডি প্রদান করতে হয়। সাইন-ইন করার জন্য, এই ইমেল আইডিটি সেই ইমেল আইডির সাথে মিলতে হবে যেখানে সাইন-ইন লিঙ্কটি পাঠানো হয়েছিল।

যেসব ব্যবহারকারী যে ডিভাইস থেকে সাইন-ইন লিঙ্কের অনুরোধ করেছেন সেই ডিভাইসেই লিঙ্কটি খোলেন, তাদের জন্য আপনি এই ফ্লোটি স্ট্রিমলাইন করতে পারেন। এর জন্য, আপনি যখন সাইন-ইন ইমেল পাঠান তখন তাদের ইমেল আইডি লোকাল ডিভাইসে সেভ করুন। তারপর, এই ঠিকানা ব্যবহার করে ফ্লো সম্পূর্ণ করুন।

সাইন-ইন সম্পূর্ণ হওয়ার পরে, সাইন-ইনের আগেকার যেকোনও যাচাই না করা পদ্ধতি ব্যবহারকারীর থেকে সরিয়ে দেওয়া হবে এবং আগে থেকে থাকা যেকোনও সেশন বাতিল করা হবে। যেমন, কেউ যদি আগে একই ইমেল ও পাসওয়ার্ড ব্যবহার করে কোনও যাচাই না করা অ্যাকাউন্ট তৈরি করে থাকেন, তাহলে ব্যবহারকারীর পাসওয়ার্ড সরিয়ে দেওয়া হবে যাতে যে ব্যক্তি মালিকানা দাবি করে যাচাই না করা অ্যাকাউন্ট তৈরি করেছেন, তিনি যেন একই অ্যাকাউন্ট ব্যবহার করে আবার সাইন-ইন করতে না পারেন।

Apple মোবাইল অ্যাপে সাইন-ইন সম্পূর্ণ করা

Firebase Authentication, Firebase Hosting ব্যবহার করে মোবাইল ডিভাইসে ইমেল লিঙ্ক পাঠায়। মোবাইল অ্যাপ্লিকেশনের মাধ্যমে সাইন-ইন সম্পূর্ণ করার জন্য, ইনকামিং অ্যাপ্লিকেশন লিঙ্ক শনাক্ত করা, অন্তর্নিহিত ডিপ লিঙ্ক পার্স করা এবং তারপর সাইন-ইন সম্পূর্ণ করার জন্য অ্যাপ্লিকেশনটি কনফিগার করতে হবে। এটি কীভাবে করবেন সেই সম্পর্কে আরও জানতে iOS-এ ইউনিভার্সাল লিঙ্ক ও সংশ্লিষ্ট ডোমেন দেখুন।

Firebase Hosting কনফিগার করুন

Firebase Authentication Firebase Hosting ডোমেন ব্যবহার করে যখন মোবাইল অ্যাপ্লিকেশনে খোলার জন্য কোনও লিঙ্ক তৈরি করে এবং পাঠায়। আপনার জন্য আগে থেকেই একটি ডিফল্ট Firebase Hosting ডোমেন কনফিগার করা হয়েছে।

  1. Firebase Hostingটি ডোমেন কনফিগার করুন:

    Firebase কনসোলে, হোস্টিং ও সার্ভারলেস > হোস্টিং বিকল্পে যান।

    • আপনি যদি মোবাইল অ্যাপ্লিকেশনে খোলা ইমেল লিঙ্কের জন্য ডিফল্ট ডোমেন ব্যবহার করতে চান, তাহলে আপনার ডিফল্ট সাইটে যান এবং আপনার ডিফল্ট Hosting ডোমেন নোট করুন। ডিফল্ট Hosting ডোমেন সাধারণত এইরকম দেখতে হয়: PROJECT_ID.firebaseapp.com.

      ইনকামিং লিঙ্ক ইন্টারসেপ্ট করার জন্য আপনার অ্যাপ কনফিগার করার সময় এই ভ্যালু প্রয়োজন হবে।

    • ইমেল লিঙ্কের জন্য কাস্টম ডোমেন ব্যবহার করতে চাইলে, আপনি Firebase Hosting-এর মাধ্যমে একটি রেজিস্টার করতে এবং লিঙ্কের ডোমেনের জন্য সেটি ব্যবহার করতে পারবেন।

  2. Apple অ্যাপ্লিকেশন কনফিগার করা:

    অ্যাপ লিঙ্কের জন্য আপনাকে বেছে নেওয়া ডোমেনটি সংশ্লিষ্ট ডোমেন হিসেবে কনফিগার করতে হবে। আপনার অ্যাপে এনটাইটেলমেন্ট সেট-আপ করতে, Xcode-এ টার্গেটের Signing & Capabilities ট্যাব খুলুন এবং আগের ধাপ থেকে Firebase Hosting ডোমেন Associated Domains-এর ক্ষমতায় যোগ করুন। ডিফল্ট Firebase Hosting ডোমেন ব্যবহার করলে, এটি হবে applinks:PROJECT_ID.firebaseapp.com।

    আরও তথ্যের জন্য Apple-এর ডকুমেন্টেশন সাইটে সংশ্লিষ্ট ডোমেনকে সহায়তা করা দেখুন।

উপরে যেভাবে বলা হয়েছে সেইভাবে লিঙ্ক পাওয়ার পরে, এটি ইমেল লিঙ্ক যাচাইকরণের জন্য কিনা তা যাচাই করুন এবং সাইন-ইন করার প্রসেস সম্পূর্ণ করুন।

Swift

if Auth.auth().isSignIn(withEmailLink: link) {
        Auth.auth().signIn(withEmail: email, link: self.link) { user, error in
          // ...
        }
}

Objective-C

if ([[FIRAuth auth] isSignInWithEmailLink:link]) {
    [[FIRAuth auth] signInWithEmail:email
                               link:link
                         completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
      // ...
    }];
}

Android অ্যাপ্লিকেশনে ইমেল লিঙ্কের মাধ্যমে সাইন-ইন কীভাবে ম্যানেজ করতে হয় সেই সম্পর্কে জানতে, Android গাইড দেখুন।

ওয়েব অ্যাপ্লিকেশনে ইমেল লিঙ্কের মাধ্যমে সাইন-ইন করার প্রসেস কীভাবে ম্যানেজ করতে হয় সেই সম্পর্কে জানতে, ওয়েব গাইড দেখুন।

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

অপারেশনের দ্বিতীয় ভাগে পার্থক্যটি দেখা যাবে:

Swift

  let credential = EmailAuthCredential.credential(withEmail:email
                                                       link:link)
  Auth.auth().currentUser?.link(with: credential) { authData, error in
    if (error) {
      // And error occurred during linking.
      return
    }
    // The provider was successfully linked.
    // The phone user can now sign in with their phone number or email.
  }

Objective-C

  FIRAuthCredential *credential =
      [FIREmailAuthProvider credentialWithEmail:email link:link];
  [FIRAuth auth].currentUser
      linkWithCredential:credential
              completion:^(FIRAuthDataResult *_Nullable result,
                           NSError *_Nullable error) {
    if (error) {
      // And error occurred during linking.
      return;
    }
    // The provider was successfully linked.
    // The phone user can now sign in with their phone number or email.
  }];

কোনও সংবেদনশীল অপারেশন চালানোর আগে ইমেল লিঙ্ক ব্যবহারকারীকে আবার যাচাই করার জন্যও এটি ব্যবহার করা যেতে পারে।

Swift

  let credential = EmailAuthProvider.credential(withEmail:email
                                                       link:link)
  Auth.auth().currentUser?.reauthenticate(with: credential) { authData, error in
    if (error) {
      // And error occurred during re-authentication.
      return
    }
    // The user was successfully re-authenticated.
  }

Objective-C

  FIRAuthCredential *credential =
      [FIREmailAuthCredential credentialWithEmail:email link:link];
  [FIRAuth auth].currentUser
      reauthenticateWithCredential:credential
                        completion:^(FIRAuthDataResult *_Nullable result,
                                     NSError *_Nullable error) {
    if (error) {
      // And error occurred during re-authentication
      return;
    }
    // The user was successfully re-authenticated.
  }];

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

Firebase Authentication iOS SDK v11.8.0-এর আগে, ইমেল লিঙ্ক সাইন-ইন ফিচার সঠিক অ্যাপে সাইন-ইন লিঙ্ক খোলার জন্য Firebase Dynamic Links-এর উপর নির্ভর করত। এই যাচাইকরণ লিঙ্কগুলি বন্ধ করা হয়েছে, কারণ Firebase Dynamic Links ২৫ আগস্ট, ২০২৫-এ বন্ধ হয়ে যাবে।

আপনার অ্যাপ পুরনো স্টাইলের লিঙ্ক ব্যবহার করলে, আপনাকে অ্যাপ মাইগ্রেট করতে হবে যাতে নতুন Firebase Hosting ভিত্তিক সিস্টেম ব্যবহার করা যায়।

আপনি ১৫ সেপ্টেম্বর, ২০২৩ বা তার পরে আপনার প্রোজেক্ট তৈরি করে থাকলে, ইমেল এনিউমারেশন সুরক্ষা ডিফল্ট হিসেবে চালু করা থাকে। এই ফিচার আপনার প্রোজেক্টের ব্যবহারকারীর অ্যাকাউন্টের নিরাপত্তা উন্নত করে, তবে এটি fetchSignInMethodsForEmail() পদ্ধতি বন্ধ করে দেয়, যা আমরা আগে আইডেন্টিফায়ার-ফার্স্ট ফ্লো প্রয়োগ করার জন্য সাজেস্ট করেছিলাম।

আপনার প্রোজেক্টের জন্য ইমেল এনিউমারেশন সুরক্ষা বন্ধ করতে পারলেও, আমরা এটি বন্ধ না করার পরামর্শ দিই।

আরও জানতে, ইমেল এনিউমারেশন সুরক্ষা চালু বা বন্ধ করা দেখুন।

পরবর্তী ধাপ

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

  • আপনার অ্যাপে, আপনি User অবজেক্ট থেকে ব্যবহারকারীর প্রাথমিক প্রোফাইল তথ্য পেতে পারেন। ব্যবহারকারীদের ম্যানেজ করুন বিকল্প দেখুন।

  • আপনার Firebase Realtime Database এবং Cloud Storage নিরাপত্তা সংক্রান্ত নিয়মে, আপনি auth ভেরিয়েবল থেকে সাইন-ইন করা ব্যবহারকারীর অনন্য ব্যবহারকারী আইডি পেতে পারেন এবং কোনও ব্যবহারকারী কোন ডেটা অ্যাক্সেস করতে পারবেন তা নিয়ন্ত্রণ করতে এটি ব্যবহার করতে পারেন।

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

কোনও ব্যবহারকারীকে সাইন-আউট করতে, signOut: কল করুন।

Swift

let firebaseAuth = Auth.auth()
do {
  try firebaseAuth.signOut()
} catch let signOutError as NSError {
  print("Error signing out: %@", signOutError)
}

Objective-C

NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
  NSLog(@"Error signing out: %@", signOutError);
  return;
}

এছাড়াও, আপনি হয়ত যাচাইকরণ সংক্রান্ত সব ধরনের সমস্যার জন্য সমস্যা সমাধানের কোড যোগ করতে চাইবেন। সমস্যা সমাধান করা দেখুন।