Get-EntraAppSecretExpiry.ps1

<#PSScriptInfo
.VERSION 1.0.0
.GUID 88228e96-61db-53fb-8160-c2f1a9bef7d4
.AUTHOR Torsten Weise
.COMPANYNAME powerscripting.de
.COPYRIGHT (c) 2026 Torsten Weise. MIT-Lizenz.
.TAGS Powerscripting German Microsoft365 M365 EntraID AzureAD Graph PSEdition_Desktop PSEdition_Core
.LICENSEURI https://powerscripting.de/skripte/files/LICENSE.txt
.PROJECTURI https://powerscripting.de/skripte/get-entraappsecretexpiry.html
.ICONURI https://powerscripting.de/assets/icon-192.png
.EXTERNALMODULEDEPENDENCIES
.REQUIREDSCRIPTS
.EXTERNALSCRIPTDEPENDENCIES
.RELEASENOTES
Erste Veröffentlichung in der PowerShell Gallery.
.PRIVATEDATA
#>


<#
.SYNOPSIS
    Listet ablaufende und abgelaufene Geheimnisse und Zertifikate von App-Registrierungen in Entra ID.
 
.DESCRIPTION
    App-Registrierungen melden sich mit einem geheimen Clientschlüssel oder einem Zertifikat an. Beide laufen
    ab, Schlüssel aus dem Portal nach höchstens zwei Jahren. Danach bricht die Anbindung ohne Vorwarnung ab:
    Scan-to-Mail, Backup von Microsoft 365, das RMM-Tool oder die Synchronisation mit dem Ticketsystem.
 
    Das Skript liest alle App-Registrierungen und bewertet jeden Schlüssel und jedes Zertifikat:
    - Abgelaufen: gilt nicht mehr. Wenn die App noch etwas tun soll, ist sie jetzt schon kaputt.
    - Läuft ab: endet innerhalb von -Days Tagen.
    - Gültig: endet später.
 
    Mit -IncludeEnterpriseApps prüft es zusätzlich die Zertifikate von Unternehmensanwendungen, etwa
    SAML-Signaturzertifikate für Single Sign-on bei Drittanbietern. Die laufen genauso ab und legen dann die
    Anmeldung aller Benutzer an diesem Dienst lahm.
 
    Apps, bei denen ein Schlüssel abgelaufen ist, aber ein anderer noch gilt, werden als "ersetzt" markiert.
    Das ist der Normalfall nach einem sauberen Wechsel. Den alten Schlüssel kannst du dann löschen.
 
    Exitcode: 0 ohne Befund, 1 wenn etwas innerhalb von -Days abläuft, 2 wenn ein Schlüssel abgelaufen ist
    und die App keinen gültigen mehr hat.
 
.PARAMETER Days
    Vorwarnzeit in Tagen. Standard: 30.
 
.PARAMETER IncludeEnterpriseApps
    Auch Zertifikate von Unternehmensanwendungen (Dienstprinzipale) prüfen.
 
.PARAMETER ShowAll
    Auch gültige Einträge ausgeben. Standard: nur abgelaufene und bald ablaufende.
 
.PARAMETER ReportPath
    Ordner für HTML- und CSV-Bericht. Standard: aktueller Ordner.
 
.EXAMPLE
    .\Get-EntraAppSecretExpiry.ps1
 
    Zeigt alle Schlüssel und Zertifikate, die abgelaufen sind oder in den nächsten 30 Tagen ablaufen.
 
.EXAMPLE
    .\Get-EntraAppSecretExpiry.ps1 -Days 60 -IncludeEnterpriseApps
 
    Prüft auch SAML-Zertifikate und warnt zwei Monate vorher.
 
.NOTES
    Autor: Torsten Weise, powerscripting.de
    Benötigt: Install-Module Microsoft.Graph -Scope CurrentUser
    Berechtigung (Zustimmung durch einen Administrator beim ersten Start): Application.Read.All
    Für die Aufgabenplanung eignet sich eine eigene App-Registrierung mit Zertifikat und der
    Anwendungsberechtigung Application.Read.All. Das Skript liest nur und ändert nichts.
#>

#Requires -Modules Microsoft.Graph.Authentication, Microsoft.Graph.Applications
[CmdletBinding()]
param(
    [ValidateRange(1, 730)] [int] $Days = 30,
    [switch] $IncludeEnterpriseApps,
    [switch] $ShowAll,
    [string] $ReportPath = (Get-Location).Path
)

if (-not (Get-MgContext)) {
    Connect-MgGraph -Scopes 'Application.Read.All' -NoWelcome -ErrorAction Stop
}

$now   = Get-Date
$limit = $now.AddDays($Days)

function New-Row($Kind, $Object, $Cred, $Type) {
    $end = $Cred.EndDateTime
    if ($end) { $end = ([datetime]$end).ToLocalTime() }
    $state = if (-not $end) { 'Unbekannt' }
             elseif ($end -lt $now) { 'Abgelaufen' }
             elseif ($end -lt $limit) { 'Läuft ab' }
             else { 'Gültig' }
    [pscustomobject]@{
        Art        = $Kind
        Name       = $Object.DisplayName
        AppId      = $Object.AppId
        Typ        = $Type
        Bezeichnung = $Cred.DisplayName
        KeyId      = $Cred.KeyId
        Ablauf     = if ($end) { $end.ToString('dd.MM.yyyy') } else { '' }
        Tage       = if ($end) { [int][math]::Floor(($end - $now).TotalDays) } else { $null }
        Status     = $state
        Hinweis    = ''
        _Id        = $Object.Id
        _End       = $end
    }
}

$all = [System.Collections.Generic.List[object]]::new()

$apps = @(Get-MgApplication -All -Property Id, AppId, DisplayName, PasswordCredentials, KeyCredentials)
Write-Host "$($apps.Count) App-Registrierungen werden geprüft"
foreach ($a in $apps) {
    foreach ($c in @($a.PasswordCredentials)) { if ($c) { $all.Add((New-Row 'App-Registrierung' $a $c 'Geheimer Schlüssel')) } }
    foreach ($c in @($a.KeyCredentials))      { if ($c) { $all.Add((New-Row 'App-Registrierung' $a $c 'Zertifikat')) } }
}

if ($IncludeEnterpriseApps) {
    # Nur Dienstprinzipale aus dem eigenen Tenant mit Zertifikaten, z. B. SAML-SSO
    $tenantId = (Get-MgContext).TenantId
    $sps = @(Get-MgServicePrincipal -All -Property Id, AppId, DisplayName, AppOwnerOrganizationId, KeyCredentials, PasswordCredentials, PreferredTokenSigningKeyThumbprint |
        Where-Object { $_.KeyCredentials.Count -or $_.PasswordCredentials.Count })
    Write-Host "$($sps.Count) Unternehmensanwendungen mit eigenen Schlüsseln oder Zertifikaten"
    foreach ($s in $sps) {
        $kind = if ($s.AppOwnerOrganizationId -eq $tenantId) { 'Unternehmensanwendung (eigene)' } else { 'Unternehmensanwendung' }
        # Bei SAML stehen Signatur- und Verifizierungsschlüssel doppelt drin, die KeyId unterscheidet sie
        foreach ($c in @($s.KeyCredentials | Where-Object { $_.Usage -eq 'Sign' -or -not $_.Usage })) {
            if ($c) { $all.Add((New-Row $kind $s $c 'Zertifikat (Signatur)')) }
        }
        foreach ($c in @($s.PasswordCredentials)) { if ($c) { $all.Add((New-Row $kind $s $c 'Geheimer Schlüssel')) } }
    }
}

# Pro Objekt prüfen, ob nach einem abgelaufenen Eintrag noch ein gültiger existiert
foreach ($grp in ($all | Group-Object _Id, Typ)) {
    $valid = @($grp.Group | Where-Object { $_.Status -in 'Gültig', 'Läuft ab' })
    foreach ($r in $grp.Group) {
        if ($r.Status -eq 'Abgelaufen' -and $valid) { $r.Hinweis = 'ersetzt, alter Eintrag kann gelöscht werden' }
        elseif ($r.Status -eq 'Abgelaufen')         { $r.Hinweis = 'kein gültiger Eintrag mehr vorhanden' }
        elseif ($r.Status -eq 'Läuft ab' -and @($valid | Where-Object { $_._End -gt $limit }).Count) { $r.Hinweis = 'Nachfolger bereits angelegt' }
    }
}

$order  = @{ 'Abgelaufen' = 0; 'Läuft ab' = 1; 'Unbekannt' = 2; 'Gültig' = 3 }
$result = @($all |
    Where-Object { $ShowAll -or $_.Status -ne 'Gültig' } |
    Sort-Object @{ e = { $order[$_.Status] } }, @{ e = { $_.Hinweis -like 'ersetzt*' } }, Tage, Name |
    Select-Object Art, Name, AppId, Typ, Bezeichnung, KeyId, Ablauf, Tage, Status, Hinweis)
$result

$broken  = @($result | Where-Object { $_.Status -eq 'Abgelaufen' -and $_.Hinweis -like 'kein*' }).Count
$soon    = @($result | Where-Object { $_.Status -eq 'Läuft ab' -and $_.Hinweis -notlike 'Nachfolger*' }).Count
$cleanup = @($result | Where-Object { $_.Hinweis -like 'ersetzt*' }).Count
Write-Host ''
Write-Host "Ohne gültigen Schlüssel: $broken | Läuft in $Days Tagen ab: $soon | Alte Einträge zum Aufräumen: $cleanup"

$title = "Ablauf von App-Schlüsseln und Zertifikaten - $($now.ToString('dd.MM.yyyy'))"
$css   = '<style>body{font-family:Segoe UI,Arial,sans-serif;font-size:13px}table{border-collapse:collapse}td,th{border:1px solid #ccc;padding:4px 8px}th{background:#eee}</style>'
$pre   = "<h2>$title</h2><p>Vorwarnzeit $Days Tage. Ohne gültigen Schlüssel: $broken. Läuft bald ab: $soon. Zum Aufräumen: $cleanup.</p>"
$html  = if ($result.Count) { $result | ConvertTo-Html -Title $title -Head $css -PreContent $pre | Out-String }
         else { ConvertTo-Html -Title $title -Head $css -PreContent "$pre<p>Nichts läuft in diesem Zeitraum ab.</p>" | Out-String }
$html  = $html -replace '<td>Abgelaufen</td>', '<td style="background:#f8d7da">Abgelaufen</td>' `
               -replace '<td>Läuft ab</td>', '<td style="background:#fff3cd">Läuft ab</td>'
$base  = Join-Path $ReportPath ("App-Schluessel_{0:yyyy-MM-dd}" -f $now)
$html | Set-Content -Path "$base.html" -Encoding UTF8
$result | Export-Csv -Path "$base.csv" -NoTypeInformation -Delimiter ';' -Encoding UTF8
Write-Host "Bericht: $base.html und $base.csv"

if ($broken) { exit 2 } elseif ($soon) { exit 1 } else { exit 0 }