ManageEngine Exchange Reporter Plus-Logs erfassen

Unterstützt in:

In diesem Dokument wird beschrieben, wie Sie ManageEngine Exchange Reporter Plus so konfigurieren, dass Logs mithilfe von Webhooks an Google Security Operations gesendet werden.

ManageEngine Exchange Reporter Plus ist eine webbasierte Lösung für Berichterstellung, Auditing und Monitoring für Microsoft Exchange Server- und Exchange Online-Umgebungen. Es bietet umfassende Berichte zu Postfachgrößen, E-Mail-Traffic, öffentlichen Ordnern, Exchange ActiveSync-Protokollen und Audit-Logs für Administratoraktivitäten und Konfigurationsänderungen in hybriden Exchange-Bereitstellungen.

Hinweis

Prüfen Sie, ob die folgenden Voraussetzungen erfüllt sind:

  • Eine Google SecOps-Instanz
  • ManageEngine Exchange Reporter Plus ist installiert und für die Überwachung von Exchange Server oder Exchange Online konfiguriert.
  • Administratorzugriff auf die Webkonsole von ManageEngine Exchange Reporter Plus
  • Zugriff auf die Google Cloud Console (zum Erstellen von API-Schlüsseln)

Webhook-Feed in Google SecOps erstellen

Feed erstellen

  1. Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
  2. Klicken Sie auf Neuen Feed hinzufügen.
  3. Klicken Sie auf der nächsten Seite auf Einzelnen Feed konfigurieren.
  4. Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B. ManageEngine Exchange Reporter Plus Logs.
  5. Wählen Sie Webhook als Quelltyp aus.
  6. Wählen Sie ManageEngine Exchange Reporter Plus als Protokolltyp aus.
  7. Klicken Sie auf Weiter.
  8. Geben Sie Werte für die folgenden Eingabeparameter an:
    • Trennzeichen für Aufteilung (optional): Geben Sie \n ein, um mehrzeilige Ereignisse aufzuteilen.
    • Asset-Namespace: Der Asset-Namespace
    • Labels für Datenaufnahme: Das Label, das auf die Ereignisse aus diesem Feed angewendet werden soll.
  9. Klicken Sie auf Weiter.
  10. Prüfen Sie die neue Feedkonfiguration auf dem Bildschirm Abschließen und klicken Sie dann auf Senden.

Secret-Schlüssel generieren und speichern

Nachdem Sie den Feed erstellt haben, müssen Sie einen Secret-Schlüssel für die Authentifizierung generieren:

  1. Klicken Sie auf der Feed-Detailseite auf Geheimen Schlüssel generieren.
  2. In einem Dialogfeld wird der geheime Schlüssel angezeigt.
  3. Kopieren und speichern Sie den geheimen Schlüssel an einem sicheren Ort.

Wichtig: Der geheime Schlüssel wird nur einmal angezeigt und kann später nicht mehr abgerufen werden. Wenn Sie ihn verlieren, müssen Sie einen neuen geheimen Schlüssel generieren.

Feed-Endpunkt-URL abrufen

  1. Gehen Sie zum Tab Details des Feeds.
  2. Kopieren Sie im Abschnitt Endpunktinformationen die Feed-Endpunkt-URL.
  3. Das URL-Format lautet:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import
    

    Dabei ist {region} die Region Ihrer Google SecOps-Instanz (z. B. us, europe oder asia-southeast1) und {parent} der Ressourcenpfad im Format projects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.

  4. Speichern Sie diese URL für die nächsten Schritte.

  5. Klicken Sie auf Fertig.

Google Cloud API-Schlüssel erstellen

Chronicle erfordert einen API-Schlüssel für die Authentifizierung. Erstellen Sie in der Google Cloud Console einen eingeschränkten API-Schlüssel.

API-Schlüssel erstellen

  1. Rufen Sie die Seite „Anmeldedaten“ derGoogle Cloud Console auf.
  2. Wählen Sie Ihr Projekt aus (das Projekt, das mit Ihrer Chronicle-Instanz verknüpft ist).
  3. Klicken Sie auf Anmeldedaten erstellen > API-Schlüssel.
  4. Ein API-Schlüssel wird erstellt und in einem Dialogfeld angezeigt.
  5. Klicken Sie auf API-Schlüssel bearbeiten, um den Schlüssel einzuschränken.

API-Schlüssel einschränken

  1. Auf der Seite mit den Einstellungen für den API-Schlüssel:
    • Name: Geben Sie einen aussagekräftigen Namen ein (z. B. Chronicle Webhook API Key).
  2. Gehen Sie unter API-Einschränkungen so vor:
    1. Wählen Sie Schlüssel einschränken aus.
    2. Suchen Sie im Drop-down-Menü APIs auswählen nach der Google SecOps API (oder Chronicle API) und wählen Sie sie aus.
  3. Klicken Sie auf Speichern.
  4. Kopieren Sie den Wert des API-Schlüssels aus dem Feld API-Schlüssel oben auf der Seite.
  5. Speichern Sie den API-Schlüssel an einem sicheren Ort.

ManageEngine Exchange Reporter Plus-Webhook konfigurieren

Webhook-URL erstellen

  • Kombinieren Sie die Chronicle-Endpunkt-URL, den API-Schlüssel und den Secret-Schlüssel:

    <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>
    
  • Beispiel:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
    

Logweiterleitung in Exchange Reporter Plus konfigurieren

  1. Melden Sie sich als Administrator in der Webkonsole von ManageEngine Exchange Reporter Plus an.
  2. Gehen Sie zu Einstellungen > Verwaltung > Allgemeine Einstellungen > Logweiterleitung.
  3. Klicken Sie das Kästchen Logweiterleitung aktivieren an.
  4. Klicken Sie auf den Tab Webhook.
  5. Geben Sie die folgenden Konfigurationsdetails an:
    • HTTP-Methode: Wählen Sie POST aus.
    • HTTP-URL: Fügen Sie die vollständige Webhook-URL ein, die Sie im vorherigen Schritt erstellt haben (die Chronicle-Endpunkt-URL mit dem API-Schlüssel und dem geheimen Schlüssel als Suchparameter).
  6. Im Abschnitt Erweiterte Einstellungen:
    1. Klicken Sie auf HTTP-Anfrageheader.
    2. Fügen Sie den folgenden Header hinzu:
      • Key: Content-Type
      • Wert: application/json
  7. Klicken Sie auf Speichern.

Logweiterleitung prüfen

  1. Nach dem Speichern der Konfiguration leitet Exchange Reporter Plus Audit-Logs über den Webhook-Endpunkt an Google SecOps weiter.
  2. Melden Sie sich in der Google SecOps-Konsole an und prüfen Sie, ob Logs auf der Oberfläche Suche mit dem Aufnahmelabel MANAGE_ENGINE_REPORTER_PLUS angezeigt werden.

Firewallkonfiguration

Die folgenden Firewallregeln müssen konfiguriert sein.

Ausgehend vom Exchange Reporter Plus-Server:

  • Protokoll: HTTPS (TCP 443)
  • Ziel: Regionaler Chronicle-Endpunkt (<region>-chronicle.googleapis.com)
  • Zweck: Protokollbereitstellung an Google SecOps über Webhook

Referenz zu Authentifizierungsmethoden

Chronicle-Webhook-Feeds unterstützen mehrere Authentifizierungsmethoden. Wählen Sie die Methode aus, die von Ihrem Anbieter unterstützt wird.

Wenn Ihr Anbieter benutzerdefinierte HTTP-Header unterstützt, verwenden Sie diese Methode, um die Sicherheit zu erhöhen.

  • Anfrageformat:

    POST <ENDPOINT_URL> HTTP/1.1
    Content-Type: application/json
    x-goog-chronicle-auth: <API_KEY>
    x-chronicle-auth: <SECRET_KEY>
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

Vorteile:

  • API-Schlüssel und Secret sind in der URL nicht sichtbar.
  • Sicherer (Header werden nicht in Webserver-Zugriffslogs protokolliert)
  • Bevorzugte Methode, wenn der Anbieter sie unterstützt

Methode 2: Suchparameter

Wenn Ihr Anbieter keine benutzerdefinierten Header unterstützt, hängen Sie die Anmeldedaten an die URL an.

  • URL-Format:

    <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY>
    
  • Beispiel:

    https://{region}-chronicle.googleapis.com/v1/{parent}/logs:import?key=AIzaSyD...&secret=abcd1234...
    
  • Anfrageformat:

    POST <ENDPOINT_URL>?key=<API_KEY>&secret=<SECRET_KEY> HTTP/1.1
    Content-Type: application/json
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

Nachteile: – Anmeldedaten sind in der URL sichtbar – Können in Zugriffsprotokollen des Webservers protokolliert werden – Weniger sicher als Header

Methode 3: Hybrid (URL + Header)

Bei einigen Konfigurationen wird der API-Schlüssel in der URL und der geheime Schlüssel im Header verwendet.

  • Anfrageformat:

    POST <ENDPOINT_URL>?key=<API_KEY> HTTP/1.1
    Content-Type: application/json
    x-chronicle-auth: <SECRET_KEY>
    
    {
            "event": "data",
            "timestamp": "2025-01-15T10:30:00Z"
    }
    

Namen der Authentifizierungsheader

Chronicle akzeptiert die folgenden Headernamen für die Authentifizierung:

Für API-Schlüssel:

  • x-goog-chronicle-auth (empfohlen)
  • X-Goog-Chronicle-Auth (Groß-/Kleinschreibung wird nicht berücksichtigt)

Für den geheimen Schlüssel:

  • x-chronicle-auth (empfohlen)
  • X-Chronicle-Auth (Groß-/Kleinschreibung wird nicht berücksichtigt)

Webhook-Limits und Best Practices

Anfragelimits

Limit Wert
Maximale Anfragegröße 4 MB
Maximale Abfragen pro Sekunde 15.000
Zeitlimit für Anfragen 30 Sekunden
Wiederholungsverhalten Automatisch mit exponentiellem Backoff

UDM-Zuordnungstabelle

Logfeld UDM-Zuordnung Logik
msg.OrganizationId additional.fields Zusammengeführte Labels mit dem Schlüssel „OrganizationId“ und dem Wert aus msg.OrganizationId; Schlüssel „MailboxGuid“ und Wert aus msg.MailboxGuid; Schlüssel „RecordType“ und Wert aus msg.RecordType
msg.MailboxGuid additional.fields
msg.RecordType additional.fields
msg.CreationTime metadata.event_type Wird auf den Wert von „event_type“ gesetzt, wenn nicht leer; andernfalls „USER_UNCATEGORIZED“, wenn msg.Operation == „Update“; andernfalls „USER_CREATION“, wenn msg.Operation == „Create“ und msg.MailboxOwnerUPN nicht leer; andernfalls „USER_UNCATEGORIZED“, wenn msg.Operation == „Create“; andernfalls „USER_UNCATEGORIZED“, wenn msg.UserId nicht leer; andernfalls „STATUS_UPDATE“, wenn msg.ClientIP nicht leer; andernfalls „GENERIC_EVENT“
msg.Operation metadata.product_event_type Wert direkt kopiert
msg.Id metadata.product_log_id Wert direkt kopiert
msg.ClientVersion metadata.product_version Wert aus msg.ClientVersion, wenn nicht leer, andernfalls msg.Version in String konvertiert
msg.Version metadata.product_version
AffectedItems.0.InternetMessageId network.email.mail_id Gsub <
AffectedItems network.email.subject Als JSON geparst, item.Subject extrahiert, zusammengeführt, falls gefunden
msg.ClientInfoString network.http.user_agent Wert aus msg.ClientInfoString, wenn nicht leer, andernfalls msg.Client
msg.Client network.http.user_agent
msg.ClientProcessName principal.application Wert direkt kopiert
msg.OriginatingServer principal.hostname Mit Grok-Muster extrahiert, falls erfolgreich, andernfalls wird der Wert direkt kopiert
clientIP principal.ip Mit grok aus msg.ClientIP extrahiert
clientPort principal.port Mit Grok aus msg.ClientIP extrahiert, in Ganzzahl konvertiert
msg.UserKey principal.user.attribute.labels Label-Schlüssel auf „UserKey“, Wert auf „msg.UserKey“, zusammengeführt
msg.UserType principal.user.attribute.roles roles.name auf msg.UserType festlegen, zusammengeführt
msg.UserId principal.user.email_addresses Zusammengeführt, wenn msg.UserId mit dem regulären Ausdruck für E‑Mail-Adressen übereinstimmt
msg.UserId principal.user.userid Wert direkt kopiert
msg.MailboxOwnerSid principal.user.windows_sid Wert aus msg.MailboxOwnerSid, wenn nicht leer, andernfalls msg.LogonUserSid
msg.LogonUserSid principal.user.windows_sid
security_result security_result Zusammengeführt aus security_result-Hash
security_result_action security_result.action Zusammengeführt aus security_result_action
msg.ResultStatus security_result.action_details Wert direkt kopiert
msg.RecordType security_result.detection_fields In String konvertiert, Schlüssel „RecordType“ festgelegt, Wert auf msg.RecordType, zusammengeführt
msg.OrganizationName target.administrative_domain Wert direkt kopiert
msg.DestFolder target.file.full_path „fileId“ und „filePath“ wurden mit grok extrahiert, Backslashes wurden mit gsub ersetzt und als „fileId/filePath“ verkettet
Host target.hostname Wert direkt kopiert
msg.Folder target.process.parent_process.file.full_path „parentFileId“ und „parentFilePath“ wurden mit grok extrahiert, Backslashes wurden mit gsubs ersetzt und als „parentFileId/parentFilePath“ verkettet
msg.MailboxOwnerUPN target.user.email_addresses Zusammengeführt, wenn mit regulärem Ausdruck für E‑Mail-Adressen übereinstimmt
msg.MailboxOwnerUPN target.user.user_display_name Festlegen, ob Leerzeichen enthalten sind
msg.MailboxOwnerUPN target.user.userid Festlegen, wenn keine E‑Mail-Adresse und kein Leerzeichen vorhanden ist
metadata.product_name metadata.product_name Legen Sie diesen Wert auf „Manage Engine“ fest.
metadata.vendor_name metadata.vendor_name Legen Sie „Manage Engine Reporter Plus“ fest.

Änderungsprotokoll

Änderungsprotokoll für diesen Parser ansehen

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten