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 } |