Kontroller avsender før økonomihendelser behandles
Kontroller økonomimeldingens autentisitet før innholdet påvirker regnskapsdata eller betalingsstatus.
Et offentlig mottak for økonomihendelser kan motta både ekte og forfalskede forespørsler. En plausibel faktura-ID og et riktig JSON-format beviser ikke hvem som sendte meldingen. Avsenderkontroll må skje før meldingen får økonomisk virkning.
Syntetisk kontroll av tre meldinger
Testen nedenfor bruker oppdiktede meldinger og forventede kontrollresultater. Signaturformat og tidsgrense skal komme fra leverandørens dokumentasjon, ikke fra denne tabellen.
| Melding | Kontrollresultat | Videre behandling |
|---|---|---|
| Uendret testmelding fra godkjent avsender | Verifikasjon består | Valider innhold og identitet |
| Samme melding med endret beløp | Verifikasjon feiler | Ingen registrering |
| Tidligere gyldig melding sendt igjen | Identitet allerede mottatt | Ingen ny økonomisk virkning |
Avsenderkontroll og duplikatkontroll løser forskjellige problemer. En ekte melding kan bli levert flere ganger. En falsk melding kan inneholde en ny identifikator. Begge kontroller er nødvendige dersom denne leveringsformen brukes.
Bevar meldingen frem til verifikasjon
Stripe dokumenterer signaturkontroll for sine webhooks. Følg det aktuelle produktets krav til originalt meldingsinnhold og signaturfelt. En prosess som først leser JSON og deretter lager ny JSON, kan endre mellomrom eller feltrekkefølge og dermed grunnlaget for verifikasjonen.
Lagre hemmelig verifikasjonsmateriale i en egnet hemmelighetsforvaltning. Det skal ikke ligge i hendelsesloggen, en offentlig feilmelding eller et skjermbilde sendt i supportsaken. Mottakeren trenger ofte meldingsidentitet og verifikasjonsstatus for drift, men ikke hemmeligheten som beviser avsenderen.
En tidskontroll kan begrense gjenbruk av gamle signerte meldinger der leverandørens mekanisme støtter det. Klokken og tillatt avvik må inngå i driftsoppsettet. Ikke innfør en lokal grense som avviser lovlige leverandørforsinkelser uten at dette er testet.
Godkjenning før mottaket åpnes
- Prøv korrekt signatur med syntetisk innhold.
- Endre én verdi og bekreft avvisning.
- Prøv manglende signatur og ukjent nøkkel.
- Roter verifikasjonsmaterialet med dokumentert overgang.
- Gjenta en ekte testhendelse og kontroller duplikatsperren.
Ved gjentatte feil bør driftsansvarlig kunne skille feil konfigurasjon fra ukjent avsender uten å åpne alle meldingsdata. Avviste forespørsler skal ikke legges direkte i en økonomisk feilkø som en operatør senere kan godkjenne ukritisk.
Kontroller at verifikasjonsfeil ikke returnerer detaljer om hemmeligheten eller den forventede signaturen. Et teknisk varsel trenger feilklasse og kjøringsreferanse. Den økonomiske meldingen skal først få tilgang til videre arbeidsflyt når avsenderkontrollen faktisk består.
Veiledningen forutsetter et dokumentert hendelsesgrensesnitt. Den hevder ikke at ReAI eller Aiak tilbyr dette formatet. Se rotasjon av integrasjonstilgang for en beslektet driftskontroll.