Provjera webhooka na Facebooku: hub.challenge i X-Hub-Signature-256
Facebook provjerava endpoint webhooka GET zahtjevom s hub.mode postavljenim na subscribe, hub.verify_token i hub.challenge; endpoint provjerava token u odnosu na onaj u nadzornoj ploči aplikacije i kao tijelo odgovora vraća vrijednost hub.challenge. Svaki događaj zatim stiže kao POST potpisan u X-Hub-Signature-256: sha256= nakon kojeg slijedi HMAC-SHA256 payloada s ključem App Secret.
easyCoexistence obrađuje Metinu stranu za svaku stranicu koju povežete: njegova aplikacija odgovara na hub.challenge, provjerava X-Hub-Signature-256 i pretplaćuje stranicu na feed, poruke i spominjanja, a zatim proslijeđuje događaje na vaš HTTPS endpoint potpisane s X-EC-Signature i tajnim ključem za tu stranicu.
Vrijednost koju hub.mode uvijek nosi u Metinom zahtjevu za provjeru; hub.challenge je cijeli broj koji treba vratiti.
Prefiks za X-Hub-Signature-256, nakon kojeg slijedi SHA256 potpis koji Meta generira iz payloada i App Secreta.
Koliko brzo endpoint Messenger webhooka treba odgovoriti na svaku obavijest sa 200 OK.
Broj neuspjelih isporuka prije upozorenja Webhooks Disabled i prekida pretplate aplikacije na stranicu.
Koliko dugo Meta ponavlja neuspjelu obavijest stranice, sa sve manjom učestalošću, prije nego je odbaci.
Što sadrži Metin zahtjev za provjeru?
GET na URL povratnog poziva, poslan kad je proizvod Webhooks konfiguriran u nadzornoj ploči aplikacije ili kad se pretplata izradi putem /{app-id}/subscriptions. Uz njega dolaze tri parametra upita:
- hub.mode: uvijek subscribe.
- hub.challenge: cijeli broj koji endpoint mora vratiti.
- hub.
verify_token: niz koji je unesen u polje Verify Token u nadzornoj ploči. - PHP pretvara točke u donje crte, pa ih čita kao
hub_mode,hub_challengeihub_verify_token.
Kako endpoint treba odgovoriti?
Odgovorom 200 čije je cijelo tijelo vrijednost hub.challenge, ali samo ako je hub.mode subscribe i hub.verify_token se podudara; sve ostalo dobiva 403, kao u Metinoj oglednoj aplikaciji. Nadzorna ploča javlja je li endpoint prošao, a /{app-id}/subscriptions odgovara uspjehom ili pogreškom. Endpoint treba HTTPS s važećim TLS ili SSL certifikatom, budući da certifikati s vlastitim potpisom nisu podržani.
Kako se izračunava X-Hub-Signature-256?
Kao HMAC-SHA256 payloada zahtjeva s ključem App Secret, zapisan malim slovima heksadecimalno iza sha256=. Metin vodič za Messenger dodaje da potpis obuhvaća payload s Unicode znakovima zapisanim u escape obliku, pa se niz kao äöå računa kao \u00e4\u00f6\u00e5: heširajte sirovo tijelo točno kako je primljeno, nikad dekodiranu ili ponovno zapisanu kopiju. Meta kaže da je provjera neobavezna, ali je snažno preporučuje.
Kako se to provjerava u kôdu?
Čuvajte sirove bajtove, izračunajte HMAC, usporedite u stalnom vremenu, pa tek onda parsirajte. Flaskova get_data vraća tijelo netaknuto, što je upravo ono nad čim je potpis izračunat; prvo parsiranje pa ponovno zapisivanje promijenilo bi bajtove. Mali endpoint koji odgovara na provjeru i provjerava svaki POST:
import hashlib, hmac, os
from flask import Flask, abort, request
app = Flask(__name__)
VERIFY_TOKEN = os.environ["VERIFY_TOKEN"]
APP_SECRET = os.environ["APP_SECRET"].encode()
@app.get("/webhooks/facebook")
def verify():
token = request.args.get("hub.verify_token", "")
if request.args.get("hub.mode") == "subscribe" and hmac.compare_digest(token.encode(), VERIFY_TOKEN.encode()):
return request.args.get("hub.challenge", ""), 200
abort(403)
@app.post("/webhooks/facebook")
def receive():
raw = request.get_data() # the bytes Meta signed
expected = "sha256=" + hmac.new(APP_SECRET, raw, hashlib.sha256).hexdigest()
if not hmac.compare_digest(expected.encode(), request.headers.get("X-Hub-Signature-256", "").encode()):
abort(401)
# answer at once; hand request.get_json() to a queue for the work
return "EVENT_RECEIVED", 200Što Meta očekuje nakon provjere?
Odgovor 200 OK za svaku obavijest, unutar 5 sekundi za događaje Messengera. Meta šalje u paketima do 1,000 ažuriranja po isporuci, bez jamstva, i ovako rukuje neuspjesima:
- Obavijesti stranice: odmah se ponavljaju, zatim još nekoliko puta sa sve manjom učestalošću kroz 36 sati, pa se odbacuju.
- Obavijesti Messengera: odmah se ponove nekoliko puta; nakon 15 minuta neuspjeha upozorenje stiže na razvojni račun.
- Nakon jednog sata neuspjeha slijedi upozorenje Webhooks Disabled, a aplikacija se odjavljuje od stranice dok se ponovno ne pretplati.
- Ponavljanja mogu isporučiti događaj dvaput i izvan redoslijeda, pa deduplicirajte i poredajte poruke prema vremenskoj oznaci.
- Prošle obavijesti kasnije se ne mogu dohvatiti, zato spremite što vam treba čim stigne.
Kako easyCoexistence prolazi Metine provjere?
Njegova Meta aplikacija ima jedan URL povratnog poziva za stranice koje povezuje, a taj endpoint sam radi obje provjere. Na GET odgovara samo kad je hub.mode subscribe i kad se hub.verify_token podudara, uspoređen u stalnom vremenu, a inače vraća 403. Svaki POST čita kao sirov tekst, ponovno računa X-Hub-Signature-256 svojim App Secretom, neslaganje odbija s 401 i odmah odgovara Meti, a događaj obrađuje nakon odgovora.
Kako easyCoexistence potpisuje ono što proslijeđuje?
Vlastitim potpisom, jer se Metino zaglavlje može provjeriti samo App Secretom aplikacije easyCoexistence i ne proslijeđuje se dalje. Svaki unos za povezanu stranicu s postavljenim endpointom šalje se POST-om na taj endpoint kao JSON, {platform, account_id, external_id, entry}, uz zaglavlje X-EC-Signature u obliku t=<unix>,v1=<hex>, gdje je v1 HMAC-SHA256 vremenske oznake, točke i sirovog tijela, s tajnim ključem za potpisivanje te stranice:
- Tajni ključ počinje s whsec_ i prikazuje se jednom, putem
set_social_webhook_destinationili PUT /channels/:id/webhook na Partner API-ju. - Ponovno postavljanje URL-a izdaje novi tajni ključ, a URL null isključuje proslijeđivanje.
- Svako proslijeđivanje šalje se jednom, čeka do 8 sekundi, ne slijedi preusmjeravanja i ide na HTTPS adresu koja se razrješava u javnu IP adresu.
- Kopija događaja se ne čuva, pa nema ničega odakle bi se ponovilo slanje.
Kako provjeriti X-EC-Signature?
Razdvojite zaglavlje na t i v1, odbacite vremensku oznaku stariju od 5 minuta, ponovno izračunajte HMAC nad t, točkom i sirovim tijelom s tajnim ključem za potpisivanje stranice i usporedite u stalnom vremenu. U Node.js-u, uz tijelo spremljeno kao sirovi bajtovi:
import crypto from "node:crypto";
import express from "express";
const app = express();
const SECRET = process.env.EC_SIGNING_SECRET; // whsec_..., shown once
app.post("/events/facebook", express.raw({ type: "application/json" }), (req, res) => {
const sig = Object.fromEntries(
String(req.get("X-EC-Signature") ?? "").split(",").map((part) => part.split("="))
);
const fresh = Math.abs(Date.now() / 1000 - Number(sig.t)) <= 300;
const expected = crypto
.createHmac("sha256", SECRET)
.update(Buffer.concat([Buffer.from(`${sig.t}.`), req.body]))
.digest("hex");
const ok = fresh && typeof sig.v1 === "string" && sig.v1.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
if (!ok) return res.sendStatus(401);
res.sendStatus(200); // answer first: forwards are not retried
const { platform, account_id, external_id, entry } = JSON.parse(req.body.toString("utf8"));
// queue entry for the work
});Uobičajene pogreške
- Omotavanje hub.challenge u JSON ili navodnike. Tijelo odgovora 200 mora biti sama vrijednost hub.challenge.
- Računanje HMAC-a nakon JSON parsera. Parsiranje i ponovno zapisivanje mijenja bajtove, a Meta potpisuje payload s Unicode znakovima u escape obliku, zato heširajte sirovo tijelo.
- Obavljanje posla prije odgovora. Messenger očekuje 200 unutar 5 sekundi, a jedan sat neuspjeha odjavi aplikaciju od stranice.
- Provjera Metinog potpisa na proslijeđenim događajima. Meta potpisuje App Secretom aplikacije easyCoexistence; proslijeđeni događaj nosi X-EC-Signature, koji se provjerava tajnim ključem za potpisivanje stranice.
US$ 9 do US$ 0.75 po vezi mjesečno, a cijena pada kako dodajete veze, uz prvih 3 dana besplatnog probnog razdoblja.
Često postavljana pitanja
Odakle dolazi verify_token?
Odabirete ga sami. To je niz unesen u polje Verify Token pri konfiguraciji webhooka u nadzornoj ploči aplikacije ili verify_token poslan na /{app-id}/subscriptions.
Mogu li testirati provjeru s curl-om?
Da. Metin vodič za Messenger šalje GET s hub.verify_token, hub.challenge=CHALLENGE_ACCEPTED i hub.mode=subscribe, a radni endpoint odgovara s CHALLENGE_ACCEPTED.
Što ako moj endpoint ne radi cijeli sat?
Meta šalje upozorenje Webhooks Disabled i odjavljuje aplikaciju od stranice. Nakon ispravljanja endpointa ponovno pretplatite stranicu putem subscribed_apps.
Trebam li vlastitu Meta aplikaciju za primanje webhookova stranice?
Ne s easyCoexistence. Meta isporučuje svojoj aplikaciji, koja proslijeđuje događaje svake stranice na endpoint koji postavite, potpisane s X-EC-Signature.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na