ManageEngine Exchange Reporter Plus-Logs erfassen
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
- Rufen Sie die Einstellungen > Datenverwaltung > Feeds auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Feeds auf.
- Klicken Sie auf Neuen Feed hinzufügen.
- Klicken Sie auf der nächsten Seite auf Einzelnen Feed konfigurieren.
- Geben Sie im Feld Feedname einen Namen für den Feed ein, z. B.
ManageEngine Exchange Reporter Plus Logs. - Wählen Sie Webhook als Quelltyp aus.
- Wählen Sie ManageEngine Exchange Reporter Plus als Protokolltyp aus.
- Klicken Sie auf Weiter.
- Geben Sie Werte für die folgenden Eingabeparameter an:
- Trennzeichen für Aufteilung (optional): Geben Sie
\nein, 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.
- Trennzeichen für Aufteilung (optional): Geben Sie
- Klicken Sie auf Weiter.
- 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:
- Klicken Sie auf der Feed-Detailseite auf Geheimen Schlüssel generieren.
- In einem Dialogfeld wird der geheime Schlüssel angezeigt.
- 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
- Gehen Sie zum Tab Details des Feeds.
- Kopieren Sie im Abschnitt Endpunktinformationen die Feed-Endpunkt-URL.
Das URL-Format lautet:
https://{region}-chronicle.googleapis.com/v1/{parent}/logs:importDabei ist
{region}die Region Ihrer Google SecOps-Instanz (z. B.us,europeoderasia-southeast1) und{parent}der Ressourcenpfad im Formatprojects/<PROJECT_ID>/locations/<LOCATION>/instances/<INSTANCE_ID>/logTypes/<LOG_TYPE>.Speichern Sie diese URL für die nächsten Schritte.
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
- Rufen Sie die Seite „Anmeldedaten“ derGoogle Cloud Console auf.
- Wählen Sie Ihr Projekt aus (das Projekt, das mit Ihrer Chronicle-Instanz verknüpft ist).
- Klicken Sie auf Anmeldedaten erstellen > API-Schlüssel.
- Ein API-Schlüssel wird erstellt und in einem Dialogfeld angezeigt.
- Klicken Sie auf API-Schlüssel bearbeiten, um den Schlüssel einzuschränken.
API-Schlüssel einschränken
- 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).
- Name: Geben Sie einen aussagekräftigen Namen ein (z. B.
- Gehen Sie unter API-Einschränkungen so vor:
- Wählen Sie Schlüssel einschränken aus.
- Suchen Sie im Drop-down-Menü APIs auswählen nach der Google SecOps API (oder Chronicle API) und wählen Sie sie aus.
- Klicken Sie auf Speichern.
- Kopieren Sie den Wert des API-Schlüssels aus dem Feld API-Schlüssel oben auf der Seite.
- 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
- Melden Sie sich als Administrator in der Webkonsole von ManageEngine Exchange Reporter Plus an.
- Gehen Sie zu Einstellungen > Verwaltung > Allgemeine Einstellungen > Logweiterleitung.
- Klicken Sie das Kästchen Logweiterleitung aktivieren an.
- Klicken Sie auf den Tab Webhook.
- 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).
- Im Abschnitt Erweiterte Einstellungen:
- Klicken Sie auf HTTP-Anfrageheader.
- Fügen Sie den folgenden Header hinzu:
- Key:
Content-Type - Wert:
application/json
- Key:
Klicken Sie auf Speichern.
Logweiterleitung prüfen
- Nach dem Speichern der Konfiguration leitet Exchange Reporter Plus Audit-Logs über den Webhook-Endpunkt an Google SecOps weiter.
- 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_PLUSangezeigt 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.
Methode 1: Benutzerdefinierte Header (empfohlen)
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