এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

অ্যান্ড্রয়েডে ফায়ারবেস ফোন নম্বর যাচাইকরণ শুরু করুন

এই পৃষ্ঠায় একটি অ্যান্ড্রয়েড অ্যাপে Firebase Phone Number Verification কীভাবে ব্যবহার করতে হয় তা বর্ণনা করা হয়েছে। এই ফিচারটির সাধারণ বিবরণের জন্য ওভারভিউ দেখুন।

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

বেশিরভাগ ডেভেলপারের জন্য এই এপিআই-টি সুপারিশ করা হয়; তবে, লাইব্রেরিতে পূরণ হয় না এমন কোনো নির্দিষ্ট চাহিদা আপনার থাকলে, একটি কাস্টম ফ্লো বাস্তবায়নের তথ্যের জন্য “Customize the Firebase Phone Number Verification flow” পৃষ্ঠাটি দেখুন।

শুরু করার আগে

OAuth ব্র্যান্ড যাচাইকরণ সহ অনবোর্ডিং ধাপগুলো সম্পন্ন করার জন্য প্রজেক্ট মালিকের অধিকার প্রয়োজন।
OAuth ব্র্যান্ড যাচাইকরণ সম্পন্ন করতে আপনার একটি সর্বজনীনভাবে প্রবেশযোগ্য গোপনীয়তা নীতি থাকা আবশ্যক। আপনার পরীক্ষামূলক গোপনীয়তা নীতিটি হোস্ট করার জন্য আপনি Firebase Hosting ব্যবহার করে একটি সাধারণ ওয়েব অ্যাপ তৈরি করতে পারেন।
পরীক্ষা করার জন্য আপনার কাছে সমর্থিত ক্যারিয়ারগুলোর কোনো একটির সিম আছে কিনা, তা নিশ্চিত করুন।

১. আপনার ফায়ারবেস প্রজেক্ট সেট আপ করুন।

আপনার অ্যান্ড্রয়েড প্রজেক্টে ফায়ারবেস যোগ করুন, যদি আগে থেকে তা না করে থাকেন।
আপনি যদি এখনও Firebase কনসোলে আপনার অ্যাপের SHA-256 ফিঙ্গারপ্রিন্ট নির্দিষ্ট না করে থাকেন, তাহলে প্রজেক্ট সেটিংস থেকে তা করুন। আপনার অ্যাপের SHA-256 ফিঙ্গারপ্রিন্ট কীভাবে পাবেন সে সম্পর্কে বিস্তারিত জানতে ‘আপনার ক্লায়েন্ট প্রমাণীকরণ’ অংশটি দেখুন।
আপনাকে Firebase কনসোলে প্রথমবার অনবোর্ডিং প্রক্রিয়াটি সম্পন্ন করতে হবে। এর মধ্যে রয়েছে OAuth ব্র্যান্ড যাচাইকরণ এবং গোপনীয়তা নীতি পর্যালোচনা। আপনি যদি একটি নন-প্রোডাকশন টেস্টিং অ্যাপ তৈরি করেন, তবে আপনার পরীক্ষামূলক গোপনীয়তা নীতি হোস্ট করার জন্য Firebase Hosting ব্যবহার করে একটি বেসিক ওয়েব অ্যাপ তৈরি করতে পারেন।
Firebase PNV ব্যবহারের জন্য Blaze প্ল্যান প্রয়োজন। আপনি যদি এখনও আপনার প্রজেক্টটিকে পে-অ্যাজ-ইউ-গো ব্লেজ প্রাইসিং প্ল্যানে আপগ্রেড না করে থাকেন, তাহলে অনবোর্ডিংয়ের সময় আপনাকে তা করার জন্য বলা হবে।
যদিও Firebase PNV ব্যবহারের জন্য আপনার Firebase প্রজেক্টের সাথে একটি বিলিং অ্যাকাউন্ট সংযুক্ত থাকা প্রয়োজন, প্রিভিউ পর্যায়ে এই পরিষেবার জন্য আপনাকে কোনো বিল করা হবে না।
কনসোলের ক্রেডেনশিয়ালস পেজে, আপনার অ্যান্ড্রয়েড এপিআই কী খুলুন এবং নির্বাচিত এপিআই-এর তালিকায় Firebase Phone Number Verification এপিআই যোগ করুন।

২. আপনার অ্যাপে Firebase PNV লাইব্রেরিটি যুক্ত করুন।

আপনার মডিউল (অ্যাপ-লেভেল) গ্রেডল ফাইলে (সাধারণত <project>/<app-module>/build.gradle.kts অথবা <project>/<app-module>/build.gradle ), অ্যান্ড্রয়েডের জন্য Firebase Phone Number Verification লাইব্রেরির ডিপেন্ডেন্সি যোগ করুন।

dependencies {
    // Add the dependency for the Firebase Phone Number Verification library
    implementation("com.google.firebase:firebase-pnv:16.0.0")
}

৩. সুপারিশকৃত: Firebase PNV সমর্থনের জন্য যাচাই করুন।

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

ডিভাইসটির সামঞ্জস্যতা যাচাই করতে, getVerificationSupportInfo() মেথডটি কল করুন:

Kotlin

import com.google.firebase.pnv.FirebasePhoneNumberVerification

// Get an instance of the SDK.
val fpnv = FirebasePhoneNumberVerification.getInstance()

// Check all SIMs for support.
fpnv.getVerificationSupportInfo()
  .addOnSuccessListener { results ->
    if (results.any { it.isSupported() }) {
      // At least one SIM is supported; proceed with FPNV flow
    } else {
      // No SIMs are supported, so fall back to SMS verification.
    }
  }
  .addOnFailureListener { e ->
    // Handle error.
  }

getVerificationSupportInfo() ফাংশনটি প্রতিটি সিম স্লটের জন্য একটি করে VerificationSupportResult অবজেক্টের একটি তালিকা রিটার্ন করে। যদি অন্তত একটি সিম কার্ড সমর্থিত হয়, তবে আপনি Firebase PNV ফ্লো অনুসরণ করে এগিয়ে যেতে পারেন।

৪. যাচাইকরণ প্রক্রিয়া শুরু করুন।

Firebase PNV ফ্লো শুরু করতে, একটি Activity context পাস করে FirebasePhoneNumberVerification এর একটি নতুন ইনস্ট্যান্স তৈরি করুন। SDK-এর মাধ্যমে ব্যবহারকারীকে একটি সম্মতি স্ক্রিন দেখানোর জন্য একটি Activity context প্রয়োজন। তারপর, অবজেক্টটির getVerifiedPhoneNumber() মেথডটি কল করুন:

Kotlin

import com.google.firebase.pnv.FirebasePhoneNumberVerification

// Get an instance of the SDK _with an Activity context_:
val fpnv = FirebasePhoneNumberVerification.getInstance(this@MainActivity)

// Call getVerifiedPhoneNumber
fpnv.getVerifiedPhoneNumber()
  .addOnSuccessListener { result ->
    val phoneNumber = result.getPhoneNumber()
    val token = result.getToken()
    // Verification successful. Send token to your backend.
  }
  .addOnFailureListener { e ->
    // Handle failures, such as the user declining consent or a network error.
  }

getVerifiedPhoneNumber() মেথডটি ফোন নম্বর যাচাইকরণের সম্পূর্ণ প্রক্রিয়াটি সম্পন্ন করে, যার মধ্যে অন্তর্ভুক্ত রয়েছে:

ব্যবহারকারীর ফোন নম্বর শেয়ার করার জন্য তার সম্মতি নিতে অ্যান্ড্রয়েড ক্রেডেনশিয়াল ম্যানেজার ব্যবহার করা।
Firebase PNV ব্যাকএন্ডে অনুরোধটি পাঠানো হচ্ছে।
ডিভাইসটির জন্য একটি যাচাইকৃত ফোন নম্বর ফেরত দেওয়া হচ্ছে (এবারই বিলিং করা হয়)।

পরামর্শ: UI উন্নত করার জন্য, getVerifiedPhoneNumber কল করার আগে একটি লোডিং স্পিনার দেখানো উচিত এবং অপারেশনটি সফলভাবে বা কোনো ত্রুটিসহ সম্পন্ন হওয়ার পর স্পিনারটি বন্ধ করে দেওয়া উচিত। লোডিং স্পিনারটিকে কনসেন্ট স্ক্রিনের চেয়ে ছোট করে ডিজাইন করুন, যাতে স্ক্রিনটি দৃশ্যমান থাকলে এটি স্ক্রিন দ্বারা সম্পূর্ণরূপে আবৃত থাকে।

৫. Firebase PNV টোকেন ব্যবহার করা

প্রক্রিয়াটি সফল হলে, getVerifiedPhoneNumber() মেথডটি যাচাইকৃত ফোন নম্বর এবং সেটি ধারণকারী একটি স্বাক্ষরিত টোকেন ফেরত দেয়। আপনার গোপনীয়তা নীতিতে বর্ণিত নিয়ম অনুযায়ী আপনি এই ডেটা আপনার অ্যাপে ব্যবহার করতে পারেন।

আপনি যদি অ্যাপ ক্লায়েন্টের বাইরে যাচাইকৃত ফোন নম্বরটি ব্যবহার করেন, তবে সরাসরি ফোন নম্বরের পরিবর্তে টোকেনটি পাঠানো উচিত, যাতে ব্যবহারের সময় আপনি এর অখণ্ডতা যাচাই করতে পারেন। টোকেনটি যাচাই করার জন্য, আপনি যেকোনো JWT ভেরিফিকেশন লাইব্রেরি ব্যবহার করতে পারেন। নিম্নলিখিত সবকিছু যাচাই করতে লাইব্রেরিটি ব্যবহার করুন:

typ হেডারটি JWT তে সেট করা আছে।
টোকেনটি Firebase PNV JWKS এন্ডপয়েন্টে প্রকাশিত কীগুলোর একটি ব্যবহার করে ES256 অ্যালগরিদম দ্বারা স্বাক্ষরিত হয়:
```
https://fpnv.googleapis.com/v1beta/jwks
```
ইস্যুকারী দাবিতে আপনার ফায়ারবেস প্রজেক্ট নম্বর থাকে এবং এটি নিম্নলিখিত বিন্যাসে থাকে:
```
https://fpnv.googleapis.com/projects/FIREBASE_PROJECT_NUMBER
```
আপনি আপনার ফায়ারবেস প্রজেক্ট নম্বরটি ফায়ারবেস কনসোলের প্রজেক্ট সেটিংস পৃষ্ঠায় খুঁজে পেতে পারেন।
অডিয়েন্স ক্লেইম হলো একটি তালিকা, যাতে আপনার ফায়ারবেস প্রজেক্ট নম্বর এবং প্রজেক্ট আইডি থাকে এবং এটি নিম্নলিখিত বিন্যাসে থাকে:
```
[
  https://fpnv.googleapis.com/projects/FIREBASE_PROJECT_NUMBER,
  https://fpnv.googleapis.com/projects/FIREBASE_PROJECT_ID,
]
```
টোকেনটির মেয়াদ শেষ হয়নি।

উদাহরণ

একটি সংক্ষিপ্ত উদাহরণ হিসেবে, নিম্নলিখিত Express.js অ্যাপটি একটি HTTP POST অনুরোধ থেকে একটি Firebase PNV টোকেন গ্রহণ করে এবং টোকেনটির স্বাক্ষর ও দাবিগুলো যাচাই করার জন্য একটি JWT যাচাইকরণ লাইব্রেরি ব্যবহার করে:

নোড.জেএস

import express from "express";
import { JwtVerifier } from "aws-jwt-verify";

// Find your Firebase project number in the Firebase console.
const FIREBASE_PROJECT_NUMBER = "123456789";

// The issuer and audience claims of the FPNV token are specific to your
// project.
const issuer = `https://fpnv.googleapis.com/projects/${FIREBASE_PROJECT_NUMBER}`;
const audience = `https://fpnv.googleapis.com/projects/${FIREBASE_PROJECT_NUMBER}`;

// The JWKS URL contains the current public signing keys for FPNV tokens.
const jwksUri = "https://fpnv.googleapis.com/v1beta/jwks";

// Configure a JWT verifier to check the following:
// - The token is signed by Google
// - The issuer and audience claims match your project
// - The token has not yet expired (default behavior)
const fpnvVerifier = JwtVerifier.create({ issuer, audience, jwksUri });

const app = express();

app.post('/verifiedPhoneNumber', async (req, res) => {
    if (!req.body) return res.sendStatus(400);
    // Get the token from the body of the request.
    const fpnvToken = req.body;
    try {
        // Attempt to verify the token using the verifier configured
        previously.
        const verifiedPayload = await fpnvVerifier.verify(fpnvToken);

        // If verification succeeds, the subject claim of the token contains the
        // verified phone number. You can use this value however it's needed by
        // your app.
        const verifiedPhoneNumber = verifiedPayload.sub;
        // (Do something with it...)

        return res.sendStatus(200);
    } catch {
        // If verification fails, reject the token.
        return res.sendStatus(400);
    }
});

app.listen(3000);

Firebase Authentication সাইন-ইন ফ্লো-তে Firebase PNV টোকেন ব্যবহারের একটি উদাহরণের জন্য, Firebase Phone Number Verification ব্যবহার করে Firebase-এর সাথে প্রমাণীকরণ” পৃষ্ঠাটি দেখুন।

শুরু করার আগে

১. আপনার ফায়ারবেস প্রজেক্ট সেট আপ করুন।

২. আপনার অ্যাপে Firebase PNV লাইব্রেরিটি যুক্ত করুন।

৩. সুপারিশকৃত: Firebase PNV সমর্থনের জন্য যাচাই করুন।

Kotlin

৪. যাচাইকরণ প্রক্রিয়া শুরু করুন।

Kotlin

৫. Firebase PNV টোকেন ব্যবহার করা

উদাহরণ

নোড.জেএস

একটি Firebase অ্যাপে সাইন ইন করুন