Events werden mithilfe der Webservice-API an MID-Server übertragen

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

    • Konfigurieren Sie den MID WebService-Eventsammler, damit eine URL-Methode Event-Nachrichten an den MID-Server übertragen kann.

    Der MID WebService-Event-Sammler ermöglicht Ihnen standardmäßig das Herstellen einer Verbindung zu einem Event-Generator und das Senden von Event-Nachrichten über den MID-Server mithilfe einer URL im folgenden Format: http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/jsonv2.

    Das JSON v2-Format ist mit dem Format identisch, das Clients zum Senden von Event-Nachrichten an die Instanz verwenden. Diese URL bietet eine gute Leistung.

    Weitere Informationen finden Sie unter MID-WebService-Event-Sammlerkontext konfigurieren.
    Hinweis:
    Ereignismanagement akzeptiert Events in der Zeitzone des MID-Server, über den der Listener die Event-Nachricht gesendet hat. Wenn Sie eine andere Zeitzone benötigen, können Sie das Skript nach Bedarf konfigurieren, siehe Integrieren Sie mit Push-Connectors.

    URL zum Verschieben von benutzerdefinierten Nutzlasten

    Der MID-Server kann auch eine benutzerdefinierte Nutzlast im JSON-, XML- oder Nur-Text-Format empfangen. In diesem Fall transformiert der MID-Server die Event-Nachrichten mithilfe der von Ihnen angegebenen Skripteinbindung und sendet die Events dann an die Instanz. Die URL lautet in diesem Fall:

    http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/inbound_event?Transform={Transform_script_name} Für ein Beispiel für eine Skripteinbindung siehe die Standard-Skripteinbindung TransformEvents_xmlSample.

    Ein Beispiel für die Umwandlung von JSON-formatierten Event-Nachrichten durch den MID WebService-Eventsammler finden Sie unter Event-Erfassung von BMC TrueSight und BMC TrueSight_v2.

    Zum Senden von Events im allgemeinen JSON-Format können Sie die URL in folgendem Format verwenden:

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

    In diesem Fall transformiert die MID-Einbindung TransformEvents_MidJsonGeneric, die in der Basisinstanz bereitgestellt wird, die Event-Nachrichten in die Event-Felder. Alle Felder werden als Felder Zusätzliche Informationen dem generierten ServiceNow-Event hinzugefügt.

    Hinweis:
    Die URL im Format http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/{transform_script_name} wird ebenfalls unterstützt.

    Die URL der REST API zum Überprüfen der Konnektivität lautet: http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/ping.

    Skripteinbindung zur Transformation erfasster Events

    Verwenden Sie die erforderliche Skripteinbindung MID-Server, um erfasste Event-Nachrichten umzuwandeln (zu analysieren) und in das zugeordnete Event-Feld einzufügen. Der Name der Skripteinbindung MID-Server besteht aus einem Präfix und einem Suffix. Das Präfix ist der obligatorische Text TransformEvents_ und das Suffix ist der Transformationsname in der URL, z. B. http://{MID_Server_IP}:{MID_Web_Server_Port}/api/mid/em/xmlSample . Der Name des zusammengesetzten Skripts lautet daher TransformEvents_xmlSample.

    Sie müssen eine Skripteinbindung angeben, die die Event-Nachrichten in einer Textvariablen empfängt. Das Skript muss über eine transform ()-Funktion verfügen, die die Transformation durchführt und das Rückgabe-Array von Event-Objekten vorbereitet. Wenn das Ereignismanagement-Plugin aktiviert ist, erhalten Sie das TransformEvents_xmlSample-Beispielskript, das Events aus dem XML-Format umwandelt.

    Hinweis:
    Event-Felder, die nicht mit Feldern in der Event-Tabelle identisch sind, werden im Feld Zusätzliche Informationen gespeichert.

    Event-Nachrichtenheader

    Geben Sie den entsprechenden Anforderungsheaderwert für das Feld Inhaltstyp entsprechend dem Format der Event-Nachricht an.

    Tabelle : 1. Header-Werte für den Content-Type anfordern
    Nachrichtenformat Content-Typenwert
    JSON Anwendung/JSON
    XML application/xml
    text text/plain

    Authentifizierungs- und Datensicherheitsoptionen

    Optionen für Authentifizierung und Datensicherheit:
    • Authentifizierungstyp: Diese Option kann entweder auf API-Schlüssel oder auf Standard festgelegt werden.
    • Mit Sichere Verbindung können Sie auswählen, ob eingehende und ausgehende Daten bei der Übertragung gesichert werden. Wenn Sie die Option für erweiterte Sicherheit auswählen, müssen Sie ein Zertifikat von einer bekannten Zertifizierungsstelle abrufen und dann den Schlüsselspeicher-Zertifikat-Alias und das Schlüsselspeicher-Passwort angeben.
    • Einheitlichen MID-Schlüsselspeicher verwenden: Diese Option bietet Verschlüsselungsschutz und ermöglicht es Ihnen, ein benutzerdefiniertes Zertifikat im einheitlichen MID-Server-Schlüsselspeicher zu installieren. Weitere Informationen finden Sie unter Benutzerdefinierte Zertifikate im einheitlichen Schlüsselspeicher des MID Servers installieren.
    • Benutzer müssen eine Skripteinbindung angeben, die JSON-, XML- oder Text-formatierte Event-Nachrichten in einer Textvariablen empfängt. Das Skript muss über eine transform ()-Funktion verfügen, die die Transformation durchführt und das Rückgabe-Array von Event-Objekten vorbereitet. Die Skripteinbindung TransformEvents_xmlSample, die Events aus dem XML-Format umwandelt, wird als Beispiel angegeben, wenn das Ereignismanagement-Plugin aktiviert ist.
    Weitere Informationen zu Authentifizierung und Datensicherheit finden Sie unter MID-Webservererweiterung konfigurieren.