Création de webhooks pour envoyer des événements entrants à DevOps Change Velocity à l’aide d’un jeton

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture
  • Vous devez créer des webhooks pour envoyer des événements entrants à Vélocité de changement DevOps à l’aide de l’authentification basée sur les jetons.

    Pour envoyer des événements entrants à une instance ServiceNow, vous devez utiliser la structure de point de terminaison d’API suivante :
    <instance_url>/api/sn_devops/v2/devops/tool/{capability}?toolId=<toolId>
    où l’aptitude peut être planifiée, codée ou orchestrée.

    Vous pouvez copier les détails tels que l’ID de l’outil, l’URL de l’instance, et ainsi de suite, en sélectionnant Configurer manuellement à partir de l’enregistrement de l’outil ou à l’étape de configuration lors de l’intégration de l’outil. Vous pouvez ensuite sélectionner Copier dans le champ approprié pour copier la valeur dans votre presse-papiers. L'étiquette du champ devient Copié, mais vous pouvez copier plusieurs fois. L’image suivante affiche la page à partir de laquelle les valeurs peuvent être copiées pour l’outil GitHub dans Vélocité de changement DevOps. Configurer manuellement des webhooks dans GitHub

    Pour l’authentification par jeton, vous devez transmettre le jeton dans le cadre de l’en-tête d’autorisation ou des paramètres de requête, car les points de terminaison sont sécurisés. Vous pouvez utiliser l’une des méthodes suivantes :
    • Transmettez le jeton en tant qu’en-tête en utilisant le format suivant : Nom de l’en-tête : Valeur d’en-tête d’autorisation : sn_devops. DevOpsToken <ToolId> :<Token> où <ToolId > correspond à l’ID de l’outil et < jeton > est le jeton d’authentification copié à partir de la page d’enregistrement de l’outil.
    • Transmettez le jeton comme paramètre de requête dans l’URL : <instance_url>/api/sn_devops/v2/devops/tool/{capability} ?toolId=<toolId>&ni.nolog.token=<Token>, où <ToolId> correspond à l’ID de l’outil et < Token > est le jeton d’authentification copié à partir de la page d’enregistrement de l’outil.

    Pour l’authentification de base, vous pouvez utiliser le point de terminaison V1 suivant : https ://user :password@<instance_url>/api/sn_devops/v1/devops/tool/{capability} ?toolId=<toolId>, remplacez l’utilisateur et le mot de passe par vos informations d’identification ServiceNow.

    Si vous disposez d’un outil personnalisé ou d’une méthode d’authentification différente, vous pouvez implémenter votre propre logique d’authentification. Par exemple, vous pouvez implémenter une fonction authenticateToken dans votre classe handler. La fonction doit vérifier le jeton et s’assurer d’une authentification appropriée. Vous devez disposer du rôle admin dans ServiceNow pour implémenter votre propre logique d’authentification.