TikTok वेबहुकको हस्ताक्षर प्रमाणित गर्ने तरिका: Tiktok-Signature हेडर र त्यसको जाँच
TikTok को API for Business ले प्रत्येक वेबहुक डेलिभरीलाई t=<unix seconds>,s=<hex> रूपको Tiktok-Signature हेडरमा हस्ताक्षर गर्छ। यहाँ 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 को डेभलपर पोर्टलमा माई एप्स, एप डिटेल, बेसिक इन्फर्मेसनमा भेटिन्छ। एपले यही मान /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 सँग तुलना गर्नु सरल दोस्रो जाँच हो।
कलब्याक यूआरएल कसरी दर्ता हुन्छ, र यो प्रमाणित हुन्छ?
एउटै API कलबाट, र 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/ ले इभेन्ट प्रकारका लागि दर्ता भएको यूआरएल देखाउँछ। मूल स्रोतको प्रमाण हरेक डेलिभरीमा रहेको हस्ताक्षर नै हो।
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 hex मान हो। कुञ्जी खाताको हस्ताक्षर गर्ने गोप्य कुञ्जी हो, 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 फेरि कल गर्दा नयाँ कुञ्जी फर्किन्छ र पुरानो तुरुन्तै रद्द हुन्छ, र हरेक फर्वार्ड एक पटक मात्र पठाइन्छ, त्यसैले बदलिने बेलामा तपाईंको सर्भरले अस्वीकार गरेको इभेन्ट हराउँछ। नयाँ कुञ्जी लागू हुँदा केही मिनेटसम्म दुबै कुञ्जी स्वीकार गर्नुहोस्। च्यानल र पोस्टसम्बन्धी स्ट्याटस इभेन्टहरूले अर्को गोप्य कुञ्जी प्रयोग गर्छन्, जुन ड्यासबोर्ड, प्रोफाइल, डेभलपर्समा गरिन्छ, र X-EC-Event र X-EC-Delivery हेडरसहित आइपुग्छन्, लगभग 33 घण्टासम्म पुनः प्रयास गरिँदै।
सामान्य गल्तीहरू
- फ्रेमवर्कले पहिले नै पार्स गरेको बडी प्रमाणित गर्नु। JSON मिडलवेयरले वस्तु दिन्छ, र त्यसलाई फेरि सिरियलाइज गर्दा TikTok का बाइटहरू परिवर्तन हुन सक्छ; वेबहुक राउटमा कच्चा बडी पढ्नुहोस्।
- हस्ताक्षर असफल भएको डेलिभरीमा 200 दिनु। TikTok ले 200 देखेपछि इभेन्ट पठाउन रोक्छ, त्यसैले गलत कन्फिगर गरिएको जाँचले अस्वीकार गरेको साँचो इभेन्ट हराउँछ; 4xx ले TikTok लाई 72 घण्टासम्म पुनः प्रयास गर्न दिन्छ।
- हस्ताक्षरहरू === ले तुलना गर्नु, जसरी TikTok को नमुनाले गर्छ। स्थिर समय तुलना जस्तै timingSafeEqual ले नक्कली हस्ताक्षरको कति भाग मिल्यो भनेर खुलासा गर्दैन।
- easyCoexistence को गोप्य कुञ्जीलाई Base64 डिकोड गर्नु वा त्यसको whsec_ उपसर्ग काट्नु। HMAC कुञ्जी भनेको एकपटक देखाइएको ठ्याक्कै मानसहितको सम्पूर्ण स्ट्रिङ हो।
एन्डपोइन्ट set_social_webhook_destination बाट Claude वा ChatGPT बाट, वा PUT /channels/{id}/webhook बाट सेट गर्नुहोस्। US$ 9 देखि US$ 0.75 सम्म प्रति कनेक्सन प्रति महिना, जडान थपिँदा घट्दै जाने, पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
x-tt-logid वेबहुकमा के हो?
प्रत्येक डेलिभरीको अद्वितीय ID बोक्ने हेडर। TikTok ले यसलाई लग गर्न रिसिभरहरूलाई भन्छ, किनभने TikTok लाई समस्या रिपोर्ट गर्दा यसले अनुरोध पहिचान गर्छ।
TikTok ले नयाँ वेबहुक यूआरएल प्रमाणित गर्न चुनौती पठाउँछ?
API for Business का लागि कुनै पनि चुनौती दस्तावेजीकरण गरिएको छैन। /business/webhook/update/ कलले यूआरएल दर्ता गर्छ, र त्यसपछि डेलिभरीहरू Tiktok-Signature सहित आइपुग्छन्, जुन तपाईंको सर्भरले जाँच्छ।
मेरो TikTok वेबहुक हस्ताक्षर किन कहिल्यै मिल्दैन?
इनपुट र कुञ्जी जाँच्नुहोस्: HMAC ले t, डट र कच्चा बडी प्राप्त भएजस्तै ढाक्नुपर्छ, एप गोप्य कुञ्जी प्रयोग गर्नुपर्छ, र सम्पूर्ण हेडरको सट्टा s= पछिको मानसँग तुलना गर्नुपर्छ।
easyCoexistence ले फर्वार्ड गरेका TikTok इभेन्टहरू कसरी प्रमाणित गर्ने?
X-EC-Signature र गन्तव्य सेट गर्दा देखाइएको हस्ताक्षर गर्ने गोप्य कुञ्जीसँग: t, डट र कच्चा बडीमाथि HMAC-SHA256 पुनः गणना गर्नुहोस्, v1 सँग तुलना गर्नुहोस्, र 5 मिनेटभन्दा पुरानो t अस्वीकार गर्नुहोस्।
पढ्दै जानुहोस्
दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।
प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।
- 3 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको