এই পৃষ্ঠায় Android অ্যাপে Firebase Phone Number Verification কীভাবে ব্যবহার করবেন তা বর্ণনা করা হয়েছে। এই বৈশিষ্ট্যের সাধারণ বিবরণের জন্য সারসংক্ষেপ দেখুন।
এই পৃষ্ঠায় ইউনিফাইড, সিঙ্গেল-কল API ব্যবহার করে Firebase PNV সাথে কীভাবে ইন্টিগ্রেট করতে হয় তার বিস্তারিত বর্ণনা দেওয়া হয়েছে। একটি সিঙ্গেল মেথড কল করলে সম্পূর্ণ Firebase PNV ব্যবহারকারী প্রবাহ পরিচালনা করা হয়, ব্যবহারকারীর সম্মতি নেওয়া থেকে শুরু করে Firebase PNV ব্যাকএন্ডে প্রয়োজনীয় নেটওয়ার্ক কল করা পর্যন্ত। এই পদ্ধতি ব্যবহার করে, আপনি ইন্টিগ্রেশন ধাপগুলিকে একটি সিঙ্গেল মেথড কলে কমিয়ে আনবেন।
এই API বেশিরভাগ ডেভেলপারদের জন্য সুপারিশ করা হয়; তবে, যদি আপনার নির্দিষ্ট প্রয়োজনীয়তা লাইব্রেরি দ্বারা পূরণ না করা হয়, তাহলে কাস্টম ফ্লো বাস্তবায়নের তথ্যের জন্য Firebase Phone Number Verification প্রবাহকে কাস্টমাইজ করুন পৃষ্ঠাটি দেখুন।
শুরু করার আগে
আপনার অ্যাপের গোপনীয়তা নীতি অবশ্যই একটি সর্বজনীনভাবে উপলব্ধ ওয়েবসাইটে প্রকাশ করতে হবে। এই পৃষ্ঠায়, আপনাকে আপনার ব্যবহারকারীদের ব্যাখ্যা করতে হবে যে আপনি Firebase Phone Number Verification ব্যবহার করে পুনরুদ্ধার করা ফোন নম্বরগুলি কীভাবে ব্যবহার করেন। আপনার অ্যাপের সাথে ব্যবহারকারীদের ফোন নম্বর শেয়ার করার জন্য সম্মতির অনুরোধ করার সময় Firebase PNV লাইব্রেরি এই পৃষ্ঠার সাথে লিঙ্ক করবে।
১. আপনার ফায়ারবেস প্রকল্প সেট আপ করুন
যদি আপনি ইতিমধ্যেই আপনার অ্যান্ড্রয়েড প্রজেক্টে Firebase যোগ না করে থাকেন, তাহলে তা যোগ করুন ।
Firebase PNV জন্য Blaze প্ল্যানের প্রয়োজন। যদি আপনি ইতিমধ্যেই আপনার প্রকল্পটিকে Pay-as-you-go Blaze প্রাইসিং প্ল্যানে আপগ্রেড না করে থাকেন, তাহলে তা করুন।
যদিও Firebase PNV জন্য আপনার Firebase প্রকল্পের সাথে একটি বিলিং অ্যাকাউন্ট সংযুক্ত করা প্রয়োজন, প্রিভিউ পর্বের সময়, আপনাকে পরিষেবার জন্য বিল করা হবে না।
যদি আপনি এখনও Firebase কনসোলে আপনার অ্যাপের SHA-256 ফিঙ্গারপ্রিন্ট নির্দিষ্ট না করে থাকেন, তাহলে Project সেটিংস থেকে তা করুন। আপনার অ্যাপের SHA-256 ফিঙ্গারপ্রিন্ট কীভাবে পাবেন সে সম্পর্কে বিস্তারিত জানতে "আপনার ক্লায়েন্টকে প্রমাণীকরণ করা" দেখুন।
গুগল ক্লাউড কনসোলে আপনার ফায়ারবেস প্রকল্পটি খুলুন এবং Firebase Phone Number Verification API সক্ষম করুন ।
কনসোলের ক্রেডেনশিয়াল পৃষ্ঠায়, আপনার অ্যান্ড্রয়েড এপিআই কী খুলুন এবং নির্বাচিত এপিআইগুলির তালিকায় 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-beta01")
}
৩. ঐচ্ছিক: Firebase PNV সাপোর্টের জন্য পরীক্ষা করুন
যাচাইকরণ প্রক্রিয়া শুরু করার আগে, আপনি ডিভাইস এবং এর সিম কার্ড API-ভিত্তিক ফোন নম্বর যাচাইকরণ সমর্থন করে কিনা তা পরীক্ষা করতে পারেন। এটি একটি প্রাক-পরীক্ষা যার জন্য ব্যবহারকারীর সম্মতির প্রয়োজন হয় না। আপনি এই পরীক্ষার ফলাফল ব্যবহার করে সিদ্ধান্ত নিতে পারেন যে 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 প্রবাহ শুরু করতে, FirebasePhoneNumberVerification এর একটি নতুন উদাহরণ তৈরি করুন, যা একটি Activity প্রসঙ্গে পাস করবে। ব্যবহারকারীর কাছে একটি সম্মতি স্ক্রিন উপস্থাপন করার জন্য SDK-এর জন্য একটি Activity প্রসঙ্গের প্রয়োজন। তারপর, বস্তুর getVerifiedPhoneNumber() পদ্ধতিটি কল করুন:
Kotlin
// Get an instance of the SDK _with an Activity context_:
val fpnv = FirebasePhoneNumberVerification.getInstance(this@MainActivity)
// Call getVerifiedPhoneNumber
fpnv.getVerifiedPhoneNumber("https://example.com/privacy-policy")
.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 ব্যাকএন্ডে অনুরোধ করা হচ্ছে।
- ডিভাইসের জন্য একটি যাচাইকৃত ফোন নম্বর ফেরত দেওয়া হচ্ছে।
৫. Firebase PNV টোকেন ব্যবহার করা
যদি প্রবাহটি সফল হয়, তাহলে getVerifiedPhoneNumber() পদ্ধতিটি যাচাইকৃত ফোন নম্বর এবং এটি সম্বলিত একটি স্বাক্ষরিত টোকেন ফেরত পাঠাবে। আপনার গোপনীয়তা নীতি অনুসারে আপনি এই ডেটা আপনার অ্যাপে ব্যবহার করতে পারেন।
যদি আপনি অ্যাপ ক্লায়েন্টের বাইরে যাচাইকৃত ফোন নম্বরটি ব্যবহার করেন, তাহলে ফোন নম্বরের পরিবর্তে টোকেনটি ব্যবহার করা উচিত যাতে আপনি এটি ব্যবহার করার সময় এর অখণ্ডতা যাচাই করতে পারেন। টোকেনটি যাচাই করতে, আপনি যেকোনো JWT যাচাইকরণ লাইব্রেরি ব্যবহার করতে পারেন। নিম্নলিখিত সমস্ত যাচাই করতে লাইব্রেরি ব্যবহার করুন:
Firebase PNV JWKS এন্ডপয়েন্টে প্রকাশিত একটি কী ব্যবহার করে টোকেনটি স্বাক্ষরিত হয়:
https://fpnv.googleapis.com/v1beta/jwksশ্রোতা এবং ইস্যুকারীর দাবিতে আপনার Firebase প্রকল্প নম্বর রয়েছে এবং নিম্নলিখিত ফর্ম্যাটে রয়েছে:
https://fpnv.googleapis.com/projects/FIREBASE_PROJECT_NUMBERআপনি Firebase কনসোলের Project সেটিংস পৃষ্ঠায় আপনার Firebase প্রজেক্ট নম্বরটি খুঁজে পেতে পারেন।
টোকেনটির মেয়াদ শেষ হয়নি।
উদাহরণ
একটি সংক্ষিপ্ত উদাহরণ হিসেবে, নিম্নলিখিত 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 above.
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 অ্যাপে সাইন ইন করুন
Firebase Authentication সাইন-ইন প্রবাহে Firebase PNV টোকেন ব্যবহারের উদাহরণের জন্য, Firebase ব্যবহার করে Firebase দিয়ে প্রমাণীকরণ করুন Firebase Phone Number Verification পৃষ্ঠাটি দেখুন।