IOSOR

IOSOR Vedomosti

Podpis a brána okna opakovania

Výrobná brána: overte podpis a ohraničte okno opakovania predtým, než sa akýkoľvek webhook stane pravdou o peniazoch alebo stave — nepodpísané alebo zastarané udalosti zostávajú zablokované.

Prijatie neoverených alebo oneskorených webhookov vystavuje predplatené účty riziku falošných zostatkov a dvojitých debetov cez replay útoky. Pred akoukoľvek zmenou finančných prostriedkov musíte vynútiť kryptografické overenie podpisu a zahodiť správy mimo povoleného časového okna. Súvisiace: podpis webhooku a okno opakovania, opakovania prichádzajúceho webhooku, Zdieľaný jazyk stavov pre produkt a financie, Riadky debit vs stav doručenia na tom istom ledgeri.

Overenie podpisu je peňažná brána

Peniaze a pravda o stave začínajú až po úspešnej kontrole podpisu. Chýbajúce, nezhodné alebo preskočené podpisy zlyhávajú zatvorené — žiadny riadok v knihe, žiadne «doručené napriek tomu pre pilot». Živý katalóg neuvoľňuje bránu. Hĺbka návykov: podpis webhooku a okno opakovania. Mäkkých USD 1 000/mesiac považuje «akceptovať nepodpísané v stagingu» za produkčný dlh; USD 20 dokazuje, že jedno podvrhnuté telo nikdy nezaúčtuje debet.

Okno opakovania pred pravdou o stave

Kontrola brány Význam pre úspech Význam pre zlyhanie
Podpis prítomný + platný Overená udalosť Odmietnuť; bez zápisu peňazí/stavu
Časová pečiatka v okne Dosť čerstvé na dôveru Odmietnuť ako opakovanie/zastarané
ID udalosti nevidené Prvé prijatie Potvrdiť bez druhého debetu
Zmluvná udalosť uvedená V ponuke udalostí kupujúceho Zahodiť neznámy typ

Doručenie «aspoň raz» sa zopakuje. Neskoré opakovanie mimo okna nie je «možno doručené». Logujte odmietnutia okna oddelene od zlyhaní podpisu. Hĺbka opakovaní: opakovania prichádzajúceho webhooku.

Zlyhanie zatvorené, keď brána odmietne

Odmietnuté udalosti nikdy nevymýšľajú úspech. Produkt a financie zdieľajú rovnaké slová odmietnutia — žiadne hrdinské upstream kódy: Zdieľaný jazyk stavov pre produkt a financie. Debetné riadky zostávajú zarovnané iba s akceptovanými udalosťami: Riadky debit vs stav doručenia na tom istom ledgeri. Vedľajšie efekty až po ACK; CRM práca pred bránou vytvára dvojitú pravdu.

Produkt, financie a prevádzka zdieľajú jeden dôkaz

Produkt: môže legitímna podpísaná udalosť v okne aktualizovať stav raz? Financie: ukazuje každá udalosť ovplyvňujúca peniaze prechod bránou v rovnakom UTC okne? Operácie: exportujte zlyhania podpisu vs odmietnutia okna bez archeológie v Slacku.

Kontrolný zoznam kupujúceho pre bránu opakovania podpisu

Overte, či váš endpoint vracia 4xx pre nepodpísané udalosti. Uistite sa, že časová pečiatka webhooku je validovaná voči systémovému času. Skontrolujte, či vaša logika pre idempotenciu používa ID udalosti pred zápisom do knihy. Udržujte svoje kľúče v bezpečí.

Začnite s IOSOR

V konzole: Signature + replay window gate before first webhook accept.. Zapíšte vlastníka a brány pred rozšírením.

Súvisiace: webhook signature replay window inbound sms webhook retries idempote

Zhrnutie IOSOR

Je to ops disciplína na službu—nie brochure.

Robte: name owner + gate. Nerobte: skip the gate.

Pomohol tento sprievodca?

Súvisiace návody