Juvaro Hjælpecenter
English

Webhook-udløsere

Lad et eksternt system starte en kørsel ved at kalde en URL, og rotér eller deaktivér hemmeligheden.

Hvem kan gøre detWorkspace-administrator

En webhook-udløser er en tredje måde at starte en kørsel på, ved siden af kørselsplanen og Run now. Et eksternt system kalder en URL, og Hub kører forbindelsen. Brug den, når kildesystemet selv ved bedst, hvornår der er nye data, fx når en eksport er færdig.

Bemærk

Integrationshub findes kun på engelsk. Knapper, felter og beskeder står derfor på engelsk her, præcis som du ser dem i appen.

Hvilke forbindelser kan have en

  • Forbindelser til Microsoft Intune, Jamf Pro og Generic REST / JSON kan.
  • Fælles postkasser kan ikke. De tjekkes efter deres plan.
  • Leverandørforbindelsen til Webmercs kan ikke. Flexshop sender ordrer direkte til den.
  • De platformrækker, Juvaro selv kører, kan ikke. Forsøger du, får du en besked, der slutter med "so it cannot be given a webhook here."

Slå en webhook-udløser til

Kortet Webhook trigger står nederst på forbindelsens side. Samme afsnit findes til sidst i forbindelsens editor, men først når forbindelsen er gemt; indtil da står der "Save the connection first, then a webhook URL + secret appear here."

  1. Åbn forbindelsens side fra Connections.
  2. Klik på Enable webhook trigger i Webhook trigger.
  3. To felter vises: Webhook URL og Secret (copy now - shown once). Klik i et felt for at markere værdien.
  4. Kopiér begge til det system, der skal starte kørslerne. Systemet sender hemmeligheden som bearer-token i Authorization-headeren, når det kalder URL'en.
Bemærk

Hemmeligheden vises kun denne ene gang. Når du forlader siden, viser kortet kun de sidste fire tegn, fx "Secret set (…7f3a). Rotate to get a new one." Fik du den ikke kopieret, så rotér den for at få en ny.

Webhook URL er den samme for alle forbindelser i Hub. Det er hemmeligheden, der fortæller Hub, hvilken forbindelse der skal køre, så behandl den som en adgangskode. Står der "Not configured yet." i stedet for URL'en, er Hubs webhook-adresse ikke sat op i jeres miljø; kontakt Juvaros support.

Rotér hemmeligheden

Rotér hemmeligheden, når en person, der kendte den, stopper, når den måske er lækket, eller som fast rutine.

  1. Klik på Rotate secret i kortet Webhook trigger.
  2. Kopiér den nye hemmelighed fra Secret (copy now - shown once).
  3. Opdatér det kaldende system med den nye hemmelighed.

Kortet viser derefter "Last rotated" med tidspunktet. Den nye hemmelighed erstatter den gamle, så det kaldende system skal opdateres, før det kalder næste gang.

Slå den fra

Klik på Disable. Kald til URL'en starter ikke længere denne forbindelse. Klikker du senere på Enable webhook trigger igen, får du en helt ny hemmelighed, og den skal det kaldende system have.

Se leverancerne

Mens udløseren er slået til, viser kortet de kørsler, en webhook har startet, som en kørselshistorik med forbindelsens navn og "webhook deliveries". I den almindelige Run history står der Webhook i kolonnen Trigger ved de samme kørsler.

Kortet skriver også: "Accepted deliveries only - rejected or rate-limited attempts are not recorded." Et kald med forkert hemmelighed, eller et kald der afvises, fordi det kom for tit, efterlader intet spor i Hub. Forventer du en kørsel og ser ingen, så kig først i det kaldende systems egen log.

Godt at vide