Naslag Voor: beheerders, ontwikkelaars

Webhookfouten

Oorzaken en oplossingen voor de foutcode wanneer een webhook naar een beperkt netwerk wijst.

error.webhook.target_restricted

Tekst in de console
Dit webhookadres wijst naar een loopback-, privé- of link-local-netwerk. Gebruik een openbaar adres, of vraag een beheerder het netwerk toe te staan in de controllerconfiguratie.
Betekenis voor API-clients
The webhook target is a loopback, private, link-local or other restricted address that is not allow-listed.
Code
INVALID_ARGUMENT, HTTP 400
ArgumentInhoud
fieldhet aanvraagveld met het geweigerde adres, hier url.
urlhet adres dat is geweigerd, zonder aanmeldgegevens.

Oorzaak. Het adres van de webhook is een loopback-, privé-, link-local- of ander beperkt netwerk en het netwerk staat niet op de toelatingslijst van de controller. Kyvernon weigert zulke doelen, zodat een webhook niet kan worden gebruikt om interne services te bereiken. De controle geldt voor letterlijke adressen en voor de adressen waarnaar de hostnaam wordt omgezet.

Oplossing.

  1. Gebruik een publiek adres voor de webhook, bijvoorbeeld een ontvanger op een publieke hostnaam.
  2. Staat de ontvanger met opzet binnen uw netwerk, dan voegt een beheerder zijn netwerk toe aan allowed_networks in de sectie [webhooks] van de controllerconfiguratie, bijvoorbeeld allowed_networks = ["198.51.100.0/24"], en start de controller opnieuw.
  3. Maak het abonnement opnieuw aan: kyvernon webhooks create <name> --url <url>.

Versie 0.1. Laatst gewijzigd: 2026-11-13