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

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 1 minute de lecture

    • Vous devez créer des webhooks pour envoyer des événements entrants à DevOps Change Velocity à 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’option peut être planification, code ou orchestration.

    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 bascule sur 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 DevOps Change Velocity. Configurer manuellement les webhooks 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 comme en-tête en utilisant le format suivant : Nom de l’en-tête : En-tête d’autorisation Valeur : sn_devops. DevOpsToken <ToolId> :<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.
    • Transmettez le jeton en tant que paramètre de requête à 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 de gestionnaire. La fonction doit vérifier le jeton et s’assurer d’une authentification appropriée. Vous devez disposer du rôle administrateur dans ServiceNow pour implémenter votre propre logique d’authentification.