Erstellung von Webhooks zum Senden eingehender Ereignisse an DevOps Change-Geschwindigkeit mithilfe des Tokens

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 1 Minute Lesedauer

    • Sie müssen Webhooks erstellen, um eingehende Ereignisse mithilfe der tokenbasierten Authentifizierung an DevOps Change-Geschwindigkeit zu senden.

    Um eingehende Ereignisse an eine ServiceNow-Instanz zu senden, müssen Sie die folgende API-Endpunktstruktur verwenden: 
    <instance_url>/api/sn_devops/v2/devops/tool/{capability}?toolId=<toolId>
    Wobei die Fähigkeit Plan, Code oder Orchestration sein kann.

    Sie können die Details wie die Tool-ID, die Instanz-URL usw. kopieren, indem Sie auswählen Konfigurieren Sie manuell Aus dem Tooldatensatz oder im Schritt „Konfigurieren“ beim Onboarding des Tools. Sie können dann auswählen Kopieren Im entsprechenden Feld, um den Wert in Ihre Zwischenablage zu kopieren. Die Feldbezeichnung ändert sich in Kopiert , Sie können jedoch mehrmals kopieren. Die folgende Abbildung zeigt die Seite, von der die Werte für das GitHub-Tool in DevOps Change-Geschwindigkeit kopiert werden können. GitHub – Konfigurieren Sie Webhooks manuell

    Für die Tokenauthentifizierung müssen Sie das Token als Teil des Autorisierungsheaders oder der Abfrageparameter übergeben, da die Endpunkte gesichert sind. Sie können eine der folgenden Methoden verwenden:
    • Übergeben Sie das Token als Header, indem Sie das folgende Format verwenden: Headername: Autorisierungsheader-Wert: sn_devops.DevOpsToken <ToolId>:<Token> , Wobei <ToolId> die ID des Tools und <Token> das Authentifizierungstoken ist, das von der Seite „Tooldatensatz“ kopiert wurde.
    • Übergeben Sie das Token als Abfrageparameter in der URL: <instance_url>/api/sn_devops/v2/devops/Tool/{ability}?toolId=<toolId>&ni.nolog.token=<Token> , Wobei <ToolId> die ID des Tools und <Token> das Authentifizierungstoken ist, das von der Seite „Tooldatensatz“ kopiert wurde.

    Für die Standardauthentifizierung können Sie den folgenden V1-Endpunkt verwenden: https://user:password@<instance_url>/api/sn_devops/v1/devops/Tool/{ability}?toolId=<toolId> , Ersetzen Sie Anwender und Passwort durch Ihre ServiceNow-Anmeldeinformationen.

    Wenn Sie ein anwenderdefiniertes Tool oder eine andere Authentifizierungsmethode haben, können Sie Ihre eigene Authentifizierungslogik implementieren. Sie können beispielsweise eine authentifizierungToken-Funktion in Ihrer Handler-Klasse implementieren. Die Funktion sollte das Token verifizieren und eine ordnungsgemäße Authentifizierung sicherstellen. Sie müssen über die Administratorrolle in ServiceNow verfügen, um Ihre eigene Authentifizierungslogik zu implementieren.