Webhookit

Webhookit-osio hallinnoi tenantin webhook-tilauksia. Itse protokolla — allekirjoituksen todennus, uudelleenyritykset ja hyötykuorman muoto — on kuvattu kehittäjän puolella, ks. Webhookit (integraatio). Tällä sivulla käydään läpi admin-paneelin näkymä.

Endpointin luonti

Kenttä	Kuvaus
Endpoint URL	HTTPS-osoite, johon tapahtumat lähetetään POST-pyynnöllä
Tapahtumatyypit	Pilkuin tai välilyönnein eroteltu lista tuetuista tyypeistä

Rekisteröinnissä URL tarkistetaan, ettei se osoita sisäverkkoon tai paikallisosoitteeseen (SSRF-suojaus); sama tarkistus tehdään uudelleen jokaisen toimitusyrityksen yhteydessä, ei vain rekisteröinnin hetkellä.

Luonnin yhteydessä näytetään allekirjoitussalaisuus vain kerran — sitä käytetään saapuvien pyyntöjen X-Tunnuspalvelu-Signature-otsakkeen todentamiseen. Tallenna se heti.

Tuetut tapahtumatyypit

Lomakkeessa valittavat tapahtumat, se mitkä niistä oikeasti lähtevät, ja jokaisen payload on kuvattu integraatio-ohjeessa: Webhookit. Lomake näyttää myös tapahtumia, joita mikään koodipolku ei vielä laukaise; tilaa vain ohjeen taulukossa olevia.

Endpointin hallinta

Endpointin omalla sivulla voi:

• muokata URLia, tapahtumatyyppejä ja Enabled-lippua (pois päältä kytkettynä toimituksia ei yritetä)
• lähettää testiluontoisen webhook.ping-tapahtuman Send test ping -napista
• rotate allekirjoitussalaisuuden — vanha salaisuus lakkaa toimimasta välittömästi, uusi näytetään vain kerran
• poistaa endpointin pysyvästi

Toimitusloki

Sivun alaosa listaa viimeisimmät toimitukset tapahtumatyypeittäin tilalla:

• Delivered (koodi) — vastaanottaja vastasi onnistuneesti
• Pending (yritys N) — odottaa seuraavaa uudelleenyritystä
• Exhausted — viisi yritystä on käytetty eikä toimitus onnistunut; katso virheviesti sarakkeesta

Jos endpointin URL alkaa osoittaa sisäverkkoon toimitusyritysten välissä (esim. DNS muuttuu), järjestelmä kytkee endpointin pois päältä automaattisesti eikä yritä toimittaa sille enää.