अपनी साइट पर ईमेल पते की पुष्टि करने की सुविधा लागू करने के लिए, फ़ॉर्म मार्कअप को अपडेट करें, ताकि टोकन का अनुरोध किया जा सके. साथ ही, आने वाले टोकन के लिए, सर्वर-साइड से होने वाली पुष्टि की सुविधा जोड़ें.
ऑरिजिन ट्रायल के लिए रजिस्टर करना
पुष्टि की प्रोसेस में शामिल साइटों पर, ऑरिजिन ट्रायल की सुविधा कॉन्फ़िगर होनी चाहिए.
- ऑरिजिन ट्रायल के लिए रजिस्टर करना
- ऑरिजिन ट्रायल टोकन उपलब्ध कराना
Chrome 154 से, तीसरे पक्ष के ऑरिजिन ट्रायल की सुविधा उपलब्ध है. हालांकि, इसके लिए एक ज़रूरी शर्त है: ट्रायल के लिए रजिस्टर किया गया ऑरिजिन, टोकन जारी करने वाले के ऑरिजिन के जैसा होना चाहिए. उदाहरण के लिए:
- टोकन जारी करने वाले का डोमेन:
issuer.example - ओटी रजिस्टर करने वाला:
https://issuer.example - JavaScript ऑरिजिन:
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>"सेट करें: फ़ॉर्म सबमिशन की पुष्टि करने के लिए, साइट को सेशन से जुड़ा एक यूनीक नॉनस उपलब्ध कराना होगा.
ईमेल पते की पुष्टि करने वाले टोकन (ईवीटी) की पुष्टि करना
जब उपयोगकर्ता फ़ॉर्म सबमिट करता है, तो आपके सर्वर को छिपाए गए फ़ील्ड से ईमेल पता और टोकन मिलता है. टोकन फ़ील्ड खाली होने का मतलब है कि ब्राउज़र या सेवा देने वाली कंपनी, ईवीपी की सुविधा के साथ काम नहीं करती या उपयोगकर्ता ने पुष्टि की प्रोसेस छोड़ दी है. अगर ऐसा होता है, तो पुष्टि की अपनी मौजूदा प्रोसेस का इस्तेमाल करें. जैसे, ओटीपी या मैजिक लिंक भेजना.
अगर कोई टोकन मौजूद है, तो उसकी पुष्टि इस तरह करें:
- एसडी-जेडब्लयूटी लाइब्रेरी का इस्तेमाल करके, टोकन को पार्स करें.
- अनुमानित वैल्यू और सेशन के दावों की पुष्टि करें.
- डीएनएस डेलिगेशन की पुष्टि करें.
- टोकन जारी करने वाले का मेटाडेटा ढूंढें और जेडब्लयूकेएस फ़ेच करें.
- क्रिप्टोग्राफ़िक सिग्नेचर और कुंजी बाइंडिंग की पुष्टि करें.
1. टोकन को पार्स करना
टोकन, RFC 9901: सेलेक्टिव डिसक्लोज़र जेडब्लयूटी
(एसडी-जेडब्लयूटी+केबी) फ़ॉर्मैट का इस्तेमाल करता है. टोकन को पार्स करने और उसकी पुष्टि करने के लिए, अपने प्लैटफ़ॉर्म के हिसाब से सही लाइब्रेरी का इस्तेमाल करें.
उदाहरण के लिए, Node के लिए
@sd-jwt/core और
jose का इस्तेमाल किया जा सकता है. रॉ फ़ॉर्म में यह इस तरह दिखता है: टोकन जारी करने वाले के हस्ताक्षर वाला जेडब्लयूटी, इसके बाद ज़ीरो या उससे ज़्यादा डिसक्लोज़र, और आखिर में कुंजी बाइंडिंग जेडब्लयूटी. हर कॉम्पोनेंट को टिल्ड से अलग किया जाता है:
<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": []
}
2. अनुमानित वैल्यू और सेशन के दावों की पुष्टि करना
पक्का करें कि पेलोड में मौजूद बुनियादी वैल्यू, आपकी दी गई और अनुमानित वैल्यू से मेल खाती हों:
email_verified: इसकी वैल्यूtrueहोनी चाहिए.email: यह फ़ॉर्म में सबमिट किए गए ईमेल पते से मेल खाना चाहिए.aud(ऑडियंस): यह आपकी साइट के ऑरिजिन से मेल खाना चाहिए.nonce: यह आपके फ़ॉर्म में दिए गए नॉनस से मेल खाना चाहिए.iat(जारी करने की तारीख) औरexp(समयसीमा खत्म होने की तारीख): पुष्टि करें कि टोकन, मान्य समयसीमा के अंदर है और उसकी समयसीमा खत्म नहीं हुई है.
3. डीएनएस डेलिगेशन की पुष्टि करना
ईमेल पते के डोमेन के लिए, _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> ईवीटी में मौजूद iss दावे से मेल खाता है.
4. ईवीटी के सिग्नेचर की पुष्टि करना
टोकन जारी करने वाले का डिस्कवरी मेटाडेटा
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 फ़ील्ड शामिल है, तो पुष्टि करें कि यह ईवीटी में मौजूद iss
दावे से पूरी तरह मेल खाता है. jwks_uri से, JSON Web Key Set फ़ेच करें.
टोकन पैकेज की पुष्टि करने के लिए, अपनी एसडी-जेडब्लयूटी लाइब्रेरी का इस्तेमाल करें. लाइब्रेरी, पुष्टि की प्रोसेस को मैनेज करती है:
- फ़ेच किए गए जेडब्लयूकेएस के हिसाब से, ईवीटी पर टोकन जारी करने वाले के सिग्नेचर की पुष्टि करना.
cnf.jwkमें मौजूद एफ़ेमरल पब्लिक की का इस्तेमाल करके, केबी-जेडब्लयूटी पर ब्राउज़र के सिग्नेचर की पुष्टि करना.- कुंजी बाइंडिंग (
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 के एक्सटेंशन से पहले जनरेट किए गए टोकन, 17 नवंबर, 2026 को खत्म हो जाएंगे). तीसरे पक्ष के ऑरिजिन ट्रायल (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हेडर मौजूद नहीं है: ईवीटी हेडर और जेडब्लयूकेएस में,kid(कुंजी आईडी) दावा ज़रूरी नहीं है. उदाहरण के लिए, Gmail मेंkidशामिल नहीं होता. अगरkidमौजूद नहीं है, तो कुंजी आईडी लुकअप में गड़बड़ी दिखाने के बजाय, टोकन जारी करने वाले केjwks_uriमें मौजूद सभी संभावित कुंजियों को बारी-बारी से देखें.- एल्गोरिदम आइडेंटिफ़ायर (
Ed25519औरEdDSA): Chrome 156 से, Chrome,cnf.jwkऔरKB-JWTहेडर के लिए, पूरी तरह से तय किए गएEd25519एल्गोरिदम आइडेंटिफ़ायर (RFC 9864) का इस्तेमाल करता है. वहीं, टोकन जारी करने वाले और लाइब्रेरी,ES256के साथ-साथEd25519याEdDSAमें से किसी एक को तय कर सकते हैं. पक्का करें कि आपका जेडब्लयूके इंपोर्ट और पुष्टि करने का लॉजिक, दोनों आइडेंटिफ़ायर को स्वीकार करता हो. - टोकन जारी करने वाले (
iss) ऑरिजिन का फ़ॉर्मैट: डीएनएस टीएक्सटी रिकॉर्ड (_email-verification.<domain>) में, सिर्फ़ होस्टनेम (iss=accounts.issuer.example) होता है. वहीं, ईवीटीissदावा, पूरा एचटीटीपीएस ऑरिजिन (https://accounts.issuer.example, आखिर में स्लैश नहीं) होता है. तुलना करने से पहले, डीएनएस रिकॉर्ड की वैल्यू मेंhttps://प्रीफ़िक्स जोड़ें.
कुंजी बाइंडिंग (केबी-जेडब्लयूटी) की पुष्टि नहीं हो पाती
- नॉनस मैच नहीं करता या उसकी समयसीमा खत्म हो गई है: पक्का करें कि
nonceमें दिखाया गया<input>आपके सर्वर पर मौजूद चालू सेशन के नॉनस से मेल खाता हो. साथ ही, यह किसी दूसरे टैब से ओवरराइट न हुआ हो या किसी पिछले अनुरोध में इस्तेमाल न हुआ हो. - ऑडियंस (
aud) मैच नहीं करता:audदावा, पुष्टि करने वाले का एचटीटीपीएस ऑरिजिन (https://verifier.example, पाथ या आखिर में स्लैश नहीं) होता है.
ईमेल दावे (email) की तुलना नहीं हो पाती
- केसिंग और कैननिकलइज़ेशन: Chrome 156 और इसके बाद के वर्शन, फ़ॉर्म में डाले गए
emailदावे को पूरी तरह से दिखाते हैं. हालांकि, ब्राउज़र के पुराने वर्शन या सेवा देने वाली कंपनियां, कैननिकलइज़्ड पता दिखा सकती हैं. उदाहरण के लिए,first.last@example.comके लिएFirst.Last@example.com. टोकन केemailदावे को सबमिट किए गए फ़ॉर्म की वैल्यू से मैच करते समय, केस-इनसेंसिटिव तुलना का इस्तेमाल करें.