So exportieren Sie das Microsoft 365 Unified Audit Log

So exportieren Sie das Microsoft 365 Unified Audit Log

SOC Prime Team
SOC Prime Team linkedin icon Folgen

Das Purview-Portal (Audit → Suche) ermöglicht die Suche im Unified Audit Log und den Export der Ergebnisse in eine CSV-Datei. Das vollständige Ereignis befindet sich in einer Spalte, AuditData, als JSON-Blob. Um sauberes JSON zu erhalten, ein Ereignis pro Zeile, verwenden Sie Exchange Online PowerShell und Search-UnifiedAuditLog. Das Skript befindet sich unten. Die Standardaufbewahrung für Audits beträgt 180 Tage; Audit (Premium) speichert standardmäßig ein Jahr.

Das Unified Audit Log deckt Exchange, SharePoint, OneDrive, Teams und administrative Aktivitäten an einem Ort ab. Bei einem Geschäftsemail-Kompromiss ist es der Ort, an dem die Posteingangsregeln, das Weiterleiten und das Massen-Downloaden auftauchen. Prime Core hat 79 Erkennungsregeln für Microsoft 365-Auditdaten, die 33 MITRE ATT&CK-Techniken zugeordnet sind. Darunter: Weiterleitungsregeln, die E-Mails absaugen (T1114.003), zusätzliche Postfachberechtigungen (T1098.002) und Daten, die von SharePoint abgerufen wurden (T1213.002).

Kostenlos loslegen

Bevor Sie beginnen

Ist Audit aktiviert? Es ist standardmäßig für die meisten Tenants aktiviert, aber überprüfen Sie:

Connect-ExchangeOnline

Get-AdminAuditLogConfig | Format-List UnifiedAuditLogIngestionEnabled

True ist das, was Sie wollen. Wenn es False ist, wurde nichts aufgezeichnet, und das Einschalten wird keinen Rückgang füllen.

Rollen. Sie benötigen die Rolle Audit Logs oder View-Only Audit Logs. Sie benötigen auch das ExchangeOnlineManagement-Modul (Install-Module ExchangeOnlineManagement).

Latenz. Ereignisse erscheinen nicht sofort. Die meisten erscheinen innerhalb einer oder zwei Stunden, einige dauern länger. Wenn Sie etwas von heute früh verfolgen, ist es möglicherweise noch nicht durchsuchbar.

Exportieren mit PowerShell

Search-UnifiedAuditLog gibt maximal 5.000 Einträge pro Aufruf zurück. Mit einer Sitzungs-ID und ReturnLargeSet können Sie bis zu 50.000 pro Suche durchsuchen. Diese Schleife tut dies und schreibt die AuditData jedes Eintrags, bereits JSON, als eine Zeile:

$session = [guid]::NewGuid().ToString()

$out = "ual_2026-10-19.jsonl"

do {

    $batch = Search-UnifiedAuditLog -StartDate "2026-10-19 00:00" -EndDate "2026-10-20 00:00" `

             -SessionId $session -SessionCommand ReturnLargeSet -ResultSize 5000

    $batch | ForEach-Object { $_.AuditData } | Add-Content $out

} while ($batch.Count -eq 5000)

Das Protokoll speichert Zeiten in UTC. Beachten Sie das, wenn Sie das Zeitfenster festlegen.

Was man suchen sollte

OperationWarum es wichtig ist
New-InboxRule, Set-InboxRule, UpdateInboxRulesRegeln, die Mails weiterleiten, verschieben oder löschen; überprüfen Sie die Parameter in AuditData
Set-Mailbox mit ForwardingSmtpAddressWeiterleiten auf Postfachebene an eine externe Adresse
Add-MailboxPermission, Add-RecipientPermissionJemand erhält Zugriff auf ein anderes Postfach
MailItemsAccessedWelche Nachrichten tatsächlich gelesen wurden; entscheidend für die Abgrenzung eines Vorfalls
FileDownloaded, FileSyncDownloadedFull-BurstsMassendownload von SharePoint oder OneDrive
Zustimmung zu einer AnwendungEine bösartige App erhält Zugriff auf Mails oder Dateien

Die klassische BEC-Sequenz: ein Anmeldeversuch von einem neuen Ort, dann innerhalb von Minuten eine Posteingangsregel, die Antworten vom Finanzteam in einen obskuren Ordner verschiebt.

Hochladen, reinigen und in LogTotal überprüfen

  • Hochladen. Öffnen logtotal.com und die .jsonl-Datei einfügen.
  • Reinigen. 
  • Überprüfen.

Wenn es schiefgeht

SymptomWahrscheinliche UrsacheFix
Search-UnifiedAuditLog wird nicht erkanntNicht mit Exchange Online PowerShell verbundenZuerst Connect-ExchangeOnline
Keine ErgebnisseAudit deaktiviert, Ereignisse zu neu oder außerhalb der AufbewahrungsfristÜberprüfen Sie die Aufnahme; warten; überprüfen Sie Ihre Audit-Stufe
Genau 5.000 ErgebnissePro-Aufruf-Limit ohne Sitzung erreichtVerwenden Sie die oben genannte Sitzungs-Schleife
Bei 50.000 festgefahrenSitzungsgrenzeTeilen Sie das Fenster in kleinere Abschnitte
Zugriff verweigertFehlende Audit-RolleBitten Sie um View-Only Audit Logs

FAQ

Ist das nicht dasselbe wie Entra-Anmeldeprotokolle?

Sie überschneiden sich: der UAL hat UserLoggedIn-Ereignisse. Aber für Authentifizierungsdetails (MFA, Conditional Access, Risiko) sind Entra-Anmeldeprotokolle deutlich umfangreicher. Exportieren Sie beide.

Was ist mit der Management Activity API?

Das ist der Weg für die kontinuierliche Sammlung in ein SIEM. Für eine einmalige Untersuchung ist PowerShell einfacher.

Treten Sie der Detection as Code-Plattform von SOC Prime bei um die Sichtbarkeit der für Ihr Unternehmen relevantesten Bedrohungen zu verbessern. Um Ihnen den Einstieg zu erleichtern und unmittelbaren Mehrwert zu erzielen, buchen Sie jetzt ein Treffen mit den Experten von SOC Prime.