Microsoft SharePoint-Logs (Office 365) erfassen
In diesem Dokument wird beschrieben, wie Sie Microsoft SharePoint-Logs (Office 365) mit Bindplane in Google Security Operations erfassen.
Microsoft SharePoint ist eine webbasierte Plattform für die Zusammenarbeit, die in Microsoft 361 eingebunden ist. In SharePoint-Audit-Logs werden Nutzeraktivitäten wie Dateioperationen, Ordneraktivitäten, Freigabeaktionen, Listenoperationen und Websiteverwaltungsaktionen erfasst. Der Zugriff auf diese Protokolle erfolgt über den SIEM-Agent von Microsoft Defender for Cloud Apps, der Audit-Daten von SharePoint Online und OneDrive for Business abruft und als Syslog an einen lokalen Empfänger streamt.
Hinweis
Prüfen Sie, ob folgende Voraussetzungen erfüllt sind:
- Eine Google SecOps-Instanz
- Windows Server 2016 oder höher oder Linux-Host mit
systemd - Wenn Sie hinter einem Proxy arbeiten, müssen die Firewallports geöffnet sein.
- Microsoft 365-Mandant mit SharePoint Online
- Microsoft Defender for Cloud Apps-Lizenz (in Microsoft 365 E5 enthalten oder als Add-on verfügbar)
- Rolle „Globaler Administrator“ oder „Sicherheitsadministrator“ im Microsoft Defender-Portal
- Einen Windows- oder Linux-Server mit Java 8 oder höher, auf dem der SIEM-Agent ausgeführt wird (kann derselbe Host wie Bindplane sein)
- Einheitliches Audit-Logging in Microsoft 365 aktiviert
Einheitliches Audit-Logging aktivieren
Bevor Microsoft Defender for Cloud Apps SharePoint-Auditdaten erfassen kann, muss das einheitliche Audit-Logging für Ihren Microsoft 365-Mandanten aktiviert werden.
- Melden Sie sich im Microsoft Purview-Complianceportal an.
- Gehen Sie zu Prüfung.
- Klicken Sie bei entsprechender Aufforderung auf Aufzeichnung von Nutzer- und Administratoraktivitäten starten. Hinweis: Nach dem Aktivieren des einheitlichen Audit-Loggings kann es bis zu 12 Stunden dauern, bis Inhalte verfügbar sind.
Alternativ können Sie das einheitliche Audit-Logging mit PowerShell aktivieren:
Connect-ExchangeOnline Set-AdminAuditLogConfig -UnifiedAuditLogIngestionEnabled $true
Google SecOps-Anmeldedaten für den Bindplane-Agenten abrufen
Wählen Sie eine der folgenden Methoden aus, um den Bindplane-Agenten bei Google SecOps zu authentifizieren:
- Neue Bereitstellungen: Verwenden Sie die Chronicle API (Option 1).
- Legacy-Bereitstellungen: Verwenden Sie die Authentifizierungsdatei für die Datenaufnahme (Option 2) weiter, bis die Ingestion API am 20. Juli 2027 eingestellt wird.
Option 1: Dienstkonto für die Chronicle API erstellen (empfohlen)
- Melden Sie sich in der Google Cloud -Konsole an und wählen Sie das Google Cloud -Projekt aus, das mit Ihrer Google SecOps-Instanz verknüpft ist.
- Rufen Sie IAM und Verwaltung > Dienstkonten auf.
- Klicken Sie auf Dienstkonto erstellen.
- Geben Sie die folgenden Konfigurationsdetails an:
- Name des Dienstkontos: Geben Sie einen Namen für das Konto ein (z. B.
bindplane-ingest). - Dienstkontobeschreibung: Geben Sie eine Beschreibung ein (z. B.
Bindplane agent log ingestion).
- Name des Dienstkontos: Geben Sie einen Namen für das Konto ein (z. B.
- Klicken Sie auf Erstellen und fortfahren.
- Klicken Sie im Abschnitt Diesem Dienstkonto Zugriff auf das Projekt erteilen auf Rolle auswählen und wählen Sie Chronicle Editor aus.
- Klicken Sie auf Weiter und dann auf Fertig.
- Klicken Sie auf das von Ihnen erstellte Dienstkonto und rufen Sie den Tab Schlüssel auf.
- Klicken Sie auf Schlüssel hinzufügen > Neuen Schlüssel erstellen.
- Wählen Sie JSON aus und klicken Sie auf Erstellen. Die Schlüsseldatei wird auf Ihren Computer heruntergeladen.
- Speichern Sie die Schlüsseldatei als
ingestion-auth.jsonim Bindplane-Collector-Verzeichnis (/opt/observiq-otel-collector/ingestion-auth.jsonunter Linux oderC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonunter Windows) oder aktualisieren Siecreds_file_pathinconfig.yaml, sodass der Pfad mit dem Pfad übereinstimmt, unter dem Sie die Datei speichern. - Rufen Sie IAM und Verwaltung > Einstellungen auf und kopieren Sie die Projektnummer. Sie benötigen sie für die Exporter-Konfiguration.
Option 2: Authentifizierungsdatei für die Datenaufnahme herunterladen (Legacy)
- Melden Sie sich in der Google SecOps-Konsole an.
- Rufen Sie Einstellungen > Datenverwaltung > Erfassungs-Agents auf. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Erfassungs-Agents auf.
- Laden Sie die Authentifizierungsdatei für die Datenaufnahme herunter.
- Speichern Sie die Datei sicher auf dem System, auf dem der Bindplane-Agent installiert werden soll.
Google SecOps-Kundennummer abrufen
- Melden Sie sich in der Google SecOps-Konsole an.
- Gehen Sie zu Einstellungen > Verwaltung > Profil. Wenn Sie eine reine SIEM-Plattform verwenden, rufen Sie die Einstellungen > Profil auf.
Kopieren und speichern Sie die Kundennummer aus dem Bereich Organisationsdetails.
Bindplane-Agent installieren
Installieren Sie den Bindplane-Agenten gemäß der folgenden Anleitung auf Ihrem Windows- oder Linux-Betriebssystem.
Windows-Installation
- Öffnen Sie die Eingabeaufforderung oder PowerShell als Administrator.
Führen Sie dazu diesen Befehl aus:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietWarten Sie, bis die Installation abgeschlossen ist.
Überprüfen Sie die Installation mit folgendem Befehl:
sc query observiq-otel-collectorDer Dienst sollte als RUNNING angezeigt werden.
Linux-Installation
- Öffnen Sie ein Terminal mit Root- oder sudo-Berechtigungen.
Führen Sie dazu diesen Befehl aus:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.shWarten Sie, bis die Installation abgeschlossen ist.
Überprüfen Sie die Installation mit folgendem Befehl:
sudo systemctl status observiq-otel-collectorDer Dienst sollte als active (running) angezeigt werden.
Zusätzliche Installationsressourcen
Weitere Installationsoptionen und Informationen zur Fehlerbehebung finden Sie in der Installationsanleitung für den Bindplane-Agenten.
Bindplane-Agent für die Aufnahme von Syslog und das Senden an Google SecOps konfigurieren
Konfigurationsdatei suchen
Linux:
sudo nano /opt/observiq-otel-collector/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
Konfigurationsdatei bearbeiten
Ersetzen Sie den gesamten Inhalt von
config.yamldurch die folgende Konfiguration:receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/sharepoint: protocol: https # Region of your instance, for example us, europe, asia-southeast1 location: <LOCATION> # Project number of the Google Cloud project linked to the instance project: '<PROJECT_NUMBER>' compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: '<CUSTOMER_ID>' endpoint: chronicle.googleapis.com log_type: SHAREPOINT raw_log_field: body service: pipelines: logs/sharepoint_to_chronicle: receivers: - udplog exporters: - chronicle/sharepoint
Konfigurationsparameter
Ersetzen Sie die folgenden Platzhalter:
Exporter-Konfiguration:
<CUSTOMER_ID>: Die im vorherigen Schritt kopierte Google SecOps-Kundennummer- creds_file_path: Vollständiger Pfad zur JSON-Schlüsseldatei des Dienstkontos (Option 1):
- Linux:
/opt/observiq-otel-collector/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
location: Ersetzen Sie<LOCATION>durch die Region Ihrer Google SecOps-Instanz (z. B.us,europeoderasia-southeast1). Der Exporter stellt diesem Wertchronicle.googleapis.comvoran. Eine vollständige Liste finden Sie unter Regionale Endpunkte.project: Ersetzen Sie<PROJECT_NUMBER>durch die Projektnummer aus IAM & Verwaltung > Einstellungen.endpoint: Behalten Sie die Einstellungchronicle.googleapis.combei.
Legacy-Ingestion-API-Exporter
Wenn Sie die Authentifizierungsdatei für die Datenaufnahme aus Option 2 verwenden, ersetzen Sie den Block
exportersdurch Folgendes. Legen Sie fürcreds_file_pathden Pfad zur Authentifizierungsdatei für die Datenaufnahme fest. Wenn sich Ihre Instanz außerhalb der USA befindet, ersetzen Siemalachiteingestion-pa.googleapis.comdurch Ihren regionalen Endpunkt (z. B.europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/sharepoint: compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: '<CUSTOMER_ID>' endpoint: malachiteingestion-pa.googleapis.com log_type: SHAREPOINT raw_log_field: body
Konfigurationsdatei speichern
- Speichern Sie die Datei nach der Bearbeitung:
- Linux: Drücken Sie
Ctrl+O, dannEnterund dannCtrl+X. - Windows: Klicken Sie auf Datei > Speichern.
- Linux: Drücken Sie
Starten Sie den Bindplane-Agent neu, um die Änderungen zu übernehmen.
So starten Sie den Bindplane-Agenten unter Linux neu:
Führen Sie dazu diesen Befehl aus:
sudo systemctl restart observiq-otel-collectorPrüfen Sie, ob der Dienst ausgeführt wird:
sudo systemctl status observiq-otel-collectorPrüfen Sie die Logs auf Fehler:
sudo journalctl -u observiq-otel-collector -f
So starten Sie den Bindplane-Agenten unter Windows neu:
Wählen Sie eine der folgenden Optionen aus:
- Eingabeaufforderung oder PowerShell als Administrator:
net stop observiq-otel-collector && net start observiq-otel-collector- Dienstkonsole:
- Drücken Sie
Win+R, geben Sieservices.mscein und drücken Sie die Eingabetaste. - Suchen Sie nach observIQ OpenTelemetry Collector.
- Rechtsklicken Sie und wählen Sie Neu starten aus.
- Drücken Sie
Prüfen Sie, ob der Dienst ausgeführt wird:
sc query observiq-otel-collectorPrüfen Sie die Logs auf Fehler:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
Microsoft Defender for Cloud Apps-SIEM-Agent so konfigurieren, dass SharePoint-Protokolle weitergeleitet werden
Microsoft SharePoint Online ist ein Clouddienst und hat keine integrierte Funktion zur Weiterleitung von Syslog-Nachrichten. Wenn Sie SharePoint-Audit-Logs über Syslog weiterleiten möchten, verwenden Sie den SIEM-Agent von Microsoft Defender for Cloud Apps. Dieser ruft Benachrichtigungen und Aktivitäten aus Defender for Cloud Apps ab und streamt sie als Syslog-Nachrichten (im CEF-Format) an den Bindplane-Agent.
Voraussetzungen für den SIEM-Agenten
Einen Windows- oder Linux-Server (kann eine virtuelle Maschine sein) mit:
- Java 8 oder höher installiert
- Transport Layer Security (TLS) 1.2 oder höher
- CPU: 2 Kerne
- Speicherplatz: 20 GB
- RAM: 2 GB
Schritt 1: SIEM-Agent im Microsoft Defender-Portal konfigurieren
- Melden Sie sich im Microsoft Defender-Portal an.
- Wählen Sie Einstellungen aus.
- Wählen Sie Cloud-Apps aus.
- Wählen Sie unter System die Option SIEM-Agents aus.
- Klicken Sie auf SIEM-Agent hinzufügen und wählen Sie dann Generisches SIEM aus.
- Klicken Sie auf Start Wizard (Assistent starten).
- Geben Sie die folgenden Konfigurationsdetails an:
- Name: Geben Sie einen aussagekräftigen Namen ein (z. B.
Chronicle-Bindplane-SharePoint). - SIEM-Format auswählen: Wählen Sie CEF aus.
- Name: Geben Sie einen aussagekräftigen Namen ein (z. B.
- Klicken Sie auf Weiter.
- Geben Sie die folgenden Syslog-Verbindungsdetails an:
- Remote-Syslog-Host: Geben Sie die IP-Adresse oder den Hostnamen des Bindplane-Agent-Hosts ein (z. B.
192.168.1.100). - Syslog-Portnummer: Geben Sie
514ein (oder den in der Bindplane-Agent-Dateiconfig.yamlkonfigurierten Port). - Remote-Syslog-Protokoll: Wählen Sie UDP aus (muss mit dem Empfängertyp in der Bindplane-Agent-Konfiguration übereinstimmen).
- Remote-Syslog-Host: Geben Sie die IP-Adresse oder den Hostnamen des Bindplane-Agent-Hosts ein (z. B.
- Klicken Sie auf Weiter.
- Konfigurieren Sie die zu exportierenden Datentypen:
- Aktivieren Sie den Schieberegler für Aktivitäten.
- Legen Sie im Drop-down-Menü Anwenden auf für Aktivitäten Filter fest, um SharePoint-Aktivitäten einzuschließen:
- Wählen Sie App ist gleich und dann Microsoft SharePoint Online und Microsoft OneDrive for Business aus.
- Aktivieren Sie den Schieberegler für Benachrichtigungen, wenn Sie auch Richtlinienbenachrichtigungen zu SharePoint erhalten möchten.
- Klicken Sie auf Ergebnisse bearbeiten und Vorschau ansehen, um zu prüfen, ob der Filter mit den erwarteten Aktivitäten übereinstimmt.
- Klicken Sie auf Weiter.
- Kopieren Sie das Token, das auf der Übersichtsseite angezeigt wird, und speichern Sie es an einem sicheren Ort.
Klicken Sie auf Beenden.
Schritt 2: JAR-Datei des SIEM-Agents herunterladen und ausführen
- Laden Sie den SIEM-Agenten aus dem Microsoft Download Center herunter.
- Extrahieren Sie die heruntergeladene ZIP-Datei auf dem Server, auf dem der SIEM-Agent ausgeführt werden soll.
Führen Sie den SIEM-Agent mit dem folgenden Befehl aus:
java -jar mcas-siemagent-0.87.20-signed.jar --token <TOKEN>
Ersetzen Sie <TOKEN> durch das Token, das Sie aus dem Microsoft Defender-Portal kopiert haben.
Schritt 3: SIEM-Agent für die Ausführung als Dienst konfigurieren
Damit Logs kontinuierlich weitergeleitet werden, konfigurieren Sie den SIEM-Agent so, dass er automatisch gestartet wird:
Linux:
Fügen Sie den Ausführungsbefehl zu
/etc/rc.localhinzu oder erstellen Sie einen systemd-Dienst:java -jar /opt/mcas-siemagent/mcas-siemagent-0.87.20-signed.jar --token <TOKEN> &
Windows:
- Geplante Aufgabe konfigurieren:
- Öffnen Sie die Aufgabenplanung.
- Erstellen Sie eine neue Aufgabe mit der Option Unabhängig von der Benutzeranmeldung ausführen.
- Legen Sie die Aktion zum Ausführen der JAR-Datei mit dem Token-Parameter fest.
- Entfernen Sie das Häkchen bei Aufgabe beenden, wenn sie länger ausgeführt wird als.
Schritt 4: SIEM-Agent-Verbindung prüfen
- Rufen Sie im Microsoft Defender-Portal die Einstellungen > Cloud-Apps > SIEM-Agents auf.
- Prüfen Sie, ob der SIEM-Agent-Status Verbunden (grün) lautet.
Prüfen Sie auf dem Bindplane-Agent-Host, ob Syslog-Nachrichten empfangen werden:
sudo journalctl -u observiq-otel-collector -fSuchen Sie in Google SecOps nach Logs mit
metadata.log_type = "SHAREPOINT", um die Logaufnahme zu bestätigen.
UDM-Zuordnungstabelle
| Logfeld | UDM-Zuordnung | Logik |
|---|---|---|
| Aufgetreten | metadata.event_timestamp | Geparsed mit Datumsfilter mit den Formaten „MM/dd/yyyy HH:mm:ss A“, „MM/dd/yyyy HH:mm:ss a“, „M/d/yyyy HH:mm:ss A“ |
| has_principal | metadata.event_type | Wird auf „USER_RESOURCE_ACCESS“ gesetzt, wenn „has_principal“ und („has_target_resource“ oder „has_target“) vorhanden sind, andernfalls auf „STATUS_UPDATE“, wenn „has_principal“ vorhanden ist, andernfalls auf „GENERIC_EVENT“ |
| has_target_resource | metadata.event_type | |
| has_target | metadata.event_type | |
| metadata.product_name | metadata.product_name | Legen Sie diesen Wert auf „SHAREPOINT“ fest. |
| EventData | metadata.product_version | Wert direkt kopiert |
| metadata.vendor_name | metadata.vendor_name | Legen Sie diesen Wert auf „SHAREPOINT“ fest. |
| Erstellt | principal.asset.attribute.labels | Zusammengeführte Labels mit dem Schlüssel „Created“ aus „Created“ und dem Schlüssel „Last Modified“ aus „LastModified“ |
| LastModified | principal.asset.attribute.labels | |
| SamAccountName | principal.asset.hostname | Wert direkt kopiert |
| SamAccountName | principal.hostname | Wert direkt kopiert |
| Datenbank | principal.process.file.names | Aus Datenbank zusammengeführt |
| UserEmail | principal.user.email_addresses | Zusammengeführt aus UserEmail, wenn es mit dem regulären Ausdruck für E‑Mail-Adressen übereinstimmt |
| Nutzername | principal.user.user_display_name | Wert direkt kopiert |
| EventType | security_result.description | Wert direkt kopiert |
| Verzeichnis | target.file.full_path | Wert direkt kopiert |
| Blatt | target.file.names | Aus Leaf zusammengeführt |
| ItemType | target.resource.type | Wert direkt kopiert |
| SecUserURL | target.url | Wert direkt kopiert |
| SecUserRole | target.user.attribute.roles | Zusammengeführte Rolle mit Namen aus SecUserRole |
| SecUserEmail | target.user.email_addresses | Zusammengeführt aus SecUserEmail, wenn Übereinstimmung mit regulärem Ausdruck für E‑Mail-Adressen vorliegt |
| SecGroupName | target.user.group_identifiers | Zusammengeführt aus SecGroupName |
| SecUserName | target.user.user_display_name | Wert direkt kopiert |
| SecSamAccountName | target.user.userid | Wert direkt kopiert |
Änderungsprotokoll
Änderungsprotokoll für diesen Parser ansehen
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten