اصالت‌سنجی با Firebase در Android بااستفاده از «درستی‌سنجی شماره تلفن Firebase»

Firebase Authentication نمی‌تواند مستقیماً یک کد Firebase PNV را برای ورود به سیستم بپذیرد؛ بااین‌حال، می‌توانید بااستفاده از ویژگی اصالت‌سنجی سفارشی Firebase Authentication، به کاربران اجازه دهید با Firebase PNV به سیستم وارد شوند.

ایجاد نقطه پایانی تبادل توکن

مرحله کلیدی در پیاده‌سازی راهکار اصالت‌سنجی سفارشی در Firebase این است که نقطه پایانی ایجاد کنید که بتواند یک کد Firebase PNV را دریافت کند، آن را اعتبارسنجی کند، و سپس یک کد اصالت‌سنجی سفارشی Firebase صادر کند. سپس برنامه شما می‌تواند از این نشان سفارشی برای ورود کاربر به سیستم استفاده کند.

این نقطه پایانی می‌تواند در هر پلاتفرمی میزبانی شود، اما در مثال زیر، نقطه پایانی بااستفاده از Cloud Functions ویژه Firebase میزبانی می‌شود:

Node.js

import { JwtVerifier } from "aws-jwt-verify";
import { getApp } from "firebase-admin/app";
import { getAuth, UserRecord } from "firebase-admin/auth";
import { onRequest } from "firebase-functions/https";

// Because we're deploying to Cloud Functions for Firebase, admin credentials
// are automatically available.
const app = getApp();
const authAdmin = getAuth(app);

// 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 begavior)
const fpnvVerifier = JwtVerifier.create({ issuer, audience, jwksUri });

// This Cloud Function is your token exchange endpoint. You pass the endpoint an
// FPNV token, and the Cloud Function verifies it and exchanges it for a
// Firebase Auth token corresponding to the same user.
export const signInWithFpnv = onRequest(async (req, res) => {
    // Get the FPNV token from the request body.
    const fpnvToken = req.body?;
    if (!fpnvToken) {
        res.sendStatus(400);
        return;
    }

    let verifiedPhoneNumber;
    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.
        verifiedPhoneNumber = verifiedPayload.sub;
    } catch {
        // If verification fails, reject the token.
        res.sendStatus(403);
        return;
    }

    // Now that you have a verified phone number, look it up in your Firebase
    // project's user database.
    let user: UserRecord;
    try {
        // If a user account already exists with the phone number, retrieve it.
        user = await authAdmin.getUserByPhoneNumber(verifiedPhoneNumber);
    } catch {
        // Otherwise, create a new user account using the phone number.
        user = await authAdmin.createUser({phoneNumber: verifiedPhoneNumber});
    }

    // Finally, mint a Firebase custom auth token containing the UID of the user
    // you looked up or created. Return this token to the caller.
    const authToken = await authAdmin.createCustomToken(user.uid);
    res.status(200).send(authToken);
    return;
});

ورود به سیستم با کد اصالت‌سنجی سفارشی

وقتی نقطه پایانی مستقر شد، با دنبال کردن این مراحل، کاربران را به سیستم Firebase وارد کنید:

  1. بااستفاده از جریان شرح‌داده‌شده در صفحه شروع به کار با Firebase Phone Number Verification، یک کد Firebase PNV دریافت کنید.

  2. این توکن را به نقطه پایانی Cloud Functions ارسال کنید. نقطه پایانی یک کد اصالت‌سنجی سفارشی به برنامه شما برمی‌گرداند که می‌توانید آن را به signInWithCustomToken() ارسال کنید.

    برای مثال، می‌توانید از Retrofit برای نوشتن روشی استفاده کنید، signInWithFpnvToken()، که میانایی مشابه یکی از روش‌های signin- Firebase دارد:

    Kotlin

    class FpnvSigninExample {
        interface FPNVTokenExchangeService {
            @POST("signInWithFpnv")
            suspend fun signInWithFpnv(@Body fpnvToken: String): String
        }
    
        val retrofit = Retrofit.Builder()
            .baseUrl("https://example-project.cloudfunctions.net/")
            .build()
        val service: FPNVTokenExchangeService = retrofit.create(FPNVTokenExchangeService::class.java)
    
        suspend fun signInWithFpnvToken(fpnvToken: String): Task<AuthResult?> = coroutineScope {
            val authToken = service.signInWithFpnv(fpnvToken)
            return@coroutineScope Firebase.auth.signInWithCustomToken(authToken)
        }
    }