TikTok वेबहुक पडताळणी: स्वाक्षरी हेडर आणि ती कशी तपासायची
TikTok चा व्यवसायासाठीचा एपीआय प्रत्येक वेबहुक डिलिव्हरीवर स्वाक्षरी Tiktok-Signature हेडरमध्ये पाठवतो, जो t=<unix सेकंद>,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 कशी नोंदवली जाते आणि ती पडताळली जाते का?
एका API कॉलने, आणि TikTok कोणताही चॅलेंज विनंती दस्तऐवजीकृत करत नाही जी आधी URL तपासते. POST /business/webhook/update/ app_id, सीक्रेट, 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 च्या स्वतःच्या डेव्हलपर ॲपच्या सीक्रेटने सही करते, जे कोणतेही टूल किंवा API देत नाही. easyCoexistence प्रत्येक इव्हेंट येताच ती स्वाक्षरी तपासते, अपयशी ठरलेल्या इव्हेंटला 401 देते, असा बॉडी टाकून देते ज्यातील client_key दुसऱ्या ॲपचे नाव देतो, आणि मग तुमच्याकडे पाठवलेल्या फॉरवर्डवर त्या जोडलेल्या खात्याच्या साइनिंग सीक्रेटने X-EC-Signature मध्ये सही करते.
easyCoexistence फॉरवर्ड करत असलेल्या गोष्टींवर सही कशी करते?
X-EC-Signature हेडरमध्ये, t=<unix>,v1=<hex>, जिथे t फॉरवर्डची वेळ आहे आणि v1 हा t, पूर्णविराम आणि बॉडीचा हेक्स HMAC-SHA256 आहे, जशी ती पाठवली तशीच. की ही खात्याची साइनिंग सीक्रेट आहे, whsec_ आणि त्यानंतर 32 अक्षरे, पूर्ण वापरलेली, प्रीफिक्ससह. स्वतःच्या हेडरपैकी 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_ प्रीफिक्स कापणे. HMAC की संपूर्ण स्ट्रिंग आहे, एकदा दाखवली तशीच.
Claude किंवा ChatGPT वरून set_social_webhook_destination ने किंवा PUT /channels/{id}/webhook ने एंडपॉइंट सेट करा. प्रति कनेक्शन दरमहा US$ 9 पासून सुरू होऊन US$ 0.75 पर्यंत, कनेक्शन वाढवाल तसा दर कमी होतो, पहिले 3 दिवस मोफत.
वारंवार विचारले जाणारे प्रश्न
x-tt-logid म्हणजे काय TikTok वेबहुकमध्ये?
प्रत्येक डिलिव्हरीचा अद्वितीय ID ठेवणारे हेडर. TikTok प्राप्तकर्त्यांना तो लॉग करायला सांगते, कारण TikTok कडे समस्या कळवताना तो विनंती ओळखतो.
नवीन वेबहुक URL पडताळण्यासाठी TikTok चॅलेंज पाठवते का?
व्यवसायासाठीच्या एपीआयसाठी TikTok कोणताही चॅलेंज दस्तऐवजीकृत करत नाही. /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 देखरेख
पडताळले: