Webhooks in AWS konfigurieren

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 2 Minuten Lesedauer

    • Abonnieren Sie ein Thema für einen Endpunkt, um für das Thema veröffentlichte Nachrichten zu empfangen. Ab dem Zeitpunkt, zu dem Sie ein Thema für einen Endpunkt abonnieren, werden über den Endpunkt Nachrichten empfangen, die für das zugeordnete Thema veröffentlicht werden.

    Vorbereitungen

    Vergewissern Sie sich, dass Sie folgende Aktionen ausgeführt haben:
    • In AWS wurde ein Thema erstellt.
    • In SR Ops wurde ein Webhook-Endpunkt erstellt. Diesbezügliche Informationen finden Sie unter Webhook-Endpunkt in SR Ops erstellen.
    • In AWS wurde ein Account erstellt.

    Erforderliche Rolle: evt_mgmt_integration

    Warum und wann dieser Vorgang ausgeführt wird

    Prozedur

    1. Melden Sie sich bei der AWS-Konsole an.
    2. Öffnen Sie Simple Notification Service.
    3. Klicken Sie im linken Navigationsbereich auf Topics (Themen), und öffnen Sie in der vorhandenen Themenliste das Thema, für das Sie ein Abonnement erstellen möchten.
    4. Klicken Sie auf die Registerkarte Subscriptions (Abonnements).
    5. Klicken Sie auf Create subscription (Abonnement erstellen).
      Abbildung : 1. Formular zum Erstellen von Abonnements
      Formular zum Erstellen von Abonnements
    6. Füllen Sie die Felder des Formulars aus.
      Tabelle : 1. Formular zum Erstellen von Abonnements
      Feld Beschreibung
      Topic ARN (Thema-ARN) Amazon-Ressourcenname (ARN) eines Themas.
      Hinweis:
      Ein Amazon-Ressourcenname (ARN) ist eine Dateibenennungskonvention, die zur Identifizierung einer bestimmten Ressource in der Public Cloud von Amazon Web Services (AWS) verwendet wird. AWS-spezifische ARNs helfen einem Administrator, AWS-Elemente und -Richtlinien über AWS-Produkte und API-Aufrufe hinweg nachzuverfolgen und zu verwenden.
      Protokoll Der Typ des Endpunkts. Wählen Sie HTTPS aus.
      Endpunkt Das ist der Endpunktwert, z. B. eine E-Mail-Adresse oder der Webserver, auf dem Benachrichtigungen von AWS empfangen werden.
      Hinweis:
      Geben Sie in dieses Feld Ihre Webhook-URL ein. Beispiel: https://admin:admin@valarem.service-now.com/api/sn_em_connector/em/inbound_event?source=aws, wobei „admin:admin“ der Anwendername und das Passwort für die Standardauthentifizierung sind
      Enable raw message delivery (Nachrichtenübermittlung im Rohformat aktivieren) Mit dieser Option verhindern Sie, dass die JSON-Formatierung von Nachrichten durch Endpunkte verarbeitet wird.
      (Optional) Subscription filter policy (Abonnement-Filterrichtlinie) Mit einer Abonnement-Filterrichtlinie können Sie Attributnamen angeben und jedem Attributnamen eine Liste von Werten zuweisen.
      (Optional) Redrive policy (dead-letter queue) [Redrive-Richtlinie (Warteschlange für unzustellbare Nachrichten)] Eine Warteschlange für nicht zustellbare Nachrichten als Ziel für Nachrichten, die nicht erfolgreich an Abonnenten übermittelt werden können. Nachrichten, die aufgrund von Client- oder Serverfehlern nicht zugestellt werden können, werden zur weiteren Analyse oder erneuten Verarbeitung in der Warteschlange für nicht zustellbare Nachrichten aufbewahrt.
    7. Klicken Sie auf Create subscription (Abonnement erstellen).
      Wenn das Abonnement erfolgreich ist, wird der Abonnementstatus von „Pending“ (Ausstehend) in „Confirmed“ (Bestätigt) geändert.
    8. Suchen Sie und öffnen Sie CloudWatch.
    9. Erstellen Sie Alarme für das Thema.
      Beispiel: Erstellen Sie einen Alarm, der ausgelöst wird, wenn ein Benutzer eine Nachricht mehr als einmal pro Minute veröffentlicht.
    10. Öffnen Sie Simple Notification Service.
    11. Klicken Sie im linken Navigationsbereich auf Topics (Themen).
    12. Klicken Sie auf Publish message (Nachricht veröffentlichen).
    13. Geben Sie im Nachrichtentext die JSON-Nachricht ein, die Sie an den Endpunkt senden möchten. 
      {
  "default": "Sample fallback message",
}
    14. Klicken Sie auf Publish message (Nachricht veröffentlichen).

    Nächste Maßnahme

    In der ServiceNow-Instanz können jetzt Ereignisse von AWS empfangen werden. Die Ereignisse werden in der Tabelle [em_event] gespeichert. Sie können den entsprechenden Alarm aus der Spalte Warnung anzeigen.