info@teknoedu.com
PowerShell

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.

Graph PowerShell ile Entra Denetim Günlükleri: Rol Atamaları, Grup Değişiklikleri ve Kimin Ne Yaptığı

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, activityDateTime ve initiatedBy/user/userPrincipalName filtrelenebilir alanlardır.
  • -All parametresi tüm sayfaları dolaşır. Çok geniş tarih aralıklarında önce -Top 50 ile 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:00Z tı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.