Référence Pour: administrateurs, développeurs

Erreurs de webhook

Causes et solutions du code d'erreur levé lorsqu'un webhook pointe vers un réseau restreint.

error.webhook.target_restricted

Texte dans la console
Cette adresse de webhook désigne un réseau de bouclage, privé ou lien-local. Utilisez une adresse publique, ou demandez à un administrateur d’autoriser ce réseau dans la configuration du contrôleur.
Signification pour les clients de l'API
The webhook target is a loopback, private, link-local or other restricted address that is not allow-listed.
Code
INVALID_ARGUMENT, HTTP 400
ArgumentContenu
fieldle champ de la requête qui contient l'adresse refusée, ici url.
urll'adresse refusée, sans identifiants.

Cause. L'adresse du webhook est un réseau de bouclage, privé, de liaison locale ou autrement restreint, et ce réseau ne figure pas dans la liste d'autorisation du contrôleur. Kyvernon refuse ces cibles afin qu'un webhook ne puisse pas servir à atteindre des services internes. La vérification porte sur les adresses littérales et sur les adresses vers lesquelles le nom d'hôte se résout.

Solution.

  1. Utilisez une adresse publique pour le webhook, par exemple un récepteur sur un nom d'hôte public.
  2. Si le récepteur se trouve volontairement dans votre réseau, un administrateur ajoute son réseau à allowed_networks dans la section [webhooks] de la configuration du contrôleur, par exemple allowed_networks = ["198.51.100.0/24"], et redémarre le contrôleur.
  3. Créez de nouveau l'abonnement : kyvernon webhooks create <name> --url <url>.

Version 0.1. Dernière modification : 2026-11-13