আরও বিস্তারিত জানতে, আপনি মক ইমেল পরিষেবা প্রদানকারী ডেমো কোড দেখে নিতে পারেন এবং ইমেল যাচাইকরণ এপিআই ও ইমেল যাচাইকরণ প্রোটোকল প্রস্তাবে উল্লিখিত ইস্যুকারী ধাপগুলি দেখতে পারেন।
ইস্যুকারী হিসেবে, আপনাকে অরিজিন ট্রায়ালের জন্য সাইন-আপ করতে বা টোকেন দিতে হবে না কারণ রিলাইং পার্টি সাইট ব্রাউজারের আচরণ ট্রিগার করে। আপনার এন্ডপয়েন্ট সেইসব অনুরোধের উত্তর দেওয়ার জন্য কনফিগার করা আছে কিনা তা নিশ্চিত করুন।
ইস্যুকারী ডিসকভারি কনফিগার করুন
আপনার ডোমেনের কোনও ইমেল আইডি বেছে নেওয়া হলে, ব্রাউজারকে অটোমেটিক আপনার যাচাইকরণ এন্ডপয়েন্ট খুঁজে পাওয়ার অনুমতি দিতে,
DNS এবং .well-known HTTP এন্ডপয়েন্ট ব্যবহার করে আপনার কনফিগারেশন প্রকাশ করুন।
ডিএনএস ডেলিগেট রেকর্ড কনফিগার করুন
আপনার ইমেল ডোমেনে একটি DNS TXT রেকর্ড কনফিগার করুন যা আপনার ইস্যুকারী শনাক্তকারীকে যাচাইকরণ কর্তৃপক্ষকে অর্পণ করে। আপনার পরিকাঠামোর উপর নির্ভর করে এইসব শনাক্তকারী একই ডোমেন ব্যবহার করতে পারে।
রেকর্ড ফর্ম্যাট: _email-verification.<email-domain>
উদাহরণ জোন ফাইল:
_email-verification.example.com IN TXT "iss=accounts.issuer.example"
iss= ভ্যালু অবশ্যই একটি খালি, ক্যানোনিকাল ছোট হাতের হোস্টনেম (যেমন,
iss=accounts.issuer.example) হতে হবে, যাতে কোনও স্কিম (https://), পোর্ট, পাথ বা
বড় হাতের অক্ষর থাকবে না। Chrome এমন রেকর্ড বাতিল করে দেয় যাতে হোস্টনেম নয় এমন কম্পোনেন্ট
থাকে।
.well-known/email-verification এন্ডপয়েন্ট হোস্ট করুন
/.well-known/ পাথের অধীনে আপনার ইস্যুকারী ডোমেনে একটি JSON মেটাডেটা ফাইল হোস্ট করুন।
এই ফাইলটি আপনার ইস্যু করার ক্ষমতা এবং আপনার পরিকাঠামো সমর্থন করে এমন ক্রিপ্টোগ্রাফিক সাইনিং অ্যালগরিদমকে
আউটলাইন করে।
এন্ডপয়েন্ট: https://<issuer-domain>/.well-known/email-verification
উত্তরের উদাহরণ:
{
"issuer": "https://accounts.issuer.example",
"issuance_endpoint": "https://accounts.issuer.example/email-verification/issuance",
"jwks_uri": "https://accounts.issuer.example/.well-known/vc-public-jwks",
"signing_alg_values_supported": ["Ed25519", "EdDSA", "ES256"]
}
মেটাডেটা প্রপার্টি:
issuer: আপনার ইস্যুকারীর অরিজিন (https://<issuer-domain>, শেষে কোনও স্ল্যাশ থাকবে না)। মেটাডেটা ফাইল যে অরিজিন থেকে পরিবেশন করা হচ্ছে তার সাথে বাইট-ফর-বাইট মিলতে হবে।issuance_endpoint: টোকেন ইস্যু করারPOSTঅনুরোধ গ্রহণ করে এমন HTTPS URL.jwks_uri: আপনার সর্বজনীন JSON ওয়েব কী সেট (JWKS) পরিবেশনকারী HTTPS URL.signing_alg_values_supported: কাজ করে এমন JWS সাইনিং অ্যালগরিদমের অ্যারে।
.well-known/web-identity এন্ডপয়েন্ট হোস্ট করুন
আপনি হয়ত Federated Credentials (FedCM)
API-এর অংশ হিসেবে
আগে থেকেই অতিরিক্ত .well-known JSON রিসোর্স প্রয়োগ করেছেন। এই রিসোর্স আপনার অ্যাকাউন্টের এন্ডপয়েন্ট এবং লগ-ইন URL-এর
লিঙ্ক প্রদান করে।
এন্ডপয়েন্ট: https://<domain>/.well-known/web-identity
উত্তরের উদাহরণ:
{
"accounts_endpoint": "https://accounts.issuer.example/accounts",
"login_url": "https://accounts.issuer.example/login"
}
অ্যাকাউন্ট এন্ডপয়েন্ট ব্যবহার করা
FedCM API-এর অ্যাকাউন্ট এন্ডপয়েন্ট বর্তমানে সাইন-ইন করা অ্যাকাউন্টের তালিকা প্রদান করে। নিম্নলিখিত উদাহরণে একটি সংক্ষিপ্ত উত্তর দেখানো হয়েছে। আরও বিবরণের জন্য, পরিচয় প্রদানকারী প্রয়োগ করার নির্দেশিকা দেখুন।
এন্ডপয়েন্ট: .well-known/web-identity-এ উল্লেখ করা হয়েছে
নিচে একটি উদাহরণ উত্তর দেওয়া হল:
{
"accounts": [
{
"id": "demo-example",
"name": "Demo User",
"email": "demo@example.com",
"given_name": "Demo"
}
]
}
Login Status API-এর সাথে ইন্টিগ্রেট করা
ব্যবহারকারীর অবশ্যই পরিষেবা প্রদানকারীর সাথে একটি অ্যাক্টিভ সেশন থাকতে হবে এবং আপনাকে অবশ্যই লগ-ইন স্ট্যাটাস API ব্যবহার করে ব্রাউজারকে তা জানাতে হবে।
ব্যবহারকারী সফলভাবে সাইন-ইন বা সাইন-আউট করলে, ম্যাচ করা HTTP উত্তর হেডার পরিবেশন করুন:
Set-Login: logged-in
Set-Login: logged-out
অথবা, আপনার ওয়েব অ্যাপ্লিকেশন কনটেক্সটে JavaScript ব্যবহার করে স্ট্যাটাস আপডেট করুন:
navigator.login.setStatus("logged-in");
navigator.login.setStatus("logged-out");
ইস্যু করার অনুরোধ ম্যানেজ করা
আপনার issuance_endpoint একটি application/json POST অনুরোধ পায় যাতে
Signature, Signature-Input ও Signature-Key-এর জন্য email কী ও HTTP মেসেজ
সিগনেচার হেডার থাকে।
আপনার এনভায়রনমেন্টের জন্য স্ট্রাকচার্ড হেডার ও HTTP মেসেজ সিগনেচার সাপোর্ট করে এমন লাইব্রেরি ব্যবহার করুন। Node.js-এ আপনি
structured-headers এবং
http-message-sig ব্যবহার করতে পারবেন।
সম্পূর্ণ অনুরোধের ফর্ম্যাট:
POST /email-verification/issuance HTTP/1.1
Host: provider.example
Accept: application/json
Content-Digest: sha-256=:aBc123aBc123aBc123aBc123aBc123=:
Content-Type: application/json
Sec-Fetch-Dest: email-verification
Signature: sig=:+dEf567dEf567/dEf567dEf567dEf567/dEf567==:
Signature-Input: sig=("@method" "@authority" "@path" "content-digest" "signature-key");created=1786455840
Signature-Key: sig=hwk;alg="Ed25519";crv="Ed25519";kty="OKP";x="gHi890_gHi890_gHi890"
{email: "demo@example.com"}
অনুরোধ পার্স ও যাচাই করুন:
- সেশন যাচাইকরণ: অনুরোধের সাথে পাঠানো আপনার ফার্স্ট-পার্টি সেশন কুকি যাচাই করুন। ব্যবহারকারীকে অবশ্যই যাচাই করতে হবে।
Sec-Fetch-Destহেডার:email-verification-এ সেট করা আছে।- HTTP মেসেজ সিগনেচার:
Signature-Key-এ ক্ষণস্থায়ী সর্বজনীন কী ব্যবহার করে অনুরোধের সিগনেচার যাচাই করুন এবংContent-Digestযাচাই করুন। Chrome 156 থেকে,Signature-Keyহেডারেalg="Ed25519"অন্তর্ভুক্ত থাকে, এরhwkপ্যারামিটারে;"Ed25519"এবং"EdDSA"গ্রহণ করুন এবংalg-কে আগের Chrome ভার্সন দ্বারা বাদ দেওয়ার অনুমতি দিন। - পেলোড: JSON বডিতে
emailযাচাইকরণের জন্য অনুরোধ করা স্ট্রিং থাকে।
ইস্যু সংক্রান্ত উত্তর
সেশন ও অনুরোধের টোকেন যাচাই করার পরে, আপনার প্ল্যাটফর্মের জন্য উপযুক্ত লাইব্রেরি ব্যবহার করে JSON হিসেবে ফেরত পাঠানো একটি স্বাক্ষরিত
সিলেক্টিভ ডিসক্লোজার JWT (SD-JWT) তৈরি করুন। যেমন, Node-এর জন্য আপনি
@sd-jwt/core এবং
jose ব্যবহার করতে পারেন।
র পে-লোড ফর্ম্যাটটি এই ধরনের হতে হবে:
{
"iss": "https://accounts.issuer.example",
"iat": 1780272000,
"exp": 1780272300,
"cnf": {
"jwk": {
"kty": "EC",
"crv": "P-256",
"x": "pUbLiCKeY123pUbLiCKeY123pUbLiCKeY123",
"y": "pUbLiCKeY456pUbLiCKeY456pUbLiCKeY456"
}
},
"email": "demo@example.com",
"email_verified": true
}
টোকেন তৈরি, স্বাক্ষর ও ফেরত দিন:
import { importJWK, CompactSign } from "jose";
import { SDJwtInstance } from "@sd-jwt/core";
import crypto from "node:crypto";
// Issuer private key from secure storage
const privateKey = await importJWK(PRIVATE_KEY_JWK, "EdDSA");
const origin = url.origin;
const currentTime = Math.floor(Date.now() / 1000);
const evtPayload = {
iss: origin,
iat: currentTime,
exp: currentTime + 300, // 5 minutes
cnf: {
jwk: browserJwk,
},
email: payload.email, // exactly as received in payload
email_verified: true,
};
const sdJwt = new SDJwtInstance({
signer: async (data) => {
const [headerB64, payloadB64] = data.split(".");
const header = JSON.parse(Buffer.from(headerB64, "base64url").toString());
const payload = Buffer.from(payloadB64, "base64url");
const signed = await new CompactSign(payload).setProtectedHeader(header).sign(privateKey);
return signed.split(".").pop()!;
},
signAlg: "EdDSA",
hasher: async (data, alg) => {
const nodeAlg = alg.replace("-", "");
return new Uint8Array(crypto.createHash(nodeAlg).update(data).digest());
},
hashAlg: "sha-256",
saltGenerator: async () => crypto.randomBytes(16).toString("base64url"),
});
const issuanceToken = await sdJwt.issue(evtPayload, undefined, {
header: {
alg: "EdDSA",
kid: PRIVATE_KEY_JWK.kid,
typ: "evt+jwt",
},
});
return sendResponse({ issuance_token: issuanceToken, }, 200);
ফলাফল হিসেবে পাওয়া উত্তরের মূল অংশটি দেখতে অনেকটা এইরকম:
{
"issuance_token": "tOkEn123tOkEn123tOkEn123...~"
}
ইমেল যাচাইকরণ টোকেন তৈরি ও স্বাক্ষর করার পরে, ব্রাউজার যাচাইকরণের জন্য এই টোকেনটি যাচাইকারী সাইটে পাঠায়।
সমস্যার সমাধান
ব্রাউজার আপনার এন্ডপয়েন্টের সাথে যোগাযোগ না করলে বা ইস্যু করা টোকেন বাতিল করলে, নিম্নলিখিত সাধারণ সমস্যাগুলি চেক করুন:
ব্রাউজার কখনও accounts_endpoint বা issuance_endpoint-এ কল করে না
- লগ-ইন স্ট্যাটাস সেট করা নেই: ব্যবহারকারী সাইন-ইন করেছেন কিনা তা জানলে তবেই Chrome আপনার এন্ডপয়েন্ট কোয়েরি করে। আপনার সাইন-ইন ফ্লো
Set-Login: logged-inHTTP হেডার সেট করে বাnavigator.login.setStatus("logged-in")কল করে কিনা তা নিশ্চিত করুন। - সেশন কুকি ব্লক করা হয়েছে (
SameSite=None): ব্রাউজার অন্য সাইটে থাকা কোনও রিলাইং পার্টির থেকে আপনারaccounts_endpointএবংissuance_endpointফেচ করে। যেহেতু এগুলি ক্রস-সাইট অনুরোধ, তাই আপনার সেশন কুকিতেSameSite=None; Secureথাকতেই হবে।SameSite=Laxকুকি একই সাইটের যাচাইকারীকে পরীক্ষা করার সময় কাজ করে, কিন্তু ক্রস-সাইট অনুরোধের ক্ষেত্রে এটি বাদ দেওয়া হয়। - ডিসকভারি বা অ্যাকাউন্ট অমিল: যাচাই করুন যে
_email-verification.<email-domain>ক্যানোনিকাল ছোট হাতের হোস্টনেম (iss=<issuer-domain>,https://, একটি পোর্ট, একটি পাথ বা বড় হাতের অক্ষর ছাড়া) সহ একটি একক TXT রেকর্ড রিটার্ন করে, দুটি.well-knownএন্ডপয়েন্টইContent-Type: application/jsonরিটার্ন করে,.well-known/email-verification-এ একটিissuerআছে যাhttps://<issuer-domain>-এর সাথে বাইট-ফর-বাইট মেলে এবংaccounts_endpointউত্তরে এমন একটি অ্যাকাউন্ট অন্তর্ভুক্ত থাকে যারemailপ্রবেশ করা ঠিকানার সাথে মেলে। .well-known/email-verification-এ কাজ করে না এমন সাইনিং অ্যালগরিদম: Chrome 154 ও 155-এsigning_alg_values_supported-এ"EdDSA"প্রয়োজন, অন্যদিকে Chrome 156+ ও IETF স্পেসিফিকেশনে"Ed25519"কাজ করে। ট্রানজিশনের সময় দুটি["Ed25519", "EdDSA"]-এরই বিজ্ঞাপন দিন যাতে Chrome Stable আপনার ডিসকভারি মেটাডেটা বাতিল না করে।
ইস্যু করার অনুরোধ যাচাই করা যায়নি
Sec-Fetch-Destহেডার বানান: Chrome 154+ ভার্সনSec-Fetch-Dest: email-verification(হাইফেন সহ) পাঠায়, যেখানে Chrome 153 ভার্সনemailverification(হাইফেন ছাড়া) পাঠায়। রোল-আউটের সময় দুটি ভ্যালুই গ্রহণ করা হবে।- প্রক্সির পিছনে HTTP মেসেজ সিগনেচার (
@authority) না মেলা: RFC 9421 সিগনেচার যাচাই করার সময়,@authorityকম্পোনেন্টটি সর্বজনীন হোস্টকে প্রতিফলিত করে। আপনার সার্ভার যদি রিভার্স প্রক্সি বা লোড ব্যালেন্সারের পিছনে থাকে, তাহলে ইন্টার্নাল হোস্টনেমের পরিবর্তেX-Forwarded-Host(বা আপনার পাবলিক অরিজিন) ব্যবহার করে যাচাইকরণ URL আবার তৈরি করুন এবং JSON পার্স করার আগে র-অনুরোধের বডি বাইটের উপরContent-Digestগণনা করুন।
ব্রাউজার রিটার্ন করা issuance_token প্রত্যাখ্যান করে
- পরিবর্তিত বা ক্যানোনিকালাইজ করা
emailদাবি: Chrome 156 থেকে, ব্রাউজার চেক করে যে EVTemailদাবিটি অনুরোধ করাemailবাইট-ফর-বাইট ম্যাচ করছে কিনা। আপনার ব্যাকএন্ড যদি কোনও ক্যানোনিকাল অ্যাকাউন্ট ফর্ম্যাটে ঠিকানাটি স্বাভাবিক করে (যেমনfirst.LAST@example.com-এর অনুরোধ করা হলেFirst.Last@example.comফেরত দেওয়া), তাহলে Chrome টোকেনটি ড্রপ করে। ব্যবহারকারীর অ্যাকাউন্টের সাথে অনুরোধটি মিলিয়ে দেখুন, তবে অনুরোধের বডিতে পাওয়া সঠিকemailস্ট্রিং ফেরত দিন। - শেষের দিকে টিল্ড (
~) নেই: কোনও ডিসক্লোজার না থাকলেও,issuance_tokenঅবশ্যই একটি বৈধ SD-JWT হতে হবে যার শেষে টিল্ড (<Issuer-signed-JWT>~) থাকবে, যাতে ব্রাউজার<KB-JWT>যোগ করতে পারে। issবাcnf.jwkমিলছে না: EVTissদাবিটি যেন আপনার.well-known/email-verificationমেটাডেটার সাথে মিলে যাওয়া সঠিক HTTPS অরিজিন (https://<issuer-domain>, শেষে কোনও স্ল্যাশ নেই) হয় এবংcnf.jwkযেনSignature-Keyহেডার থেকে ব্রাউজারের ক্ষণস্থায়ী সর্বজনীন কী এম্বেড করে তা নিশ্চিত করুন।