This commit is contained in:
Madzone
2026-10-09 14:50:28 +02:00
parent afbad0cb50
commit 2500b1f354
16 changed files with 1859 additions and 0 deletions
@@ -0,0 +1,2 @@
reports/
*.local.json
@@ -0,0 +1,22 @@
# Zuordnung verbindlicher Anforderungen – Entwurf
Nur in einer zugelassenen Umgebung mit freigegebenen Angaben ergänzen.
Für jede Sicherheitsdomäne einen eigenen geprüften Vorlagenstand führen.
NATO-/EU-Zuordnungen sind offen und werden nicht aus SCG-/STIG-Werten abgeleitet.
| Bereich | Umsetzung im Paket | Verbindliche Vorgabe / Stand | Nachweis / Ausnahme |
|---|---|---|---|
| Kontosperre und Entsperrzeit | AccountLockFailures=5, AccountUnlockTime=900 | Offen | JSON-Bericht |
| Passworthistorie | PasswordHistory=5 | Offen | JSON-Bericht |
| Passwortqualität | PasswordQualityControl laut baseline.json | Offen | JSON-Bericht; lokale Konten |
| SSH und ESXi Shell | Startmodus off, beendet | Offen | JSON-Bericht; Wartungsprozess ergänzen |
| Rollen, MFA, Notfallzugriff, Lockdown | Nicht automatisiert | Offen | Separater Prüfpunkt |
| Netz-/Sicherheitsdomänentrennung | Nicht automatisiert | Offen | Architekturprüfung |
| Zeitquelle, Remote-Logs, Aufbewahrung | Nicht automatisiert | Offen | Funktions-/Transportprüfung |
| Secure Boot, TPM, Verschlüsselung | Nicht automatisiert | Offen | Plattformprüfung |
| Zertifikate, Patch-/Buildstand | Build wird protokolliert | Offen | Separater Prüfpunkt |
| vCenter, VMs, vSAN, Backups | Nicht automatisiert | Offen | Separate Baselines |
Freigabeverantwortliche Stelle: offen
Freigegebener Vorlagenstand und Geltungsbereich: offen
Ausnahmen, Begründung, Ablaufdatum: offen
@@ -0,0 +1,108 @@
#Requires -Version 7.0
[CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'High')]
param(
[Parameter(Mandatory)][string]$VCenter,
[Parameter(Mandatory)][string[]]$VMHostName,
[string]$BaselinePath = (Join-Path $PSScriptRoot 'baseline.json'),
[ValidateSet('Audit', 'Apply')][string]$Mode = 'Audit',
[string]$ReportDirectory = (Join-Path $PSScriptRoot 'reports')
)
Set-StrictMode -Version Latest
$ErrorActionPreference = 'Stop'
$config = Get-Content -LiteralPath $BaselinePath -Raw | ConvertFrom-Json
if ($config.TargetVersion -ne '8.0.3') { throw 'Diese Version des Werkzeugs unterstützt ESXi 8.0.3.' }
if (@($config.AdvancedSettings).Count + @($config.Services).Count -eq 0) { throw 'Leere Baseline.' }
foreach ($entry in $config.AdvancedSettings) {
if ([string]::IsNullOrWhiteSpace($entry.Name) -or $null -eq $entry.Value) { throw 'Ungültiger Einstellungswert.' }
}
foreach ($entry in $config.Services) {
if ($entry.Policy -notin @('on', 'off', 'automatic') -or $entry.Running -isnot [bool]) { throw 'Ungültige Dienstkonfiguration.' }
}
foreach ($name in $VMHostName) {
if ([string]::IsNullOrWhiteSpace($name) -or $name -match '[*?\[\]]') { throw 'Nur explizite Hostnamen, keine Suchmuster angeben.' }
}
Import-Module VMware.VimAutomation.Core -ErrorAction Stop
# Existing authenticated session only; no embedded credentials or certificate bypass.
$sessions = @(foreach ($variableName in @('DefaultVIServers', 'DefaultVIServer')) {
$variable = Get-Variable -Name $variableName -Scope Global -ErrorAction SilentlyContinue
if ($null -ne $variable) { $variable.Value }
})
$servers = @($sessions | Where-Object { $_.Name -eq $VCenter -and $_.IsConnected } | Sort-Object -Property Name -Unique)
if ($servers.Count -ne 1) { throw 'Zuerst mit Connect-VIServer genau eine Sitzung zum angegebenen vCenter herstellen.' }
$server = $servers[0]
if ([version]$server.Version -lt [version]'8.0' -or [version]$server.Version -ge [version]'9.0') { throw 'vCenter 8 erforderlich.' }
# Resolve and validate every target before making any change.
$targets = @(foreach ($name in ($VMHostName | Select-Object -Unique)) {
$found = @(Get-VMHost -Server $server -Name $name | Where-Object { $_.Name -eq $name })
if ($found.Count -ne 1) { throw "Host nicht eindeutig gefunden: $name" }
if ($found[0].Version -ne $config.TargetVersion) { throw "Nicht unterstützte ESXi-Version auf $name" }
if ([string]$found[0].ConnectionState -notin @('Connected', 'Maintenance')) { throw "Host nicht erreichbar: $name" }
$found[0]
})
$runId = '{0}-{1}' -f (Get-Date -Format 'yyyyMMdd-HHmmss'), ([guid]::NewGuid().ToString('N').Substring(0,8))
# Reports are intentionally also written in Audit and -WhatIf modes.
$null = [IO.Directory]::CreateDirectory($ReportDirectory)
$reportPath = Join-Path $ReportDirectory "$runId.json"
$rows = [Collections.Generic.List[object]]::new()
$report = [ordered]@{
StartedUtc = [DateTime]::UtcNow.ToString('o'); VCenter = $VCenter; Mode = $Mode
Baseline = $config; BaselineSha256 = (Get-FileHash -LiteralPath $BaselinePath -Algorithm SHA256).Hash
Results = $rows
}
function Save-Report { $report | ConvertTo-Json -Depth 15 | Set-Content -LiteralPath $reportPath -Encoding utf8 -WhatIf:$false }
Save-Report
foreach ($target in $targets) {
$controls = @(
foreach ($entry in $config.AdvancedSettings) { [pscustomobject]@{ Kind = 'Advanced'; Entry = $entry } }
foreach ($entry in $config.Services) { [pscustomobject]@{ Kind = 'Service'; Entry = $entry } }
)
foreach ($control in $controls) {
$entry = $control.Entry
$key = if ($control.Kind -eq 'Advanced') { $entry.Name } else { $entry.Key }
$desired = if ($control.Kind -eq 'Advanced') { [string]$entry.Value } else { "$($entry.Policy)/$($entry.Running)" }
$row = [pscustomobject]@{
Host = $target.Name; Build = $target.Build; Kind = $control.Kind; Setting = $key
Control = $entry.Control; Before = $null; Desired = $desired; After = $null
Status = 'Pending'; Error = $null
}
$rows.Add($row)
try {
if ($control.Kind -eq 'Advanced') {
$items = @(Get-AdvancedSetting -Entity $target -Name $key | Where-Object Name -EQ $key)
if ($items.Count -ne 1) { throw 'Einstellung fehlt oder ist nicht eindeutig; wird nicht neu angelegt.' }
$item = $items[0]
$row.Before = [string]$item.Value
} else {
$items = @(Get-VMHostService -VMHost $target | Where-Object Key -EQ $key)
if ($items.Count -ne 1) { throw 'Dienst fehlt oder ist nicht eindeutig.' }
$item = $items[0]
$row.Before = "$($item.Policy)/$($item.Running)"
}
$row.After = $row.Before
$row.Status = if ($row.Before -ceq $desired) { 'Match' } else { 'Drift' }
if ($row.Status -eq 'Drift' -and $Mode -eq 'Apply') {
if ($PSCmdlet.ShouldProcess("$($target.Name): $key", "$($row.Before) -> $desired")) {
$row.Status = 'Applying'
Save-Report # Persist original value before any remote mutation.
if ($control.Kind -eq 'Advanced') {
$null = Set-AdvancedSetting -AdvancedSetting $item -Value $entry.Value -Confirm:$false
$row.After = [string](Get-AdvancedSetting -Entity $target -Name $key).Value
} else {
if ($item.Policy -ne $entry.Policy) { $null = Set-VMHostService -HostService $item -Policy $entry.Policy -Confirm:$false }
if ($item.Running -ne $entry.Running) {
if ($entry.Running) { $null = Start-VMHostService -HostService $item -Confirm:$false }
else { $null = Stop-VMHostService -HostService $item -Confirm:$false }
}
$fresh = Get-VMHostService -VMHost $target | Where-Object Key -EQ $key
$row.After = "$($fresh.Policy)/$($fresh.Running)"
}
$row.Status = if ($row.After -ceq $desired) { 'AppliedVerified' } else { 'VerificationFailed' }
} else { $row.Status = 'Skipped' }
}
} catch { $row.Status = 'Error'; $row.Error = $_.Exception.Message; $row.After = $null }
Save-Report
}
}
$rows | Format-Table Host, Setting, Before, Desired, After, Status -AutoSize | Out-Host
Write-Host "Bericht: $reportPath"
if (@($rows | Where-Object Status -In @('Error','VerificationFailed')).Count) { throw 'Prüfung/Anwendung unvollständig. Bericht beachten; Teiländerungen sind möglich.' }
+111
View File
@@ -0,0 +1,111 @@
# Wiederverwendbare ESXi-Sicherheitsvorlage
Entwurf für ESXi **8.0.3** und vCenter **8**. Enthält sechs automatisierte
Kontrollen als erweiterbare Startbasis, keine vollständige VMware-Härtung und
keine NATO-/EU-Freigabe. Die vier Advanced Settings stammen aus dem öffentlichen
VMware Security Configuration Guide für 8.0.3; SSH und ESXi Shell werden als
lokale Entwurfsentscheidung deaktiviert. Diese Werte sind keine behaupteten
NATO-/EU-Vorgaben. Es werden keine vCenter-Einstellungen geändert.
## Verwendung
PowerShell 7 und das Modul VMware.VimAutomation.Core werden vorausgesetzt.
In einer zugelassenen Administrationsumgebung ausführen. Zugangsdaten bleiben
in der interaktiven PowerCLI-Anmeldung; Zertifikatsprüfung nicht deaktivieren.
1. `baseline.json` pro freigegebenem Einsatzzweck kopieren und versionieren.
Anforderungen und Ausnahmen in `Anforderungsmatrix.md` ergänzen.
2. Mit vCenter verbinden und zunächst einen expliziten Testhost prüfen.
3. Änderungen simulieren, dann auf dem Testhost anwenden und erneut prüfen.
4. Erst danach denselben Vorlagenstand auf weitere passende Hosts anwenden.
```powershell
Connect-VIServer -Server 'vcenter.example.internal'
# Standard: ausschließlich prüfen
./Invoke-EsxiBaseline.ps1 -VCenter 'vcenter.example.internal' `
-VMHostName 'esxi01.example.internal'
# Änderungen anzeigen, ohne sie auf dem Host auszuführen
./Invoke-EsxiBaseline.ps1 -VCenter 'vcenter.example.internal' `
-VMHostName 'esxi01.example.internal' -Mode Apply -WhatIf
# Anwenden: PowerShell fragt pro abweichender Einstellung nach
./Invoke-EsxiBaseline.ps1 -VCenter 'vcenter.example.internal' `
-VMHostName 'esxi01.example.internal' -Mode Apply
# Eigene, bereits geprüfte Vorlage und mehrere explizite Hosts
./Invoke-EsxiBaseline.ps1 -VCenter 'vcenter.example.internal' `
-VMHostName 'esxi01.example.internal','esxi02.example.internal' `
-BaselinePath './standort-baseline.json'
```
`-Confirm:$false` ermöglicht später einen bewusst unbeaufsichtigten Apply-Lauf.
Die Standardaktion bleibt Audit. Audit und WhatIf schreiben lokale Berichte.
Berichte unter `reports/` enthalten Baseline, Hash, Build, Vorher-/Nachherwerte
und Einzelstatus. `Match` bedeutet nur Übereinstimmung mit dieser Vorlage,
keine Gesamt-Konformität. `Drift` ist eine Abweichung, `Skipped` wurde nicht
angewendet. Fehler und fehlgeschlagene Nachprüfungen führen am Ende zu einem
terminierenden Fehler. Abweichungen im Audit sind normale Berichtsergebnisse.
Bei Fehlern können Teiländerungen vorliegen; es gibt keinen automatischen Rollback.
Vorherwerte werden vor jeder Änderung gespeichert. Eine Rücknahme erfolgt
gezielt mit diesen Werten und anschließender erneuter Prüfung.
Passwortregeln können Integrationen beeinträchtigen; Kontosperren können auch
berechtigte Zugriffe blockieren. SSH-/Shell-Abschaltung beeinflusst Wartungswege.
Vor Apply einen funktionierenden administrativen Wiederherstellungsweg prüfen.
Berichte und standortspezifische Vorlagen nur in der dafür zugelassenen Umgebung
speichern; nicht in öffentliche Repositories übernehmen.
## Daraus ein natives Hostprofil erstellen
Nach erfolgreicher Einrichtung und Prüfung des ersten Hosts kann vCenter das
native Profil extrahieren. Host-Profile-Funktion und Lizenzberechtigung müssen
vorhanden sein. Beispiel in derselben PowerCLI-Sitzung:
```powershell
$vc = $global:DefaultVIServers | Where-Object Name -EQ 'vcenter.example.internal'
$reference = Get-VMHost -Server $vc -Name 'esxi01.example.internal'
New-VMHostProfile -Server $vc -Name 'ESXi803-Freigegebene-Basis-v1' `
-ReferenceHost $reference
```
Das extrahierte Profil umfasst auch andere Einstellungen des Referenzhosts.
Vor Zuordnung zu weiteren Hosts im vSphere Client den Profilumfang bearbeiten,
hostabhängige Netzwerk-/Storage-Werte prüfen und Hostanpassungen festlegen.
Dieses Paket verteilt oder remediert native Hostprofile nicht automatisch.
## Offene Bereiche
Netztrennung, Lockdown und Notfallzugang, Rollen/MFA, NTP, zentrale Protokollierung
mit geschütztem Transport, Zertifikate, Secure Boot/TPM, Patchstand, VM-/vSAN-
Härtung, Sicherung/Wiederherstellung und vCenter-Härtung müssen separat bewertet
werden. Insbesondere ist die Versionsnummer 8.0.3 kein Nachweis eines aktuellen
Patchstands. Anforderungen für NATO und EU sowie unterschiedliche Einstufungen
lokal zuordnen; keine erfundenen SECRET-/RESTRICTED-Parameter verwenden.
## Quellen
Abgeglichen am 05.10.2026; die Online-Baseline kann sich ändern.
- [Offizieller VMware SCG 8 mit Kontrollen und PowerCLI-Beispielen](https://github.com/vmware/vcf-security-and-compliance-guidelines/tree/main/security-configuration-hardening-guide/vsphere/8.0)
- [New-VMHostProfile](https://developer.broadcom.com/powercli/latest/vmware.vimautomation.core/commands/new-vmhostprofile/)
- [Set-VMHostService](https://developer.broadcom.com/powercli/latest/vmware.vimautomation.core/commands/set-vmhostservice)
## Prüfung dieses Pakets
PowerShell-Syntax und simulierte Audit-/Apply-/WhatIf-/Fehlerpfade lokal prüfen.
Ein Integrationstest gegen echtes vCenter/ESXi ist vor produktivem Einsatz nötig.
Offline-Test in einem separaten PowerShell-Prozess starten (verwendet simulierte
PowerCLI-Befehle und schreibt Testberichte ins temporäre Verzeichnis):
```powershell
pwsh -NoProfile -File ./Tests/Test-Offline.ps1
```
Geprüft: Audit ohne Änderungen, WhatIf ohne Änderungen, Apply mit Nachprüfung,
wiederholtes Apply ohne erneute Änderungen, Ablehnung falscher ESXi-Versionen
und Fehlerbericht bei fehlenden Einstellungen. Diese Tests ersetzen keinen
Integrationstest auf einem ESXi-Testhost.
@@ -0,0 +1,62 @@
# Offline behavioral tests; no VMware module, credentials or remote connection.
$ErrorActionPreference = 'Stop'
$scriptPath = Join-Path $PSScriptRoot '../Invoke-EsxiBaseline.ps1'
$baselinePath = Join-Path $PSScriptRoot '../baseline.json'
$testRoot = Join-Path ([IO.Path]::GetTempPath()) ('esxi-baseline-test-' + [guid]::NewGuid())
function Import-Module { param($Name, $ErrorAction) }
$global:DefaultVIServers = @([pscustomobject]@{Name='test-vc'; IsConnected=$true; Version='8.0.3'})
$global:DefaultVIServer = $global:DefaultVIServers[0]
function Get-VMHost { param($Server,$Name)
[pscustomobject]@{Name=$Name; Version=$global:baselineTestVersion; Build='mock'; ConnectionState='Connected'}
}
function Get-AdvancedSetting { param($Entity,$Name)
if ($global:baselineTestMissing -eq $Name) { return }
[pscustomobject]@{Name=$Name;Value=$global:baselineTestValues[$Name]}
}
function Set-AdvancedSetting { param($AdvancedSetting,$Value,[switch]$Confirm)
$global:baselineTestWrites++; $global:baselineTestValues[$AdvancedSetting.Name]=$Value
}
function Get-VMHostService { param($VMHost) $global:baselineTestServices }
function Set-VMHostService { param($HostService,$Policy,[switch]$Confirm) $global:baselineTestWrites++; $HostService.Policy=$Policy }
function Stop-VMHostService { param($HostService,[switch]$Confirm) $global:baselineTestWrites++; $HostService.Running=$false }
function Start-VMHostService { param($HostService,[switch]$Confirm) $global:baselineTestWrites++; $HostService.Running=$true }
function Reset-State {
$global:baselineTestWrites=0; $global:baselineTestVersion='8.0.3'; $global:baselineTestMissing=''
$global:baselineTestValues=@{}
(Get-Content $baselinePath -Raw | ConvertFrom-Json).AdvancedSettings | ForEach-Object { $global:baselineTestValues[$_.Name]='different' }
$global:baselineTestServices=@('TSM','TSM-SSH') | ForEach-Object { [pscustomobject]@{Key=$_; Policy='on'; Running=$true} }
}
function Assert($condition,$message) { if (-not $condition) { throw $message } }
function Run-Case($name,$mode,[switch]$Simulation) {
$parameters=@{VCenter='test-vc';VMHostName=@('test-esxi');Mode=$mode;ReportDirectory=(Join-Path $testRoot $name);Confirm=$false}
if ($Simulation) { $parameters.WhatIf=$true }
& $scriptPath @parameters
Get-Content (Get-ChildItem $parameters.ReportDirectory -Filter '*.json')[0].FullName -Raw | ConvertFrom-Json
}
Reset-State
$r=Run-Case 'audit' 'Audit'
Assert ($global:baselineTestWrites -eq 0) 'Audit mutated host'
Assert (@($r.Results | Where-Object Status -EQ Drift).Count -eq 6) 'Audit missed drift'
$r=Run-Case 'whatif' 'Apply' -Simulation
Assert ($global:baselineTestWrites -eq 0) 'WhatIf mutated host'
Assert (@($r.Results | Where-Object Status -EQ Skipped).Count -eq 6) 'WhatIf results incorrect'
$r=Run-Case 'apply' 'Apply'
Assert ($global:baselineTestWrites -eq 8) 'Unexpected mutation count'
Assert (@($r.Results | Where-Object Status -EQ AppliedVerified).Count -eq 6) 'Apply not verified'
$previousWrites=$global:baselineTestWrites
$r=Run-Case 'repeat' 'Apply'
Assert ($global:baselineTestWrites -eq $previousWrites) 'Repeated apply not idempotent'
Assert (@($r.Results | Where-Object Status -EQ Match).Count -eq 6) 'Repeat did not match'
Reset-State
$global:baselineTestVersion='7.0.3'
$failed=$false
try { $null=Run-Case 'version' 'Apply' } catch { $failed=$true }
Assert ($failed -and $global:baselineTestWrites -eq 0) 'Version gate failed'
Reset-State
$global:baselineTestMissing='Security.PasswordHistory'
$failed=$false
try { $null=Run-Case 'missing' 'Audit' } catch { $failed=$true }
Assert ($failed -and $global:baselineTestWrites -eq 0) 'Missing setting did not fail safely'
$r=Get-Content (Get-ChildItem (Join-Path $testRoot 'missing') -Filter '*.json')[0].FullName -Raw | ConvertFrom-Json
Assert (@($r.Results | Where-Object Status -EQ Error).Count -eq 1) 'Missing setting not reported'
Write-Host 'PASS: Audit, WhatIf, Apply, repeat, version gate, missing-setting report.'
@@ -0,0 +1,17 @@
{
"Name": "ESXi-8.0.3-Startbaseline",
"Revision": "0.1-draft",
"TargetVersion": "8.0.3",
"ClassificationMapping": "Offen: freigegebene NATO-/EU-Vorgaben lokal zuordnen",
"Source": "https://github.com/vmware/vcf-security-and-compliance-guidelines/tree/main/security-configuration-hardening-guide/vsphere/8.0",
"AdvancedSettings": [
{ "Name": "Security.AccountUnlockTime", "Value": 900, "Control": "esxi-8.account-auto-unlock-time" },
{ "Name": "Security.AccountLockFailures", "Value": 5, "Control": "esxi-8.account-lockout" },
{ "Name": "Security.PasswordHistory", "Value": 5, "Control": "esxi-8.account-password-history" },
{ "Name": "Security.PasswordQualityControl", "Value": "similar=deny retry=3 min=disabled,disabled,disabled,disabled,15 max=64", "Control": "esxi-8.account-password-policies" }
],
"Services": [
{ "Key": "TSM-SSH", "Policy": "off", "Running": false, "Control": "LOCAL-disable-ssh" },
{ "Key": "TSM", "Policy": "off", "Running": false, "Control": "LOCAL-disable-shell" }
]
}