Graph PowerShell ile Entra Denetim Günlükleri: Rol Atamaları, Grup Değişiklikleri ve Kimin Ne Yaptığı
Bir yönetici rolü kime, ne zaman ve kim tarafından verildi? Silinen kullanıcıyı kim sildi? Entra denetim günlüklerini Graph PowerShell ile sorgulayıp düzenli rapora dönüştürmeyi anlatıyoruz.

Entra ID’de bir şey ters gittiğinde ilk soru hep aynıdır: “Bunu kim yaptı?” Bir kullanıcıya Genel Yönetici rolü verilmiş, bir uygulamaya yeni gizli anahtar eklenmiş ya da bir grup silinmiş olabilir. Bu tür değişikliklerin izi dizin denetim günlüklerinde (directory audit logs) tutulur. Portal üzerinden tek tek bakmak mümkündür ama düzenli inceleme ve olay araştırması için Microsoft Graph PowerShell çok daha verimlidir.
Denetim günlüğü ile oturum açma günlüğü farkı
Bu iki kavram sık karıştırılır:
- Oturum açma günlükleri kimin, nereden, hangi uygulamaya giriş yaptığını kaydeder.
- Denetim günlükleri dizinde yapılan değişiklikleri kaydeder: kullanıcı oluşturma, rol atama, grup üyeliği, uygulama izni, parola sıfırlama gibi.
Denetim günlükleri Entra ID’nin ücretsiz katmanında da tutulur; ancak saklama süresi lisansa göre değişir (ücretsiz katmanda kısa, P1/P2 ile genellikle 30 gün). Daha uzun saklama için günlükleri Log Analytics’e veya bir depolama hesabına aktarmanız gerekir.
Bağlantı
Install-Module Microsoft.Graph.Authentication, Microsoft.Graph.Reports -Scope CurrentUser
Connect-MgGraph -Scopes "AuditLog.Read.All" -NoWelcome
İlk sorgu
Get-MgAuditLogDirectoryAudit cmdlet’i denetim kayıtlarını getirir. Her zaman tarih filtresiyle başlayın:
$baslangic = (Get-Date).AddDays(-7).ToUniversalTime().ToString("yyyy-MM-ddTHH:mm:ssZ")
$kayitlar = Get-MgAuditLogDirectoryAudit -All -Filter "activityDateTime ge $baslangic"
$kayitlar.Count
$kayitlar | Group-Object ActivityDisplayName | Sort-Object Count -Descending |
Select-Object -First 20 Count, Name
İkinci komut, son bir haftada en sık hangi işlemlerin yapıldığını gösterir. Bu liste aynı zamanda filtrelerde kullanacağınız activityDisplayName değerlerinin doğru yazımını öğrenmenin en kolay yoludur.
Kayıt yapısını anlamak
Her denetim kaydında şu alanlar öne çıkar:
| Alan | Açıklama |
|---|---|
ActivityDateTime |
İşlemin zamanı (UTC) |
ActivityDisplayName |
İşlemin adı, ör. “Add member to role” |
Category |
UserManagement, GroupManagement, RoleManagement, ApplicationManagement vb. |
InitiatedBy |
İşlemi yapan kullanıcı veya uygulama |
TargetResources |
Etkilenen nesne(ler) ve değişen özellikler |
Result |
success / failure |
LoggedByService |
Kaydı oluşturan hizmet (Core Directory, Self-service Password Management vb.) |
InitiatedBy ve TargetResources iç içe nesnelerdir. Okunabilir hale getirmek için küçük bir dönüştürme fonksiyonu yazalım:
function ConvertTo-DenetimSatiri {
param([Parameter(ValueFromPipeline)]$Kayit)
process {
$yapan = if ($Kayit.InitiatedBy.User.UserPrincipalName) {
$Kayit.InitiatedBy.User.UserPrincipalName
} else {
"Uygulama: " + $Kayit.InitiatedBy.App.DisplayName
}
[pscustomobject]@{
Zaman = $Kayit.ActivityDateTime.ToLocalTime()
Islem = $Kayit.ActivityDisplayName
Kategori = $Kayit.Category
Yapan = $yapan
Hedef = ($Kayit.TargetResources | ForEach-Object {
$_.UserPrincipalName ?? $_.DisplayName }) -join '; '
Sonuc = $Kayit.Result
}
}
}
$kayitlar | ConvertTo-DenetimSatiri | Export-Csv .\denetim.csv -NoTypeInformation -Encoding utf8
Fonksiyondaki ?? operatörü PowerShell 7 gerektirir; Windows PowerShell 5.1’de aynı mantığı if/else ile kurabilirsiniz.
Senaryo 1: Yönetici rolü atamaları
Ayrıcalıklı rollere yapılan eklemeler, haftalık olarak gözden geçirilmesi gereken en kritik olaylardır:
$rolKayitlari = Get-MgAuditLogDirectoryAudit -All `
-Filter "activityDateTime ge $baslangic and category eq 'RoleManagement'"
$rolKayitlari | Where-Object ActivityDisplayName -like "*member to role*" | ForEach-Object {
$rol = ($_.TargetResources.ModifiedProperties |
Where-Object DisplayName -eq 'Role.DisplayName').NewValue
[pscustomobject]@{
Zaman = $_.ActivityDateTime.ToLocalTime()
Islem = $_.ActivityDisplayName
Yapan = $_.InitiatedBy.User.UserPrincipalName
Hedef = ($_.TargetResources | Where-Object Type -eq 'User').UserPrincipalName
Rol = $rol -replace '"',''
}
}
ModifiedProperties içindeki alan adları işleme göre değişir. Yeni bir senaryo için önce tek bir kaydı açıp yapısına bakın:
$rolKayitlari[0].TargetResources.ModifiedProperties | Format-List DisplayName, OldValue, NewValue
Privileged Identity Management (PIM) kullanıyorsanız rol etkinleştirmeleri farklı işlem adlarıyla ve farklı bir hizmet (
LoggedByService) altında kaydedilir. Raporunuzu PIM işlemlerini de kapsayacak şekilde genişletmeyi unutmayın.
Senaryo 2: Silinen kullanıcıyı kim sildi?
$silme = Get-MgAuditLogDirectoryAudit -All `
-Filter "activityDateTime ge $baslangic and activityDisplayName eq 'Delete user'"
$silme | ConvertTo-DenetimSatiri | Format-Table -AutoSize
Silinen kullanıcılar 30 gün boyunca geri dönüşüm kutusunda tutulur. Yanlışlıkla silindiyse Get-MgDirectoryDeletedItemAsUser ile bulup Restore-MgDirectoryDeletedItem ile geri getirebilirsiniz.
Senaryo 3: Uygulamalara eklenen kimlik bilgileri
Saldırganların kalıcılık kazanmak için sık kullandığı yöntemlerden biri, mevcut bir uygulama kaydına yeni bir gizli anahtar veya sertifika eklemektir. Bu işlemleri izlemek için:
$uygulama = Get-MgAuditLogDirectoryAudit -All `
-Filter "activityDateTime ge $baslangic and category eq 'ApplicationManagement'"
$uygulama | Where-Object { $_.ActivityDisplayName -match 'certificates and secrets|Consent' } |
ConvertTo-DenetimSatiri | Format-Table -AutoSize
Burada “Update application – Certificates and secrets management” ve onay (consent) işlemleri öne çıkar. Beklenmeyen bir onay kaydı, oltalama yoluyla kötü amaçlı bir uygulamaya izin verildiğinin işareti olabilir.
Senaryo 4: Başarısız işlemler
Yetkisi olmayan birinin değişiklik yapmaya çalışması da önemli bir sinyaldir:
$kayitlar | Where-Object Result -eq 'failure' | ConvertTo-DenetimSatiri |
Group-Object Yapan | Sort-Object Count -Descending | Select-Object Count, Name
Senaryo 5: Belirli bir yöneticinin yaptığı her şey
Bir yönetici hesabının ele geçirildiğinden şüpheleniyorsanız, o hesabın son günlerde yaptığı tüm değişiklikleri tek listede görmek istersiniz. initiatedBy alanı filtrelenebilir:
$upn = "it.admin@contoso.com"
Get-MgAuditLogDirectoryAudit -All `
-Filter "activityDateTime ge $baslangic and initiatedBy/user/userPrincipalName eq '$upn'" |
ConvertTo-DenetimSatiri | Sort-Object Zaman | Format-Table -AutoSize
Bu listeyi oturum açma günlükleriyle (aynı hesabın IP ve konum bilgisi) yan yana koyduğunuzda, değişikliklerin gerçekten o kişi tarafından mı yoksa beklenmedik bir konumdan mı yapıldığını hızla ayırt edebilirsiniz. Şüphe doğrulanırsa hesabın oturumlarını Revoke-MgUserSignInSession ile sonlandırmak ilk müdahale adımlarından biridir.
Performans ipuçları
- Filtreyi mümkün olduğunca sunucu tarafında (
-Filter) yapın;category,activityDisplayName,activityDateTimeveinitiatedBy/user/userPrincipalNamefiltrelenebilir alanlardır. -Allparametresi tüm sayfaları dolaşır. Çok geniş tarih aralıklarında önce-Top 50ile deneme yapın.- Haftalık rapor için her seferinde son 7 günü sorgulayıp sonucu tarih damgalı bir CSV’ye yazmak, saklama süresini dolaylı olarak uzatır.
Sık yapılan hatalar
- Filtrede tarih tırnaklamak:
activityDateTime ge 2026-11-01T00:00:00Ztırnaksız yazılır; metin alanları ise tek tırnak ister. - Yerel saatle yorumlamak: Kayıtlar UTC’dir. Raporda
ToLocalTime()kullanmak yanlış alarm riskini azaltır. - Saklama süresini unutmak: 30 günden eski bir olayı araştırıyorsanız günlükler zaten silinmiş olabilir. Uzun vadeli saklama için tanılama ayarlarıyla Log Analytics’e aktarım yapın.
Sonuç
Entra denetim günlükleri, kiracınızdaki her yapılandırma değişikliğinin kara kutusudur. Graph PowerShell ile rol atamalarını, silme işlemlerini ve uygulama kimlik bilgisi değişikliklerini birkaç satırla raporlayabilir, bunu haftalık bir otomasyona dönüştürebilirsiniz. Olay anında panikle portalda gezinmek yerine, hazır bir betikle dakikalar içinde “kim, ne zaman, ne yaptı” sorusuna cevap vermek büyük fark yaratır.


