নির্ভরযোগ্য পার্টি প্রয়োগ করা

আপনার সাইটে ইমেল যাচাইকরণ প্রয়োগ করতে, টোকেনের অনুরোধ জানাতে আপনার ফর্ম মার্ক-আপ আপডেট করুন এবং ইনকামিং টোকেনের জন্য সার্ভার-সাইড যাচাইকরণ যোগ করুন।

অরিজিন ট্রায়ালের জন্য রেজিস্টার করা

যাচাইকরণ সাইটে অবশ্যই অরিজিন ট্রায়াল কনফিগার করা থাকতে হবে।

Chrome 154 থেকে থার্ড-পার্টি অরিজিন ট্রায়াল একটি গুরুত্বপূর্ণ সতর্কতার সাথে কাজ করে: ট্রায়ালের জন্য রেজিস্টার করা অরিজিন ইস্যুকারীর একই-সাইট হতে হবে। যেমন:

  • ইস্যুকারী ডোমেন: issuer.example
  • OT রেজিস্টারকারী: https://issuer.example
  • জাভাস্ক্রিপ্ট অরিজিন: https://issuer.example (অথবা সাবডোমেন ম্যাচিং সহ https://app.issuer.example)

ফর্ম ফিল্ড কনফিগার করুন

আপনার ইমেল জমা দেওয়ার ফর্মে একটি লুকানো টোকেন ফিল্ড যোগ করুন:

<input
  type="email"
  name="email-address"
  autocomplete="email">
<input
  type="hidden"
  name="token"
  autocomplete="email-verification-token"
  nonce="rAnD0m-VaLuE">

ফিল্ড সংক্রান্ত প্রয়োজনীয়তা:

  • ইমেল ফিল্ড: type="email" এবং autocomplete="email" সেট করুন যাতে Chrome অটোফিল করতে এবং ঠিকানা শনাক্ত করতে পারে।
  • টোকেন ফিল্ড অ্যাট্রিবিউট:
    • autocomplete="email-verification-token" সেট করুন: Chrome এই ফিল্ডটি শনাক্ত করে যাতে জমা দেওয়ার সময় টোকেনটি পূরণ করা যায়।
    • সেট nonce="<VALUE>": ফর্ম জমা দেওয়ার বিষয়টি যাচাই করতে সাইটকে অবশ্যই সেশন-বাউন্ড নন্স প্রদান করতে হবে।

ইমেল যাচাইকরণ টোকেন (EVT) ভ্যালিডেট করা

ব্যবহারকারী ফর্ম জমা দিলে, আপনার সার্ভার ইমেল আইডি এবং লুকানো ফিল্ড থেকে টোকেন পায়। টোকেন ফিল্ড খালি থাকলে বুঝতে হবে যে ব্রাউজার বা পরিষেবা প্রদানকারী EVP কাজ করে না অথবা ব্যবহারকারী যাচাইকরণ এড়িয়ে গেছেন। এটি ঘটলে, আপনার বর্তমান যাচাইকরণ প্রক্রিয়া, যেমন ওটিপি বা ম্যাজিক লিঙ্ক পাঠানোর মতো পদ্ধতিতে ফিরে যান।

কোনও টোকেন থাকলে, নিম্নলিখিত উপায়ে সেটি যাচাই করুন:

  1. SD-JWT লাইব্রেরি ব্যবহার করে টোকেন পার্স করুন।
  2. প্রত্যাশিত ভ্যালু ও সেশন ক্লেম যাচাই করুন।
  3. ডিএনএস ডেলিগেশন যাচাই করুন।
  4. ইস্যুকারীর মেটাডেটা খুঁজে বের করুন এবং JWKS নিয়ে আসুন।
  5. ক্রিপ্টোগ্রাফিক স্বাক্ষর ও কী বাইন্ডিং যাচাই করুন।

১. টোকেন পার্স করুন

টোকেনটি RFC 9901: বেছে নেওয়া তথ্য প্রকাশ করা JWT (SD-JWT+KB) ফর্ম্যাট ব্যবহার করে। টোকেন পার্স ও যাচাই করার জন্য আপনার প্ল্যাটফর্মের জন্য উপযুক্ত লাইব্রেরি ব্যবহার করুন। যেমন, Node-এর জন্য আপনি @sd-jwt/core এবং jose ব্যবহার করতে পারেন। র-ফর্ম্যাটে এটি দেখতে এইরকম হয়: ইস্যুকারীর স্বাক্ষর করা JWT, তারপরে শূন্য বা তার বেশি ডিসক্লোজার এবং শেষে কী-বাইন্ডিং JWT, যেখানে প্রতিটি কম্পোনেন্ট টিল্ডা চিহ্ন দিয়ে আলাদা করা থাকে:

<Issuer-signed EVT>~<Disclosure 1>~...~<Disclosure N>~<Key Binding JWT>

বর্তমান প্রয়োগে, টোকেনে কোনও ডিসক্লোজার নেই (<Issuer-signed EVT>~<Key Binding JWT>)। তবে, ভবিষ্যতে এটি পরিবর্তিত হতে পারে।

লাইব্রেরির সাহায্যে টোকেনটি ডিকোড করুন:

import { decodeSdJwtSync } from "@sd-jwt/core";
import { createHash } from "node:crypto";
const hasher = (data, alg) =>
  createHash(alg === "sha-256" ? "sha256" : alg)
    .update(data)
    .digest();
const decoded = decodeSdJwtSync(rawToken, hasher);
const evtPayload = decoded.jwt.payload;
const kbPayload = decoded.kbJwt?.payload;

verifier.example যাচাই করলে demo@provider.example, ডিকোড করা টোকেনটি নিচে দেওয়া টোকেনের মতো দেখতে হবে:

{
  "evtJwtDecodedHeader": {
    "typ": "evt+jwt",
    "alg": "EdDSA",
    "kid": "issuer-key-id"
  },
  "evtJwtDecodedPayload": {
    "iss": "https://provider.example",
    "iat": 12345678901,
    "exp": 12345679901,
    "cnf": {
      "jwk": {
        "kty": "OKP",
        "crv": "Ed25519",
        "x": "pUbLiCkEy123pUbLiCkEy123pUbLiCkEy123"
      }
    },
    "email": "demo@provider.example",
    "email_verified": true
  },
  "kbJwtDecodedHeader": {
    "alg": "EdDSA",
    "typ": "kb+jwt"
  },
  "kbJwtDecodedPayload": {
    "aud": "https://verifier.example",
    "iat": 12345678901,
    "nonce": "rAnDoM123rAnDoM123rAnDoM123rAnDoM123",
    "sd_hash": "hAsH456hAsH456hAsH456hAsH456hAsH456"
  },
  "disclosures": []
}

২. প্রত্যাশিত ভ্যালু ও সেশন দাবি যাচাই করা

পে-লোডের প্রাথমিক ভ্যালু আপনার দেওয়া ও প্রত্যাশিত ভ্যালুর সাথে মিলছে কিনা তা চেক করুন:

  • email_verified: true হতে হবে।
  • email: ফর্মে জমা দেওয়া ইমেল আইডির সাথে মিলতে হবে।
  • aud (দর্শক): আপনার সাইটের অরিজিনের সাথে মিলতে হবে।
  • nonce: আপনার ফর্মে দেওয়া ননসের সাথে মিলতে হবে।
  • iat (ইস্যু করার সময়) এবং exp (মেয়াদ শেষ হওয়ার সময়): টোকেনটি বৈধ সময়সীমার মধ্যে আছে এবং মেয়াদ শেষ হয়ে যায়নি তা কনফার্ম করুন।

৩. ডিএনএস ডেলিগেশন যাচাই করুন

ইমেল আইডি ডোমেনের জন্য _email-verification ডিএনএস রেকর্ড যাচাই করুন। যেমন, demo@gmail.com-এর জন্য, _email-verification.gmail.com TXT রেকর্ড কোয়েরি করুন। এই পরিষেবা প্রদানকারীর জন্য, কোয়েরি অ্যাকাউন্ট পরিষেবা প্রদানকারীর লোকেশন ফেরত দেয়, অর্থাৎ accounts.google.com।

$ dig +short TXT _email-verification.gmail.com
"iss=accounts.google.com"

যাচাই করুন যে ইস্যুকারীর স্কিম হল https:// এবং https://<domain>, EVT-তে iss দাবির সাথে মেলে।

৪. EVT স্বাক্ষর যাচাই করুন

https://<issuer>/.well-known/email-verification থেকে ইস্যুকারীর ডিসকভারি মেটাডেটা ফেচ করুন:

{
  "issuer": "https://accounts.google.com",
  "issuance_endpoint": "https://accounts.google.com/gsi/email-verification/issue",
  "jwks_uri": "https://verifiablecredentials-pa.googleapis.com/.well-known/vc-public-jwks",
  "signing_alg_values_supported": ["Ed25519", "EdDSA"]
}

মেটাডেটাতে issuer ফিল্ড থাকলে, EVT-তে বাইট-ফর-বাইট iss দাবির সাথে সেটি মিলছে কিনা তা যাচাই করুন। jwks_uri থেকে JSON ওয়েব কী সেট ফেচ করুন।

টোকেন প্যাকেজ যাচাই করতে আপনার SD-JWT লাইব্রেরি ব্যবহার করুন। লাইব্রেরি যাচাইকরণ সমন্বয় করে:

  1. ফেচ করা JWKS-এর সাথে EVT-তে ইস্যুকারীর স্বাক্ষর যাচাই করা হচ্ছে।
  2. cnf.jwk-এ ক্ষণস্থায়ী সর্বজনীন কী ব্যবহার করে KB-JWT-তে ব্রাউজারের স্বাক্ষর যাচাই করা হচ্ছে।
  3. 'কী' বাইন্ডিং যাচাই করা হচ্ছে (aud, nonce এবং ডাইজেস্ট হ্যাশ sd_hash)।

Node.js-এ যাচাইকরণের লজিকের উদাহরণ:

import { SDJwtInstance } from "@sd-jwt/core";
import { importJWK, compactVerify } from "jose";
import { createHash } from "node:crypto";
const allowedAlgs = ["Ed25519", "EdDSA", "ES256"];
const evtAlg = decoded.jwt.header.alg;
const kbAlg = decoded.kbJwt?.header.alg;
if (!allowedAlgs.includes(evtAlg) || !allowedAlgs.includes(kbAlg)) {
  throw new Error("Unsupported signing algorithm");
}
const hasher = (data, alg) =>
  createHash(alg === "sha-256" ? "sha256" : alg)
    .update(data)
    .digest();
const sdJwt = new SDJwtInstance({ hasher });
sdJwt.config({
  hasher,
  // Verifier for the Issuer-signed EVT
  verifier: async (data, sig) => {
    const token = `${data}.${sig}`;
    const header = decoded.jwt.header;
    // Match by kid if present, or iterate across matching algorithm keys
    const keysToTry = header.kid
      ? jwksData.keys.filter(k => k.kid === header.kid)
      : jwksData.keys;
    for (const jwk of keysToTry) {
      try {
        const pubKey = await importJWK(jwk, jwk.alg || evtAlg);
        await compactVerify(token, pubKey);
        return true;
      } catch {
        // Try next candidate key
      }
    }
    return false;
  },
  // Verifier for the Key Binding JWT (KB-JWT)
  kbVerifier: async (data, sig) => {
    try {
      const browserJwkKey = evtPayload.cnf?.jwk;
      if (!browserJwkKey) return false;
      const pubKey = await importJWK(browserJwkKey, kbAlg);
      await compactVerify(`${data}.${sig}`, pubKey);
      return true;
    } catch {
      return false;
    }
  },
});
// The library automatically verifies EVT signature, KB-JWT signature, audience, nonce, and sd_hash
const result = await sdJwt.verify(rawToken, {
  kb: {
    expectedNonce: sessionNonce,
    expectedAudience: "https://example.com",
    required: true,
  },
});
const verifiedPayload = result.payload;
if (
  verifiedPayload.email_verified !== true ||
  verifiedPayload.email?.toLowerCase() !== submittedEmail.toLowerCase()
) {
  throw new Error("Token email does not match submitted email");
}

সব ধাপ সফলভাবে সম্পন্ন হলে, আপনি পরিষেবা প্রদানকারীর কাছে ইমেল আইডি যাচাই করেছেন। যাচাইকরণ না হলে, আপনার স্বাভাবিক ফ্লো ব্যবহার করে ব্যবহারকারীকে একটি কনফার্মেশন ইমেল পাঠান।

সমস্যার সমাধান

যাচাইকরণ করা না গেলে বা ব্রাউজার টোকেন না দিলে, নিচে উল্লেখ করা সাধারণ সমস্যাগুলি চেক করুন:

জমা দেওয়ার সময় টোকেন ফিল্ড খালি আছে

  • অরিজিন ট্রায়াল রেজিস্ট্রেশন: কনফার্ম করুন যে Origin-Trial হেডার বা <meta> ট্যাগ পৃষ্ঠায় পরিবেশন করা হয়েছে এবং টোকেনের মেয়াদ শেষ হয়ে যায়নি (Chrome 160 এক্সটেনশনের আগে তৈরি টোকেনের মেয়াদ ১৭ নভেম্বর, ২০২৬-এ শেষ হয়ে যাবে)। থার্ড-পার্টি অরিজিন ট্রায়ালের (Chrome 154+) ক্ষেত্রে, রেজিস্টার করা ট্রায়াল অরিজিন ইস্যুকারীর (https://<issuer-domain>) একই সাইট হতে হবে। আপনি DevTools-এ অ্যাপ্লিকেশন > ফ্রেম > (প্রাসঙ্গিক ফ্রেম বেছে নিন) > অরিজিন ট্রায়াল বিকল্পে গিয়ে কোনও সাইটে অরিজিন ট্রায়ালের স্ট্যাটাস ও টোকেনের মেয়াদ শেষ হওয়ার তারিখ দেখতে পারবেন।
  • ফর্ম মার্ক-আপ: <input type="email" autocomplete="email"> ও <input type="hidden" autocomplete="email-verification-token" nonce="..."> দুটিকেই একই <form> এলিমেন্টের মধ্যে থাকতে হবে (Shadow DOM সীমানা জুড়ে আলাদা আলাদা করে রাখা যাবে না) এবং nonce খালি রাখা যাবে না।
  • আগে জমা দেওয়া বা আবার ব্যবহার করা পৃষ্ঠা: ইমেল আইডি লেখা বা অটোফিল করার পরে ব্রাউজার ব্যাকগ্রাউন্ডে টোকেন নিয়ে আসে। অনুরোধ সম্পূর্ণ হওয়ার আগে জমা দিলে টোকেন খালি থেকে যায়। ব্যবহারকারী তার ইমেল আইডি লেখার পরে ফর্ম জমা দিতে Return বোতামে প্রেস করলে এটি হতে পারে।
  • ব্রাউজার ও পরিষেবা প্রদানকারী সংক্রান্ত পূর্বশর্ত: ব্যবহারকারীকে একই ব্রাউজার প্রোফাইলে অংশগ্রহণকারী পরিষেবা প্রদানকারীর অ্যাকাউন্টে সাইন-ইন করতে হবে এবং Chrome সেটিংসে (chrome://settings/contactInfo) যাচাই করা ইমেল বিকল্প চালু থাকতে হবে।

ইস্যুকারীর স্বাক্ষর যাচাই করা যায়নি

  • kid হেডার নেই: EVT হেডারে kid (কী আইডি) দাবি এবং JWKS ঐচ্ছিক (যেমন, Gmail kid বাদ দেয়)। kid না থাকলে, কী আইডি লুক-আপে ব্যর্থ হওয়ার পরিবর্তে, ইস্যুকারীর jwks_uri-এ সবকটি সম্ভাব্য কী-এর মাধ্যমে পুনরাবৃত্তি করুন।
  • অ্যালগরিদম শনাক্তকারী (Ed25519 এবং EdDSA): Chrome 156 থেকে শুরু করে, Chrome cnf.jwk এবং KB-JWT হেডারের জন্য সম্পূর্ণ-নির্দিষ্ট Ed25519 অ্যালগরিদম শনাক্তকারী (RFC 9864) ব্যবহার করে, যখন ইস্যুকারী এবং লাইব্রেরিগুলি Ed25519 বা EdDSA (ES256-এর পাশাপাশি) নির্দিষ্ট করতে পারে। আপনার JWK ইমপোর্ট এবং যাচাইকরণ লজিক দুটি শনাক্তকারীই গ্রহণ করে কিনা তা নিশ্চিত করুন।
  • ইস্যুকারী (iss) অরিজিন ফর্ম্যাট: DNS TXT রেকর্ডে (_email-verification.<domain>) শুধু হোস্টনেম (iss=accounts.issuer.example) থাকে, যেখানে EVT iss দাবি হল সম্পূর্ণ HTTPS অরিজিন (https://accounts.issuer.example, শেষে কোনও স্ল্যাশ নেই)। তুলনা করার আগে DNS রেকর্ড ভ্যালুতে Prefix https:// যোগ করুন।

কী বাইন্ডিং (KB-JWT) যাচাইকরণ সম্পূর্ণ হয়নি

  • ম্যাচ না করা বা মেয়াদ শেষ হয়ে যাওয়া ননস: নিশ্চিত করুন যে nonce <input> আপনার সার্ভারে অ্যাক্টিভ সেশন ননসের সাথে ম্যাচ করছে এবং অন্য কোনও ট্যাব দ্বারা ওভাররাইট করা হয়নি বা আগের কোনও অনুরোধে ব্যবহার করা হয়নি।
  • দর্শক (aud) মিলছে না: aud দাবি হল যাচাইকারীর HTTPS অরিজিন (https://verifier.example, কোনও পাথ বা ট্রেলিং স্ল্যাশ ছাড়া)।

ইমেল দাবি (email) তুলনা করা যায়নি

  • কেসিং ও ক্যানোনিকালাইজেশন: Chrome 156+ ভার্সন email ক্লেম বাইটের পর বাইট হিসেবে দেখায়, ঠিক যেভাবে ফর্মে লেখা হয়েছে, তবে ব্রাউজারের পুরনো ভার্সন বা প্রোভাইডার ক্যানোনিকালাইজ করা অ্যাড্রেস দেখাতে পারে (যেমন, first.last@example.com-এর জন্য First.Last@example.com)। জমা দেওয়া ফর্মের ভ্যালুর সাথে টোকেনের email ক্লেম ম্যাচ করার সময় কেস-ইনসেনসিটিভ তুলনা ব্যবহার করুন।