Apple প্ল্যাটফর্মে OpenID Connect ব্যবহার করে যাচাইকরণ

আপনি Firebase Authentication with Identity Platform-এ আপগ্রেড করে থাকলে, আপনার পছন্দের OpenID Connect (OIDC) মেনে চলা পরিষেবা প্রদানকারীর মাধ্যমে Firebase-এ ব্যবহারকারীদের যাচাই করতে পারবেন। এর ফলে, Firebase-এ নেটিভভাবে কাজ করে না এমন পরিচয় প্রদানকারী ব্যবহার করা সম্ভব হয়।

শুরু করার আগে

OIDC প্রোভাইডার ব্যবহার করে ব্যবহারকারীদের সাইন-ইন করতে, আপনাকে প্রথমে প্রোভাইডারের থেকে কিছু তথ্য সংগ্রহ করতে হবে:

  • ক্লায়েন্ট আইডি: আপনার অ্যাপ শনাক্ত করার জন্য প্রদানকারীর অনন্য স্ট্রিং। আপনার প্রদানকারী আপনার সাপোর্ট করা প্রতিটি প্ল্যাটফর্মের জন্য আপনাকে একটি আলাদা ক্লায়েন্ট আইডি অ্যাসাইন করতে পারে। এটি আপনার পরিষেবা প্রদানকারীর ইস্যু করা আইডি টোকেনে aud দাবির অন্যতম ভ্যালু।

  • ক্লায়েন্ট সিক্রেট: একটি সিক্রেট স্ট্রিং যা পরিষেবা প্রদানকারী ক্লায়েন্ট আইডির মালিকানা নিশ্চিত করতে ব্যবহার করে। প্রতিটি ক্লায়েন্ট আইডির জন্য, আপনাকে একটি ম্যাচিং ক্লায়েন্ট সিক্রেট দিতে হবে। (আপনি auth কোড ফ্লো ব্যবহার করলে তবেই এই ভ্যালু প্রয়োজন, যা ব্যবহার করার জন্য বিশেষভাবে সাজেস্ট করা হয়।)

  • ইস্যুকারী: একটি স্ট্রিং যা আপনার পরিষেবা প্রদানকারীকে শনাক্ত করে। এই ভ্যালু অবশ্যই একটি URL হতে হবে যা /.well-known/openid-configuration-এর সাথে যোগ করা হলে, প্রদানকারীর OIDC ডিসকভারি ডকুমেন্টের লোকেশন হয়। যেমন, ইস্যুকারী https://auth.example.com হলে, ডিসকভারি ডকুমেন্ট https://auth.example.com/.well-known/openid-configuration-এ উপলভ্য থাকতে হবে।

উপরের তথ্য পাওয়ার পরে, আপনার Firebase প্রোজেক্টের জন্য সাইন-ইন প্রোভাইডার হিসেবে OpenID Connect চালু করুন:

  1. আপনার iOS প্রোজেক্টে Firebase যোগ করুন।

  2. আপনি Firebase Authentication with Identity Platform-এ আপগ্রেড না করে থাকলে, তা করুন। OpenID Connect যাচাইকরণ শুধুমাত্র আপগ্রেড করা প্রোজেক্টে উপলভ্য।

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

  4. সাইন-ইন পদ্ধতি ট্যাবে, নতুন পরিষেবা প্রদানকারী যোগ করুন বিকল্পে ক্লিক করুন এবং তারপরে OpenID Connect বিকল্পে ক্লিক করুন।

  5. আপনি অথরাইজেশন কোডের ফ্লো নাকি ইমপ্লিসিট গ্র্যান্ট ফ্লো ব্যবহার করবেন তা বেছে নিন।

    আপনার পরিষেবা প্রদানকারী কোড ফ্লো সমর্থন করলে, আপনার সবসময় এটি ব্যবহার করা উচিত। ইমপ্লিসিট ফ্লো কম সুরক্ষিত এবং এটি ব্যবহার করার জন্য কঠোরভাবে নিরুৎসাহিত করা হয়।

  6. এই পরিষেবা প্রদানকারীর নাম দিন। জেনারেট করা প্রদানকারী আইডি নোট করুন: oidc.example-provider-এর মতো কিছু। আপনার অ্যাপে সাইন-ইন কোড যোগ করার সময় এই আইডি প্রয়োজন হবে।

  7. আপনার ক্লায়েন্ট আইডি ও ক্লায়েন্ট সিক্রেট এবং আপনার পরিষেবা প্রদানকারীর ইস্যুকারী স্ট্রিং উল্লেখ করুন। এইসব ভ্যালু আপনার পরিষেবা প্রদানকারীর অ্যাসাইন করা ভ্যালুর সাথে সম্পূর্ণ ম্যাচ করতে হবে।

  8. আপনার করা পরিবর্তন সেভ করুন।

Firebase SDK-এর মাধ্যমে সাইন-ইন ফ্লো ম্যানেজ করা

আপনার OIDC প্রদানকারী ব্যবহার করে Firebase-এর মাধ্যমে আপনার ব্যবহারকারীদের যাচাই করার সবচেয়ে সহজ উপায় হল Firebase SDK-এর মাধ্যমে সম্পূর্ণ সাইন-ইন ফ্লো ম্যানেজ করা।

Firebase Apple প্ল্যাটফর্ম SDK-এর মাধ্যমে সাইন-ইন ফ্লো ম্যানেজ করতে, এইসব ধাপ অনুসরণ করুন:

  1. আপনার Xcode প্রোজেক্টে কাস্টম URL স্কিম যোগ করুন:

    1. আপনার প্রোজেক্ট কনফিগারেশন খুলুন: বাঁদিকের ট্রি ভিউতে প্রোজেক্টের নামের উপর ডবল ক্লিক করুন। টার্গেট বিভাগ থেকে আপনার অ্যাপ বেছে নিন, তারপর তথ্য ট্যাব বেছে নিন এবং URL-এর ধরন বিভাগটি বড় করুন।
    2. + বোতামে ক্লিক করুন এবং URL স্কিম হিসেবে আপনার এনকোড করা অ্যাপ আইডি যোগ করুন। অন্যান্য ফিল্ড খালি রাখুন।

      আপনি Firebase কনসোলে আপনার এনকোড করা অ্যাপ আইডি খুঁজে পেতে পারেন: সেটিংস > সাধারণ ট্যাব-এ যান, তারপর আপনার iOS অ্যাপ সম্পর্কে বিবরণ দেখতে আপনার অ্যাপ বিভাগে নিচের দিকে স্ক্রল করুন।

      সম্পূর্ণ হয়ে গেলে, আপনার কনফিগারেশন নিম্নলিখিত উদাহরণের মতো দেখতে হবে (তবে আপনার অ্যাপ্লিকেশন-নির্দিষ্ট ভ্যালু সহ):

      Xcode-এর কাস্টম URL স্কিম সেট-আপ ইন্টারফেসের স্ক্রিনশট
  2. Firebase কনসোল থেকে পাওয়া প্রদানকারী আইডি ব্যবহার করে OAuthProvider-এর একটি ইনস্ট্যান্স তৈরি করুন।

    Swift

    var provider = OAuthProvider(providerID: "oidc.example-provider")
    

    Objective-C

    FIROAuthProvider *provider = [FIROAuthProvider providerWithProviderID:@"oidc.example-provider"];
    
  3. ঐচ্ছিক: OAuth অনুরোধের সাথে পাঠাতে চান এমন অতিরিক্ত কাস্টম OAuth প্যারামিটার উল্লেখ করুন।

    Swift

    provider.customParameters = [
      "login_hint": "user@example.com"
    ]
    

    Objective-C

    [provider setCustomParameters:@{@"login_hint": @"user@example.com"}];
    

    আপনার পরিষেবা প্রদানকারীর সাথে যোগাযোগ করে জেনে নিন যে এটি কোন কোন প্যারামিটার সাপোর্ট করে। মনে রাখবেন, আপনি setCustomParameters-এর সাথে Firebase-এর জন্য প্রয়োজনীয় প্যারামিটার পাস করতে পারবেন না। এই প্যারামিটারগুলি হল client_id, response_type, redirect_uri, state, scope এবং response_mode।

  4. ঐচ্ছিক: আপনি যাচাইকরণ প্রদানকারীর কাছে অনুরোধ করতে চান এমন মৌলিক প্রোফাইলের বাইরে অতিরিক্ত OAuth 2.0 স্কোপ নির্দিষ্ট করুন।

    Swift

    provider.scopes = ["mail.read", "calendars.read"]
    

    Objective-C

    [provider setScopes:@[@"mail.read", @"calendars.read"]];
    

    আপনার পরিষেবা প্রদানকারীর সাথে যোগাযোগ করে জেনে নিন যে এটি কোন কোন স্কোপে কাজ করে।

  5. ঐচ্ছিক: ব্যবহারকারীকে reCAPTCHA দেখানোর সময় আপনার অ্যাপ যেভাবে SFSafariViewController বা UIWebView দেখায়, আপনি যদি তা কাস্টমাইজ করতে চান, তাহলে AuthUIDelegate প্রোটোকল মেনে চলে এমন একটি কাস্টম ক্লাস তৈরি করুন।

  6. OAuth প্রোভাইডার অবজেক্ট ব্যবহার করে Firebase-এর মাধ্যমে যাচাই করুন।

    Swift

    // If you created a custom class that conforms to AuthUIDelegate,
    // pass it instead of nil:
    provider.getCredentialWith(nil) { credential, error in
      if error != nil {
        // Handle error.
      }
      if credential != nil {
        Auth().signIn(with: credential) { authResult, error in
          if error != nil {
            // Handle error.
          }
          // User is signed in.
          // IdP data available in authResult.additionalUserInfo.profile.
          // OAuth access token can also be retrieved:
          // (authResult.credential as? OAuthCredential)?.accessToken
          // OAuth ID token can also be retrieved:
          // (authResult.credential as? OAuthCredential)?.idToken
        }
      }
    }
    

    Objective-C

    // If you created a custom class that conforms to AuthUIDelegate,
    // pass it instead of nil:
    [provider getCredentialWithUIDelegate:nil
                                completion:^(FIRAuthCredential *_Nullable credential, NSError *_Nullable error) {
      if (error) {
        // Handle error.
      }
      if (credential) {
        [[FIRAuth auth] signInWithCredential:credential
                                  completion:^(FIRAuthDataResult *_Nullable authResult, NSError *_Nullable error) {
          if (error) {
            // Handle error.
          }
          // User is signed in.
          // IdP data available in authResult.additionalUserInfo.profile.
          // OAuth access token can also be retrieved:
          // ((FIROAuthCredential *)authResult.credential).accessToken
          // OAuth ID token can also be retrieved:
          // ((FIROAuthCredential *)authResult.credential).idToken
        }];
      }
    }];
    
  7. উপরের উদাহরণগুলি সাইন-ইন ফ্লোর উপর ফোকাস করলেও, আপনি linkWithCredential ব্যবহার করে আগে থেকে থাকা ব্যবহারকারীর সাথে OIDC প্রোভাইডার লিঙ্ক করতে পারবেন। যেমন, আপনি একই ব্যবহারকারীর সাথে একাধিক পরিষেবা প্রদানকারীকে লিঙ্ক করতে পারেন, যাতে তিনি যেকোনও একটির মাধ্যমে সাইন-ইন করতে পারেন।

    Swift

    Auth().currentUser.link(withCredential: credential) { authResult, error in
      if error != nil {
        // Handle error.
      }
      // OIDC credential is linked to the current user.
      // IdP data available in authResult.additionalUserInfo.profile.
      // OAuth access token can also be retrieved:
      // (authResult.credential as? OAuthCredential)?.accessToken
      // OAuth ID token can also be retrieved:
      // (authResult.credential as? OAuthCredential)?.idToken
    }
    

    Objective-C

    [[FIRAuth auth].currentUser
        linkWithCredential:credential
                completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
      if (error) {
        // Handle error.
      }
      // OIDC credential is linked to the current user.
      // IdP data available in authResult.additionalUserInfo.profile.
      // OAuth access token can also be retrieved:
      // ((FIROAuthCredential *)authResult.credential).accessToken
      // OAuth ID token can also be retrieved:
      // ((FIROAuthCredential *)authResult.credential).idToken
    }];
    
  8. একই প্যাটার্ন reauthenticateWithCredential-এর সাথে ব্যবহার করা যেতে পারে যা সংবেদনশীল অপারেশনের জন্য নতুন ক্রেডেনশিয়াল ফিরিয়ে আনতে ব্যবহার করা যেতে পারে যার জন্য সাম্প্রতিক লগ-ইন প্রয়োজন।

    Swift

    Auth().currentUser.reauthenticateWithCredential(withCredential: credential) { authResult, error in
      if error != nil {
        // Handle error.
      }
      // User is re-authenticated with fresh tokens minted and
      // should be able to perform sensitive operations like account
      // deletion and email or password update.
      // IdP data available in result.additionalUserInfo.profile.
      // Additional OAuth access token can also be retrieved:
      // (authResult.credential as? OAuthCredential)?.accessToken
      // OAuth ID token can also be retrieved:
      // (authResult.credential as? OAuthCredential)?.idToken
    }
    

    Objective-C

    [[FIRAuth auth].currentUser
        reauthenticateWithCredential:credential
                          completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) {
      if (error) {
        // Handle error.
      }
      // User is re-authenticated with fresh tokens minted and
      // should be able to perform sensitive operations like account
      // deletion and email or password update.
      // IdP data available in result.additionalUserInfo.profile.
      // Additional OAuth access token can also be retrieved:
      // ((FIROAuthCredential *)authResult.credential).accessToken
      // OAuth ID token can also be retrieved:
      // ((FIROAuthCredential *)authResult.credential).idToken
    }];
    

সাইন-ইন ফ্লো ম্যানুয়ালি ম্যানেজ করুন

আপনি যদি আগে থেকেই আপনার অ্যাপে OpenID Connect সাইন-ইন ফ্লো প্রয়োগ করে থাকেন, তাহলে Firebase-এর মাধ্যমে যাচাই করার জন্য সরাসরি আইডি টোকেন ব্যবহার করতে পারবেন:

Swift

let credential = OAuthProvider.credential(
    withProviderID: "oidc.example-provider",  // As registered in Firebase console.
    idToken: idToken,  // ID token from OpenID Connect flow.
    rawNonce: nil
)
Auth.auth().signIn(with: credential) { authResult, error in
    if error {
        // Handle error.
        return
    }
    // User is signed in.
    // IdP data available in authResult?.additionalUserInfo?.profile
}

Objective-C

FIROAuthCredential *credential =
    [FIROAuthProvider credentialWithProviderID:@"oidc.example-provider"  // As registered in Firebase console.
                                       IDToken:idToken  // ID token from OpenID Connect flow.
                                      rawNonce:nil];
[[FIRAuth auth] signInWithCredential:credential
                          completion:^(FIRAuthDataResult * _Nullable authResult,
                                      NSError * _Nullable error) {
    if (error != nil) {
        // Handle error.
        return;
    }
    // User is signed in.
    // IdP data available in authResult.additionalUserInfo.profile
}];

পরবর্তী ধাপ

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

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