Ereignisse werden an übertragen MID-Server Webservice-API wird verwendet

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 2 Minuten Lesedauer

    • Konfigurieren Sie den MID-Webservice-Ereignissammler, um eine URL-Methode zum Verschieben von Ereignisnachrichten an bereitzustellen MID-Server.

    Mit dem MID-Webservice-Ereignissammler können Sie standardmäßig eine Verbindung zu einem Ereignisgenerator herstellen und Ereignisnachrichten über senden MID-Server, Mit einer URL im folgenden Format: http://{MID_Server_IP}:{MID_Web_Server_Port}/api/Mid/em/jsonv2

    Das JSON v2-Format entspricht dem Format, das Clients zum Senden von Ereignisnachrichten an die Instanz verwenden. Diese URL bietet eine gute Leistung.

    Weitere Informationen finden Sie unter Konfigurieren Sie den Kontext des MID-Webservice-Ereignissammlers.
    Hinweis:
    Ereignismanagement Akzeptiert Ereignisse in der Zeitzone von MID-ServerÜber die der Listener die Ereignisnachricht gesendet hat. Wenn Sie eine andere Zeitzone benötigen, können Sie das Skript nach Bedarf konfigurieren, siehe Integration mit Push-Connectors.

    URL zum Verschieben anwenderdefinierter Nutzlasten

    Die MID-Server Kann auch eine anwenderdefinierte Nutzlast im JSON-, XML- oder nur-Text-Format empfangen. In diesem Fall wird MID-Server Transformiert die Ereignisnachrichten mithilfe der von Ihnen angegebenen Skripteinbindung und sendet die Ereignisse dann an die Instanz. Die URL in diesem Fall lautet:

    http://{MID_Server_IP}:{MID_Web_Server_Port}/api/MID/em/inbound_event?Transform={Transform_script_Name} Ein Beispiel für eine Skripteinbindung finden Sie im Standard TransformEvents_xmlSample Skripteinbindung.

    Ein Beispiel dafür, wie der MID-Webservice-Ereignissammler JSON-formatierte Ereignisnachrichten umwandelt, finden Sie unter Ereignissammlung von BMC TrueSight und BMC TrueSight_v2.

    Um Ereignisse im generischen JSON-Format zu senden, können Sie die URL in diesem Format verwenden:

    http://{MID_Server_IP}:{MID_Web_Server_Port}/api/MID/em/inbound_event?Transform=TransformEvents_MidJsonGeneric

    In diesem Fall wird TransformEvents_MidJsonGenerisch Die in der Basisinstanz bereitgestellte MID-Skripteinbindung wandelt die Ereignisnachrichten in Ereignisfelder um. Alle Felder werden als hinzugefügt Zusätzliche Informationen Felder im generierten ServiceNow-Ereignis.

    Hinweis:
    Die URL im Format http://{MID_Server_IP}:{MID_Web_Server_Port}/api/MID/em/{transform_script_Name} Wird auch unterstützt.

    Die REST-API-URL zum Validieren der Konnektivität ist: http://{MID_Server_IP}:{MID_Web_Server_Port}/api/Mid/em/ping

    Skripteinbindung zum Transformieren gesammelter Ereignisse

    Verwenden Sie die erforderliche MID-Server Skripteinbindung zum Transformieren (Analysieren) gesammelter Ereignisnachrichten und Ausfüllen in das zugeordnete Ereignisfeld. Die MID-Server Der Name der Skripteinbindung besteht aus einem Präfix und einem Suffix. Das Präfix ist der obligatorische Text Transformationsereignisse_ Und das Suffix ist der Transformationsname auf der URL, z. B. http://{MID_Server_IP}:{MID_Web_Server_Port}/api/Mid/em/xmlSample . Der Name des verfassten Skripts lautet daher TransformEvents_xmlSample .

    Sie müssen eine Skripteinbindung angeben, die die Ereignisnachrichten in einer Textvariable empfängt. Das Skript muss einen haben Transformieren() Funktion, die die Transformation durchführt und das Rückgabe-Array von Ereignisobjekten vorbereitet. Wenn Ereignismanagement Plugin ist aktiviert, Sie erhalten TransformEvents_xmlSample Beispiel für ein Include-Skript, das Ereignisse aus dem XML-Format umwandelt.

    Hinweis:
    Ereignisfelder, die nicht mit Feldern in der Ereignistabelle identisch sind, werden in gespeichert Zusätzliche Informationen Feld.

    Ereignisnachrichten-Header

    Geben Sie den relevanten Anforderungsheader-Wert für an Inhaltstyp Feld gemäß dem Format der Ereignisnachricht.

    Tabelle : 1. Anforderungsheader-Werte für den Inhaltstyp
    Nachrichtenformat Inhaltstyp-Wert
    JSON Anwendung/JSON
    XML Anwendung/XML
    HTML Text/nur

    Authentifizierungs- und Datensicherheitsoptionen

    Optionen für Authentifizierung und Datensicherheit:
    • Authentifizierungstyp , Die auf entweder festgelegt werden kann API-Schlüssel , MTLs , Oder Standard .
    • Mit Sichere Verbindung können Sie auswählen, ob eingehende und ausgehende Daten bei der Übertragung gesichert werden. Wenn Sie die erweiterte gesicherte Option auswählen, müssen Sie ein Zertifikat von einer bekannten Zertifizierungsstelle erhalten und dann angeben Schlüsselspeicher-Zertifikatalias Und Schlüsselspeicher-Passwort .
    • Verwenden Sie den einheitlichen MID-Schlüsselspeicher , Der Verschlüsselungsschutz bietet und Ihnen die Installation eines anwenderdefinierten Zertifikats in ermöglicht MID-Server Einheitlicher Schlüsselspeicher. Weitere Informationen finden Sie unter Installieren Sie anwenderdefinierte Zertifikate im zentralen Schlüsselspeicher des MID-Servers .
    • Anwender müssen ein Skript bereitstellen, das die JSON-, XML- oder textformatierten Ereignisnachrichten in einer Textvariablen empfängt. Das Skript muss über eine Transformationsfunktion () verfügen, die die Transformation durchführt und das Rückgabe-Array von Ereignisobjekten vorbereitet. Die TransformEvents_xmlSample Das Include-Skript, das Ereignisse aus dem XML-Format umwandelt, wird als Beispiel bereitgestellt, wenn Ereignismanagement Plugin ist aktiviert.
    Weitere Informationen zu Authentifizierung und Datensicherheit finden Sie unter Konfigurieren Sie MID-Webserver Erweiterung.