Richten Sie den bidirektionalen Webhook für ein GitHub-Spoke

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer

    • Konfigurieren Sie den Webhook zum Abonnieren von GitHub mit einer Rückruf-URL ServiceNow.

    Vorbereitungen

    • IntegrationHub-Abonnement anfordern
    • GitHub-Spoke aktivieren
    • Erforderliche Rolle: admin

    Erstellen Sie ein Geheimnis für GitHub-Spoke

    Erstellen Sie ein Geheimnis, um es in die Webhook-URL GitHub einzubetten.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Systemdefinition > Skripts – Hintergrund.
    2. Geben Sie diesen Befehl in das Textfeld Skript ausführen (JavaScript wird auf dem Server ausgeführt) ein:
      gs.info(GlideSecureRandomUtil.getSecureRandomString(16));
    3. Klicken Sie auf Skript ausführen.
    4. Kopieren Sie das generierte Geheimnis, und notieren Sie es zur späteren Verwendung.

    GitHub -Webhook in ServiceNow] registrieren

    Registrieren Sie einen GitHub in ServiceNow [], um die App ServiceNow zu benachrichtigen, wenn bestimmte Ereignisse in GitHubauftreten.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > GitHub-Webhooks > GitHub-Webhook-Registrierungen.
    2. Klicken Sie auf Neu.
    3. Füllen Sie die Felder des Formulars aus.
      Tabelle : 1. GitHub-Webhook-Registrierungsformular
      Feld Beschreibung
      Name Eindeutiger Name zur Identifizierung des Datensatzes. Beispiel: GitHub-Webhook.
      Beschreibung Beschreibung des Datensatzes.
      Geheimnis Geheimer Schlüssel, den Sie mit dem Modul „Skripts – Hintergrund“ generiert haben.
      Pfad GitHub Webhook-Pfad. Standardmäßig ist dies auf api/sn_github_spoke/github_webhook_callbacks/wh_entry festgelegt.
    4. Klicken Sie mit der rechten Maustaste in den Header des Formulars und wählen Sie Speichern aus.
    5. Klicken Sie auf Callback URL.
      Das System zeigt die Webhook-Rückruf-URL an.
    6. Kopieren Sie die Webhook-Rückruf-URL, und zeichnen Sie sie auf.

    Ergebnisse

    Der Webhook GitHub ist in Ihrer Instanz ServiceNow ] registriert.

    Fügen Sie die Rückruf-URL in hinzu GitHub

    Geben Sie die Webhook-Rückruf-URL im Konto GitHub an, um einen Webhook zu erstellen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Melden Sie sich bei Ihrem GitHub-Konto an.
    2. Erstellen Sie einen Webhook in Ihrem Atlassian-Konto.
    3. Geben Sie Webhook-Rückruf-URL in Nutzlast-URL und Geheimnis in Geheimnisein.

      Siehe GitHub Entwickler -Dokumentation finden Sie Anweisungen zum Erstellen und Konfigurieren eines Webhooks.

      Hinweis:
      GitHub-Spoke unterstützt Anwendungs-/JSON-Nutzlast. Konfigurieren Sie den Webhook GitHub entsprechend. Siehe GitHub Entwickler -Dokumentation finden Sie Anweisungen zum Erstellen und Konfigurieren eines Webhooks.

    Ergebnisse

    Die Rückruf-URL wird im Konto GitHub hinzugefügt. Sie können Routing-Richtlinien und Subflows gemäß Ihren Anforderungen erstellen. Passen Sie einen bidirektionalen Webhook an Informationen zum Erstellen neuer Routing-Richtlinien und Subflows[] finden Sie unter .

    Passen Sie den bidirektionalen Webhook in an GitHub-Spoke

    Erstellen Sie eine Webhook-Routing-Richtlinie und einen Subflow gemäß Ihren Anforderungen in GitHub-Spoke.

    Vorbereitungen

    Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Die Standard-Routing-Richtlinie in den Modulen für GitHub-WebHook-Routing-Richtlinien löst den relevanten Subflow GitHub aus und benachrichtigt die App ServiceNow, wenn bestimmte Events in GitHubauftreten. Unter GitHub Spoke finden Sie Informationen zu den Feldern GitHub, die von der Standard-Routing-Richtlinie unterstützt werden, und zu den Ereignissen GitHub, die von -Subflows unterstützt werden. Führen Sie die folgenden Schritte aus, um andere Felder in Ihrem benutzerdefinierten Subflow zu verwenden und die Bedingungen in der Weiterleitungsrichtlinie anzupassen.

    Prozedur

    1. Navigieren zu Alle > Flow Designer > Designer.
    2. Klicken Sie auf Subflows.
    3. Erstellen Sie eine Kopie des erforderlichen Subflows.
    4. Passen Sie den erforderlichen Subflow an Ihre Anforderungen an, und veröffentlichen Sie ihn.
      Unter Subflows erstellen finden Sie weitere Informationen zum Erstellen und Verwenden von Subflows und GitHub Spoke für Informationen zu den Feldern GitHub, die von der Standard-Routing-Richtlinie unterstützt werden, und den Ereignissen GitHub, die von den Subflows unterstützt werden.
    5. Navigieren zu GitHub-Webhooks > GitHub-WebHook-Routing-Richtlinien.
    6. Klicken Sie auf Neu.
    7. Füllen Sie die Felder des Formulars aus.
      Tabelle : 2. Formular „Entscheidung“
      Feld Beschreibung
      Bezeichnung Eindeutige Bezeichnung zur Identifizierung der Routing-Richtlinie.
      Standardantwort Option, um anzugeben, ob dies die Standardantwort ist. Die Standardantwort ist anwendbar, wenn die Bedingungen nicht erfüllt sind.
      1. Klicken Sie auf das Symbol Nachschlagen.
      2. Wählen Sie den erforderlichen Subflow aus der Liste Dokument: aus.
        Hinweis:
        Stellen Sie sicher, dass der TabellennameFlow [sys_hub_flow] lautet.
      Bedingung Bedingungen, die erfüllt sein müssen, wenn die erforderlichen Ereignisse in GitHubauftreten. Weitere Informationen zu den unterstützten Feldern finden Sie unter GitHub Spoke.
      Antwort Subflow, der ausgelöst werden muss, wenn die angegebenen Bedingungen erfüllt sind.
    8. Klicken Sie auf Absenden.
      Hinweis:
      Diese Weiterleitungsrichtlinien werden in den Entscheidungstabellen gespeichert. Benutzer werden davor gewarnt, Daten in diesen Tabellen direkt zu aktualisieren oder zu ändern.

    Ergebnisse

    Weiterleitungsrichtlinie und Subflow werden erstellt.