TikTok वेबहुक सत्यापित करें: Tiktok-Signature हेडर और उसे जाँचने का तरीका
TikTok का API for Business हर वेबहुक डिलीवरी पर Tiktok-Signature हेडर में सिग्नेचर भेजता है, जिसका रूप t=<unix seconds>,s=<hex> होता है। यहाँ s, t की वैल्यू, एक बिंदु और अनुरोध बॉडी का HMAC-SHA256 है, जिसकी कुंजी डेवलपर ऐप का सीक्रेट है। सत्यापन के लिए बॉडी को जैसी आई थी वैसी लेकर वही HMAC दोबारा निकालें, s से स्थिर-समय तुलना करें और पुराने t को अस्वीकार करें।
easyCoexistence उस हर कमेंट इवेंट पर TikTok का सिग्नेचर जाँचता है जो उसका ऐप पाता है, फिर जुड़े खाते के कमेंट इवेंट आपके HTTPS एंडपॉइंट पर फ़ॉरवर्ड करता है, X-EC-Signature में उस एक खाते के सीक्रेट से सिग्नेचर किए हुए।
Tiktok-Signature के दो हिस्से: डिलीवरी का Unix टाइमस्टैम्प सेकंड में और TikTok द्वारा उसके लिए बनाया गया सिग्नेचर।
TikTok के Node सैंपल में acceptableDelay है, जो सही सिग्नेचर वाली उस डिलीवरी को भी रोकता है जो उससे पुरानी हो।
वह हेडर जिसमें हर डिलीवरी की यूनिक ID होती है, जिसे TikTok समस्या-निवारण के लिए लॉग करने को कहता है।
मेंशन वेबहुक का इवेंट टाइप, जिसकी सब्सक्रिप्शन गाइड उसी सिग्नेचर सत्यापन की ओर इशारा करती है।
easyCoexistence के X-EC-Signature हेडर का सिग्नेचर भाग, t, एक बिंदु और रॉ बॉडी का HMAC-SHA256।
Tiktok-Signature हेडर कैसा दिखता है?
इसमें अल्पविराम से अलग किए गए दो हिस्से होते हैं: t, उस डिलीवरी का Unix टाइमस्टैम्प सेकंड में, और s, सिग्नेचर, जो 64 हेक्साडेसिमल अक्षरों का होता है। TikTok के पन्ने इस नाम को TikTok-Signature, Tiktok-Signature और tiktok-signature लिखते हैं। HTTP हेडर के नाम केस पर ध्यान नहीं देते, इसलिए इसे केस-इन्सेंसिटिव तरीके से पढ़ें, जैसा ज़्यादातर फ़्रेमवर्क पहले से करते हैं। TikTok के सैंपल डिलीवरी के बाकी हेडर:
content-type: application/json;charset=UTF-8
user-agent: tiktok-webhook
tiktok-signature: t=1641974633,s=dc023ece112b3a07d809896fd929928a132168d95d2a2e43aab0105fbb291df8
webhook-schema-version: v1.0
x-tt-logid: 202201120803530102451591650189C78TikTok किन बाइट्स पर सिग्नेचर बनाता है?
t की वैल्यू एक स्ट्रिंग के रूप में, फिर एक बिंदु, फिर बॉडी। TikTok की गाइड इस आखिरी हिस्से को अनुरोध बॉडी की स्ट्रिंगिफ़ाइड JSON कॉपी कहती है, और उसका Node सैंपल पहले से पार्स किए गए ऑब्जेक्ट पर JSON.stringify चलाकर वह कॉपी दोबारा बनाता है। यह TikTok के बाइट्स तभी दोहराता है जब दोनों सीरियलाइज़र स्पेसिंग, कुंजियों के क्रम और एस्केपिंग पर एकमत हों। इसलिए बॉडी को उसी रूप में हैश करें जिस रूप में वह आई थी, किसी भी JSON मिडलवेयर के उसे पढ़ने से पहले।
कौन-सा सीक्रेट कुंजी का काम करता है?
डेवलपर ऐप का सीक्रेट, जो TikTok के डेवलपर पोर्टल पर My Apps, App Detail, Basic Information में मिलता है। यही वैल्यू ऐप पहले से /business/webhook/update/ को secret के रूप में और टोकन एंडपॉइंट को client_secret के रूप में भेजता है। एक सीक्रेट उस हर खाते की डिलीवरी पर सिग्नेचर करता है जिसने ऐप को अधिकृत किया है, इसलिए रिसीवर को हर खाते के लिए अलग कुंजी नहीं चाहिए। न एक्सेस टोकन और न ऐप ID इसमें भाग लेते हैं।
Node.js में इसकी जाँच कैसे करें?
node:crypto और रॉ बॉडी से। नीचे दिया फ़ंक्शन हेडर को बाँटता है, t, बिंदु और बॉडी के बाइट्स पर HMAC दोबारा निकालता है, नतीजे की स्थिर-समय तुलना करता है, और फिर t की उम्र जाँचता है। यह सिग्नेचर भाग का नाम तर्क के रूप में लेता है, इसलिए वही कोड easyCoexistence के फ़ॉरवर्ड भी जाँचता है, जहाँ वह भाग v1 कहलाता है और कुंजी खाते का सिग्नेचिंग सीक्रेट है:
import express from "express";
import { createHmac, timingSafeEqual } from "node:crypto";
// Tiktok-Signature reads t=<unix>,s=<hex>; X-EC-Signature reads t=<unix>,v1=<hex>.
function verifySignature(rawBody, header, secret, name, maxAgeSeconds = 300) {
const parts = {};
for (const item of String(header ?? "").split(",")) {
const i = item.indexOf("=");
if (i > 0) parts[item.slice(0, i).trim()] = item.slice(i + 1).trim();
}
const signature = parts[name];
if (!/^\d+$/.test(parts.t ?? "") || !signature) return false;
const expected = createHmac("sha256", secret)
.update(parts.t + ".")
.update(rawBody) // the bytes exactly as they arrived
.digest("hex");
const a = Buffer.from(expected);
const b = Buffer.from(signature);
if (a.length !== b.length || !timingSafeEqual(a, b)) return false;
return Math.abs(Date.now() / 1000 - Number(parts.t)) <= maxAgeSeconds;
}
const app = express();
// TikTok to your own developer app: the app secret, part s
app.post("/webhooks/tiktok", express.raw({ type: "application/json" }), (req, res) => {
if (!verifySignature(req.body, req.get("tiktok-signature"), process.env.TIKTOK_APP_SECRET, "s")) {
console.warn("TikTok signature rejected, x-tt-logid:", req.get("x-tt-logid"));
return res.sendStatus(401);
}
res.sendStatus(200); // acknowledge first: TikTok retries anything but a 200
enqueue(req.body.toString("utf8")); // its content field is itself a JSON string
});
// easyCoexistence to your endpoint: the account's whsec_ secret, part v1
app.post("/webhooks/easycoexistence", express.raw({ type: "application/json" }), (req, res) => {
if (!verifySignature(req.body, req.get("x-ec-signature"), process.env.EC_SIGNING_SECRET, "v1")) {
return res.sendStatus(401);
}
res.sendStatus(200);
enqueue(req.body.toString("utf8")); // platform, account_id, external_id, entry
});कोई डिलीवरी कितनी पुरानी हो सकती है, इससे पहले आप उसे अस्वीकार करें?
कटऑफ़ TikTok रिसीवर पर छोड़ता है: उसकी गाइड कहती है कि अपनी घड़ी और t के बीच का अंतर निकालें और तय करें कि वह सहनीय है या नहीं। उसका Node सैंपल 5 सेकंड की अनुमति देता है, जो इतना तंग है कि कुछ सेकंड दूर चल रही सर्वर घड़ी असली डिलीवरी भी ठुकरा सकती है। ऊपर का कोड 300 की अनुमति देता है, वह विंडो जो easyCoexistence अपने फ़ॉरवर्ड पर रिसीवर से इस्तेमाल करने को कहता है। माप t से लें, वह डिलीवरी का समय जिस पर सिग्नेचर बना है, बॉडी के create_time से नहीं, जो इवेंट के घटित होने का समय बताता है। TikTok के सैंपल में t, create_time के एक सेकंड बाद आता है।
एंडपॉइंट को क्या जवाब देना चाहिए?
सिग्नेचर सही निकलते ही 200, और काम उसके बाद किया जाए, क्योंकि TikTok किसी और स्टेटस को विफल डिलीवरी मानता है और उसे दोबारा भेजता है। जो सिग्नेचर मेल नहीं खाता, उस पर TikTok का सैंपल 4xx स्टेटस लौटाता है और x-tt-logid हेडर लॉग करता है, जो अनुरोध की पहचान करता है अगर आप TikTok से समस्या की रिपोर्ट करें। बॉडी में client_key ऐप का नाम बताता है, इसलिए उसे अपनी ऐप ID से मिलाना एक आसान दूसरी जाँच है।
कॉलबैक URL कैसे रजिस्टर होता है, और क्या उसकी पुष्टि होती है?
एक एपीआई कॉल से, और TikTok कोई ऐसा चैलेंज अनुरोध दस्तावेज़ित नहीं करता जो पहले यूआरएल की जाँच करे। POST /business/webhook/update/ लेता है app_id, secret, event_type और एक HTTPS callback_url: पब्लिशिंग इवेंट के लिए VIDEO, comment.update के लिए COMMENT और, Mentions API पर, brand.mention.event के लिए BRAND_MENTION। ये तीनों एक ही तरह से सिग्नेड आते हैं, और GET /business/webhook/list/ दिखाता है कि किस इवेंट टाइप के लिए कौन-सा URL रजिस्टर है। उत्पत्ति का प्रमाण हर डिलीवरी पर सिग्नेचर है।
क्या easyCoexistence के फ़ॉरवर्ड किए गए इवेंट पर Tiktok-Signature जाँचा जा सकता है?
नहीं, और इसकी ज़रूरत भी नहीं। TikTok उन डिलीवरी पर easyCoexistence के अपने डेवलपर ऐप के सीक्रेट से सिग्नेचर करता है, जो कोई टूल या एपीआई नहीं देता। easyCoexistence हर इवेंट आते ही वह सिग्नेचर जाँचता है, जो विफल हो उसे 401 देता है, ऐसी बॉडी को अनदेखा करता है जिसका client_key किसी दूसरे ऐप का नाम बताए, और फिर आपके लिए फ़ॉरवर्ड को X-EC-Signature में उस जुड़े हुए खाते के सिग्नेचिंग सीक्रेट से सिग्नेचर करता है।
easyCoexistence अपने फ़ॉरवर्ड पर सिग्नेचर कैसे करता है?
X-EC-Signature हेडर में, t=<unix>,v1=<hex>, जहाँ t फ़ॉरवर्ड का समय है और v1, t, एक बिंदु और जैसी भेजी गई वैसी बॉडी का hex HMAC-SHA256 है। कुंजी उस खाते का सिग्नेचिंग सीक्रेट है, जो whsec_ और उसके बाद 32 अक्षरों से बनता है, और उसे पूरा, prefix समेत, इस्तेमाल किया जाता है। अपने हेडर में easyCoexistence सिर्फ Content-Type और यही हेडर सेट करता है, कोई इवेंट हेडर नहीं। इसलिए इवेंट का नाम entry.event से पढ़ें:
POST https://hooks.example.com/tiktok/
Content-Type: application/json
X-EC-Signature: t=1793318405,v1=<HMAC_SHA256_HEX>
{"platform":"tiktok","account_id":"<ACCOUNT_ID>","external_id":"<TIKTOK_OPEN_ID>","entry":{"event":"comment.update","create_time":1793318400,"content":{...}}}
v1 = hex(HMAC-SHA256(key = "whsec_<SECRET>", message = "1793318405." + raw body))सिग्नेचिंग सीक्रेट बदलने पर क्या होता है?
नया सीक्रेट अगले फ़ॉरवर्ड से सिग्नेचर करता है। set_social_webhook_destination या PUT /channels/{id}/webhook फिर से कॉल करने पर नया सीक्रेट मिलता है और पुराना तुरंत रिटायर हो जाता है। हर फ़ॉरवर्ड सिर्फ़ एक बार भेजा जाता है, इसलिए स्विच के दौरान आपके सर्वर द्वारा ठुकराया गया इवेंट खो जाता है। नया सीक्रेट तैनात होने तक कुछ मिनट दोनों सीक्रेट स्वीकार करें। चैनल और पोस्ट के स्टेटस इवेंट एक अलग सीक्रेट इस्तेमाल करते हैं, वह जो Dashboard, Profile, Developers से आता है, और वे X-EC-Event और X-EC-Delivery हेडर के साथ आते हैं, लगभग 33 घंटे तक रीट्राई होते हुए।
आम गड़बड़ियाँ
- फ़्रेमवर्क द्वारा पहले से पार्स की गई बॉडी का सत्यापन। JSON मिडलवेयर एक ऑब्जेक्ट थमाता है, और उसे दोबारा सीरियलाइज़ करने से TikTok के बाइट्स बदल सकते हैं। वेबहुक रूट पर रॉ बॉडी पढ़ें।
- सिग्नेचर विफल होने वाली डिलीवरी पर 200 देना। TikTok 200 देखते ही उस इवेंट को भेजना बंद कर देता है, इसलिए गलत कॉन्फ़िगर की गई जाँच द्वारा ठुकराया गया असली इवेंट खो जाता है। 4xx देने पर TikTok 72 घंटे तक रीट्राई करता रहता है।
- सिग्नेचर की तुलना === से करना, जैसा TikTok का सैंपल करता है। timingSafeEqual जैसी स्थिर-समय तुलना यह नहीं बताती कि नकली सिग्नेचर का कितना हिस्सा मेल खाया।
- easyCoexistence के सीक्रेट को Base64-डिकोड करना या उसका whsec_ prefix काटना। HMAC की कुंजी पूरी स्ट्रिंग है, ठीक वैसी जैसी वह एक बार दिखाई गई थी।
एंडपॉइंट set_social_webhook_destination से Claude या ChatGPT में, या PUT /channels/{id}/webhook से सेट करें। US$ 9 से US$ 0.75 प्रति कनेक्शन प्रति माह, कनेक्शन जोड़ने के साथ घटते हुए, पहले 3 दिन मुफ़्त।
अक्सर पूछे जाने वाले सवाल
x-tt-logid TikTok वेबहुक में क्या है?
एक हेडर जिसमें हर डिलीवरी की यूनिक ID होती है। TikTok रिसीवर से इसे लॉग करने को कहता है, क्योंकि यह अनुरोध की पहचान करता है जब आप TikTok से समस्या की रिपोर्ट करते हैं।
क्या TikTok नए वेबहुक URL की पुष्टि के लिए चैलेंज भेजता है?
TikTok अपने API for Business के लिए कोई चैलेंज दस्तावेज़ित नहीं करता। /business/webhook/update/ कॉल URL रजिस्टर करती है, और फिर डिलीवरी Tiktok-Signature के साथ आती हैं, जिन्हें आपका सर्वर जाँचता है।
मेरा TikTok वेबहुक सिग्नेचर कभी मेल क्यों नहीं खाता?
इनपुट और कुंजी जाँचें: HMAC में t, एक बिंदु और रॉ बॉडी उसी रूप में होनी चाहिए जैसी वह आई थी, कुंजी ऐप सीक्रेट हो, और तुलना s= के बाद की वैल्यू से हो, पूरे हेडर से नहीं।
easyCoexistence द्वारा फ़ॉरवर्ड किए गए TikTok इवेंट कैसे सत्यापित करूँ?
X-EC-Signature और वेबहुक डेस्टिनेशन सेट करते समय दिखाए गए सिग्नेचिंग सीक्रेट से: t, एक बिंदु और रॉ बॉडी पर HMAC-SHA256 दोबारा निकालें, उसकी तुलना v1 से करें, और 5 मिनट से पुराना t अस्वीकार करें।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित