diff --git a/Stagging/.gitignore b/Stagging/.gitignore new file mode 100644 index 0000000..2246bb2 --- /dev/null +++ b/Stagging/.gitignore @@ -0,0 +1,3 @@ +runs/ +*.iso +*.log diff --git a/Stagging/ANLEITUNG.md b/Stagging/ANLEITUNG.md new file mode 100644 index 0000000..ebfaca0 --- /dev/null +++ b/Stagging/ANLEITUNG.md @@ -0,0 +1,95 @@ +# Unbeaufsichtigte Installation vorbereiten + +## Stand + +`Prepare-Unattended.ps1` liest das KIS-Workbook und bereitet die Antwortdateien vor: + +- Proxmox VE: `answer.toml` +- VMware ESXi: `ks.cfg` + +System und Version kommen aus dem Blatt **Server**. Die Windows-Server-Version und die Mediennamen kommen aus **Staging**. Das Programm installiert selbst noch keine Server und richtet noch keinen DHCP-, PXE- oder Webdienst ein. + +## 1. Excel ausfüllen + +Verwende `outputs/01a07d3f/ConfigWorkbook_KIS.xlsx`. + +Im Blatt **Staging** Windows-Version, GETAC-Netzwerkkarte, IP/Präfix, DHCP-Bereich, Medienordner und die passenden ISO-Dateinamen eintragen. Im Blatt **Server** die vorgesehenen Geräte auf `Installieren = JA` setzen und ihre Angaben vervollständigen. Excel speichern, bevor du das Programm startest. + +Für diesen ersten Installer-Durchlauf gelten: + +- Eine Version und ein Installationsmedium je Plattform. Die Version wird niemals automatisch ersetzt. Für einen anderen Versionssatz einen getrennten Lauf vorbereiten. +- Ziel-IP im gleichen Netz wie das GETAC, außerhalb des DHCP-Bereichs und ungleich der GETAC-IP. +- Gateway und DNS müssen eingetragen sein. Anders als im ursprünglichen isolierten Workbook-Beispiel lässt dieser Generator diese Felder nicht leer. Nur vorhandene Dienste verwenden; DHCP allein macht das GETAC nicht zum Router oder DNS-Server. +- Benutzername `root`. Zusätzliche Benutzer folgen nach der Installation. +- PVE-Datenträger: vorzugsweise `ID_SERIAL=ECHTE_SERIENNUMMER`; alternativ ein bestätigter Installer-Gerätename wie `sda` oder `nvme0n1`. Keine Wildcards, kein `/dev/`-Präfix. ESXi: die bestätigte Kennung mit `naa.`, `eui.`, `t10.` oder `mpx.`. +- Normale PXE-Netzwerkkarte verwenden, nicht die BMC-Schnittstelle. Im ersten Profil ist dies zugleich die spätere Management-Netzwerkkarte. + +Die ISO muss tatsächlich zur Version passen. Der Generator prüft beim Erzeugen ihre Existenz und protokolliert SHA-256, identifiziert aber noch nicht die Produktversion im ISO-Inhalt. Ein Dateiname ist kein Versionsnachweis. + +## 2. Angaben prüfen + +Auf dem GETAC PowerShell im Ordner `Stagging` öffnen: + +```powershell +.\Prepare-Unattended.ps1 +``` + +Das Programm zeigt die ausgewählten Systeme, Versionen, MAC-Adressen, Zielplatten und Medien. Es schreibt dabei keine Antwortdateien und fragt keine Passwörter ab. Ein anderer Speicherort der Excel-Datei kann mit `-Workbook 'C:\Pfad\ConfigWorkbook_KIS.xlsx'` angegeben werden. + +Benötigt wird Windows PowerShell 5.1 oder PowerShell 7. Excel, ein Excel-Zusatzmodul, Python und ein Vault sind für das Programm nicht erforderlich. Die vorhandene Ausführungsrichtlinie des GETAC wird nicht verändert; falls die Organisation signierte Skripte verlangt, sind die Dateien nach dem dortigen Verfahren zu signieren. + +## 3. Antwortdateien erzeugen + +```powershell +.\Prepare-Unattended.ps1 -Generate +``` + +Nach der Zielübersicht mit `VORBEREITEN` bestätigen. Das erzeugt nur Dateien, startet aber noch keinen Installer. Beim späteren Einsatz löschen diese Dateien die ausgewählten Datenträger; ESXi-Kickstart enthält außerdem `vmaccepteula` und damit die Lizenzzustimmung. Vor Veröffentlichung für PXE müssen die konkreten Ziele, Medien und Lizenzbedingungen geprüft sein. + +Für PVE wird die Administrator-E-Mail abgefragt. Optional kann sie bereits als zusätzliche Einstellung `Admin-E-Mail` in Spalte A und der Wert in Spalte B des Blatts Staging stehen, außerhalb belegter Zellen. Pro Server wird das neue root-Passwort verdeckt abgefragt. Das gemeinsame Passwortprofil verlangt 12–64 druckbare ASCII-Zeichen mit Groß-/Kleinbuchstaben, Zahl und Sonderzeichen ohne Leerzeichen. Damit wird keine Garantie gegeben, dass jede spätere Zielversion jede Passphrase akzeptiert. + +Das Ergebnis liegt in einem neuen Ordner unter `runs`: + +```text +run-.../ + manifest.json + NICHT-AUTOMATISCH-STARTEN.txt + 02-00-00-00-00-11/answer.toml + 02-00-00-00-00-12/ks.cfg +``` + +Nur ausgewählte Server bekommen eine Datei. Die MAC-Adressen bestimmen die Unterordner. Das Manifest enthält die angeforderten Versionen, Datenträger, Medienpfade und Medien-Prüfsummen, keine Passwörter oder Passwort-Hashes. + +Die Antwortdateien enthalten gesalzene SHA-512-crypt-Passwort-Hashes, keine Klartext-Passwörter. Der Laufordner wird unter Windows auf den ausführenden Benutzer beschränkt und ist aus Git ausgeschlossen. Hashes bleiben vertraulich. Der Klartext wird während der Hash-Erzeugung kurz im Prozess benötigt; vollständige Löschung aller verwalteten Speicher-Kopien ist nicht zugesichert. Nach Verwendung den betreffenden Laufordner entfernen. Er wird nicht automatisch publiziert oder gelöscht. + +## Noch erforderlicher PXE-Schritt + +Auf dem GETAC müssen die richtigen Bootdateien und das Installationsmedium passend zur Excel-Version bereitgestellt werden. Das liegt außerhalb des bisherigen Generators: + +1. PVE-Medium mit dem passenden `proxmox-auto-install-assistant` vorbereiten; jede erzeugte Antwortdatei mit dessen `validate-answer` prüfen. Dieses Proxmox-Werkzeug ist kein natives Windows-PowerShell-Modul. Der Vorbereitungsweg für Windows beziehungsweise eine separate Linux-Vorbereitung ist noch festzulegen. +2. ESXi-Medium entpacken und dessen Bootkonfiguration samt hostbezogenem `ks=`-Verweis vorbereiten. +3. DHCP/PXE und einen Dateidienst ausschließlich im Installationsnetz einrichten. Die Bootauswahl darf nur freigegebene MAC-Adressen bedienen. Unbekannte Geräte stoppen. +4. Antwortdateien nur für den bestätigten Durchlauf bereitstellen. Die abgeschlossene Installation muss ihre Freigabe verlieren, damit ein erneuter PXE-Start keine Neuinstallation auslöst. +5. Einen echten Testserver pro gewünschter Plattform installieren und Ergebnis, Anmeldung, Netzkonfiguration und Datenträgerzuordnung prüfen. + +Ein MAC-Unterordner allein ist keine Zugangskontrolle. Die spätere Auslieferung muss gesondert implementiert und geprüft werden. Es werden keine generischen Bootdateien erzeugt, die eine beliebige ISO automatisch als kompatibel behandeln. + +## Vorbereitete Profile und Grenzen + +- PVE 8.4 sowie 9.x: TOML mit `root-password-hashed`, statischem IPv4-Netz und Auswahl der NIC über ihre MAC-Eigenschaft. Festes erstes KIS-Profil: ext4, Land/Tastatur `de`, Zeitzone `Europe/Berlin`. Kein ZFS/RAID-Layout in dieser Etappe. +- ESXi 7.x/8.x: Kickstart mit `rootpw --iscrypted`, expliziter Disk-Kennung, statischem IPv4 und Neustart. Keine zusätzliche Shell-/SSH-Aktivierung. +- Andere Versionen werden mit einer Meldung abgewiesen, statt ein ungeprüftes Format zu erzeugen. Diese Bereiche sind Generatorprofile, keine Aussage über Hersteller-Support oder erfolgreich getestete Hardware. +- 45 automatisierte Prüfungen unter PowerShell 7.4.1 auf macOS bestanden: XLSX-Lesen, Auswahl, Netzwerk-/Datenträgervalidierung, veröffentlichte SHA-512-crypt-Testvektoren und ein vollständiger Dateierzeugungslauf mit zwei Testservern. Die Testmedien sind absichtlich keine bootfähigen ISOs. Ein echter PVE-/ESXi-Installertest, Windows-PowerShell-5.1-Test und Windows-ACL-Test stehen aus. + +Die lokalen Prüfungen lassen sich mit `./Tests/Unattended.Tests.ps1` wiederholen. Sie starten keine Netzwerkdienste und installieren keine Systeme. + +## Technische Quellen + +- [Proxmox Automated Installation](https://pve.proxmox.com/wiki/Automated_Installation) +- [Proxmox: offizielles TOML-Beispiel mit NIC-Auswahl](https://github.com/proxmox/pve-installer/blob/master/proxmox-auto-installer/tests/resources/parse_answer/nic_matching.toml) +- [Proxmox: offizielles Beispiel mit Passwort-Hash](https://github.com/proxmox/pve-installer/blob/master/proxmox-auto-installer/tests/resources/parse_answer/hashed_root_password.toml) +- [Broadcom: ESXi und hostbezogene Kickstart-Auslieferung](https://knowledge.broadcom.com/external/article/440457/esxi-scripted-installation-fails-to-dyna.html) +- [VMware: Default Accounts und gesalzene SHA512-Hashes](https://www.vmware.com/docs/default-accounts-in-vmware-vsphere) +- [SHA-crypt: Algorithmus und Testvektoren](https://www.akkadia.org/drepper/SHA-crypt.txt) + +Die Quellen beschreiben das Dateiformat und Verfahren. Maßgeblich für den Abnahmetest ist der konkrete Installer aus dem Workbook. diff --git a/Stagging/CHANGELOG.md b/Stagging/CHANGELOG.md new file mode 100644 index 0000000..41f9e38 --- /dev/null +++ b/Stagging/CHANGELOG.md @@ -0,0 +1,52 @@ +# Änderungsverlauf + +Die Projektversion steht in `VERSION`. Sie bezeichnet das Staging-Programm, nicht die in Excel gewählte PVE-, ESXi- oder Windows-Version. Das Workbook hat zusätzlich eine eigene Schema-Version (aktuell `0.2 KIS`). + +Neue Änderungen werden unter `Unveröffentlicht` gesammelt. Bei einem neuen Versionsstand werden Datum und Versionsnummer ergänzt und `VERSION` aktualisiert. Vor `1.0.0` erhöhen neue Funktionen oder inkompatible Änderungen die mittlere Zahl; reine Fehlerkorrekturen erhöhen die letzte Zahl. Ab `1.0.0` gelten die üblichen Regeln für Major-, Minor- und Patch-Versionen. + +## Unveröffentlicht + +Noch keine weiteren Änderungen. + +## 0.1.0 – 2026-09-08 + +Erster ausdrücklich versionierter Programmstand. Die vorherigen Entwurfsstände sind damit dokumentiert, aber nicht nachträglich als veröffentlichte Git-Versionen oder Tags ausgegeben. + +### Hinzugefügt + +- PowerShell-Einstieg `Prepare-Unattended.ps1` mit getrennten Abläufen für Prüfung und Dateierzeugung. +- Lesen des KIS-Workbooks ohne installierte Excel-Anwendung oder zusätzliche Excel-Module. +- Zielsystem und gewünschte Version aus Excel; keine automatisch gewählte Ersatzversion. +- Validierung von Pflichtangaben, MAC-Adressen, IPv4-Netzen, DHCP-Bereichen und konkreten Installationsdatenträgern. +- PVE-Antwortdateien (`answer.toml`) und ESXi-Kickstart-Dateien (`ks.cfg`) je ausgewähltem Server. +- Verdeckte Passwortabfrage und gesalzene SHA-512-crypt-Hashes statt Klartext-Passwörtern in Antwortdateien. +- Geschützte Laufordner, MAC-bezogene Dateipfade und Manifest mit Medien-Prüfsummen. +- Anleitung, technische Quellen und 45 automatisierte Prüfungen. +- Versionsdatei und Versionsanzeige über `-ShowVersion`. + +### Übernommene Entwurfsentscheidungen + +- GETAC-Notebook mit Windows Server als mobile DHCP-/PXE-Station. +- Keine Hersteller-Fernverwaltung: kein iLO, iDRAC, IPMI oder Redfish. +- KIS-Workbook mit zwei Blättern (`Staging`, `Server`, Schema 0.2) und Beispielen. Der ältere ausführliche Workbook-Entwurf bleibt als Referenz erhalten. +- Cluster, VMs, Container und Cisco-Konfigurationen bleiben spätere Ausbaustufen. + +### Prüfung + +- 45 lokale Prüfungen unter PowerShell 7.4.1 auf macOS bestanden, einschließlich eines vollständigen Dateierzeugungslaufs mit Test-Excel und Testmedien. +- Die Testmedien sind keine bootfähigen ISOs. Es wurde kein Hypervisor installiert. + +### Bekannte Grenzen + +- DHCP-/PXE-/Webdienst, Medienvorbereitung und die Auslieferung an Zielserver sind noch nicht implementiert. +- Reale PVE-/ESXi-Installationen sowie Windows-PowerShell-5.1- und Windows-ACL-Abnahme stehen aus. +- Vorbereitete Generatorprofile: PVE 8.4/9.x und ESXi 7.x/8.x; kein Nachweis jeder konkreten Zielversion. +- ISO-Inhalte werden noch nicht automatisch der angeforderten Produktversion zugeordnet. +- Erstes statisches Netzwerkprofil benötigt Gateway und DNS. PVE nutzt zunächst ext4, Land/Tastatur `de` und Zeitzone `Europe/Berlin`. + +## Umgang mit Git + +- Änderungen am Programm, Tests, Dokumentation und Workbook-Schema zusammen nachvollziehbar beschreiben. +- Projektversion und Änderungsverlauf bei neuen Versionsständen gemeinsam aktualisieren. +- Laufordner mit Antwortdateien und Passwort-Hashes sowie Installations-ISOs gehören nicht ins Repository; `Stagging/.gitignore` schließt sie aus. +- Git-Commits dokumentieren Änderungen. Release-Tags nur für bewusst freigegebene Versionsstände setzen; dieser Änderungsverlauf allein erstellt keinen Tag. diff --git a/Stagging/Modules/Sha512Crypt.cs b/Stagging/Modules/Sha512Crypt.cs new file mode 100644 index 0000000..e4d0301 --- /dev/null +++ b/Stagging/Modules/Sha512Crypt.cs @@ -0,0 +1,74 @@ +using System; +using System.IO; +using System.Text; +using System.Security.Cryptography; + +// SHA-512 crypt ($6$), not a plain SHA-512 digest. Algorithm: +// https://www.akkadia.org/drepper/SHA-crypt.txt +namespace Staging { + public static class Sha512Crypt { + private const string Alphabet = "./0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"; + private static byte[] Hash(params byte[][] parts) { + using (var stream = new MemoryStream()) { + foreach (var part in parts) stream.Write(part, 0, part.Length); + var bytes = stream.ToArray(); + try { using (var sha = SHA512.Create()) return sha.ComputeHash(bytes); } + finally { Array.Clear(bytes, 0, bytes.Length); } + } + } + private static byte[] Repeat(byte[] bytes, int length) { + var result = new byte[length]; + for (int i = 0; i < length; i++) result[i] = bytes[i % bytes.Length]; + return result; + } + private static void Encode(StringBuilder result, int a, int b, int c, int count) { + int value = (a << 16) | (b << 8) | c; + while (count-- > 0) { result.Append(Alphabet[value & 63]); value >>= 6; } + } + public static string NewSalt() { + var bytes = new byte[16]; + using (var rng = RandomNumberGenerator.Create()) rng.GetBytes(bytes); + var chars = new char[16]; + for (int i = 0; i < chars.Length; i++) chars[i] = Alphabet[bytes[i] & 63]; + return new string(chars); + } + public static string Compute(string password, string salt, int rounds) { + if (String.IsNullOrEmpty(password) || password.Length > 256) throw new ArgumentException("Password length"); + if (String.IsNullOrEmpty(salt) || salt.Length > 16) throw new ArgumentException("Salt length"); + foreach (char c in salt) if (Alphabet.IndexOf(c) < 0) throw new ArgumentException("Salt character"); + if (rounds < 1000 || rounds > 1000000) throw new ArgumentException("Rounds"); + byte[] p = Encoding.UTF8.GetBytes(password), s = Encoding.ASCII.GetBytes(salt); + byte[] repeated = null, dp = null, ds = null, a = null; + try { + var b = Hash(p, s, p); + using (var stream = new MemoryStream()) { + stream.Write(p, 0, p.Length); stream.Write(s, 0, s.Length); + var chunk = Repeat(b, p.Length); stream.Write(chunk, 0, chunk.Length); Array.Clear(chunk, 0, chunk.Length); + for (int n = p.Length; n > 0; n >>= 1) { + var bytes = (n & 1) != 0 ? b : p; stream.Write(bytes, 0, bytes.Length); + } + var input = stream.ToArray(); a = Hash(input); Array.Clear(input, 0, input.Length); + } + Array.Clear(b, 0, b.Length); + repeated = Repeat(p, p.Length * p.Length); var digest = Hash(repeated); + dp = Repeat(digest, p.Length); Array.Clear(repeated, 0, repeated.Length); Array.Clear(digest, 0, digest.Length); + repeated = Repeat(s, s.Length * (16 + a[0])); digest = Hash(repeated); + ds = Repeat(digest, s.Length); Array.Clear(repeated, 0, repeated.Length); Array.Clear(digest, 0, digest.Length); + for (int i = 0; i < rounds; i++) { + byte[] previous = a; + a = Hash((i & 1) != 0 ? dp : previous, i % 3 != 0 ? ds : new byte[0], + i % 7 != 0 ? dp : new byte[0], (i & 1) != 0 ? previous : dp); + Array.Clear(previous, 0, previous.Length); + } + var output = new StringBuilder("$6$rounds=" + rounds + "$" + salt + "$"); + for (int i = 0, j = 0; j < 21; j++, i = (i + 22) % 63) + Encode(output, a[i], a[(i + 21) % 63], a[(i + 42) % 63], 4); + Encode(output, 0, 0, a[63], 2); + return output.ToString(); + } finally { + foreach (var bytes in new[] { p, s, repeated, dp, ds, a }) + if (bytes != null) Array.Clear(bytes, 0, bytes.Length); + } + } + } +} diff --git a/Stagging/Modules/Unattended.psm1 b/Stagging/Modules/Unattended.psm1 new file mode 100644 index 0000000..1215c97 --- /dev/null +++ b/Stagging/Modules/Unattended.psm1 @@ -0,0 +1,205 @@ +Set-StrictMode -Version Latest +$ErrorActionPreference = 'Stop' + +function Read-ZipXml($Zip, [string]$Name, [switch]$Optional) { + $entry = $Zip.GetEntry($Name) + if (-not $entry) { if ($Optional) { return $null }; throw "XLSX-Bestandteil fehlt: $Name" } + if ($entry.Length -gt 16MB) { throw "XLSX-Bestandteil zu gross: $Name" } + $stream = $entry.Open() + $settings = New-Object System.Xml.XmlReaderSettings + $settings.DtdProcessing = [System.Xml.DtdProcessing]::Prohibit + $settings.XmlResolver = $null + $reader = [System.Xml.XmlReader]::Create($stream, $settings) + try { $doc = New-Object System.Xml.XmlDocument; $doc.XmlResolver = $null; $doc.Load($reader); return ,$doc } + finally { $reader.Dispose(); $stream.Dispose() } +} + +function Read-KisWorkbook([string]$Path) { + Add-Type -AssemblyName System.IO.Compression.FileSystem + $zip = [System.IO.Compression.ZipFile]::OpenRead((Resolve-Path -LiteralPath $Path).Path) + try { + $book = Read-ZipXml $zip 'xl/workbook.xml' + $rels = Read-ZipXml $zip 'xl/_rels/workbook.xml.rels' + $shared = Read-ZipXml $zip 'xl/sharedStrings.xml' -Optional + $strings = @() + if ($shared) { $strings = @($shared.SelectNodes('//*[local-name()="si"]') | ForEach-Object { + ($_.SelectNodes('.//*[local-name()="t"]') | ForEach-Object { $_.InnerText }) -join '' + }) } + $sheets = @{} + foreach ($sheet in $book.SelectNodes('//*[local-name()="sheet"]')) { + if ($sheet.GetAttribute('name') -notin @('Staging','Server')) { continue } + $rid = $sheet.GetAttribute('id','http://schemas.openxmlformats.org/officeDocument/2006/relationships') + $rel = @($rels.SelectNodes('//*[local-name()="Relationship"]') | Where-Object { $_.GetAttribute('Id') -eq $rid }) + if ($rel.Count -ne 1) { throw 'Ungueltige XLSX-Beziehung' } + $target = $rel[0].GetAttribute('Target') + if ($target -match '(^/xl/|^xl/)') { $target = $target.TrimStart('/') } else { $target = 'xl/' + $target } + $xml = Read-ZipXml $zip $target + $cells = @{}; $formulas = @{} + foreach ($cell in $xml.SelectNodes('//*[local-name()="sheetData"]/*/*[local-name()="c"]')) { + $address = $cell.GetAttribute('r') + $valueNode = $cell.SelectSingleNode('./*[local-name()="v"]') + $value = if ($valueNode) { $valueNode.InnerText } else { '' } + switch ($cell.GetAttribute('t')) { + 's' { $value = $strings[[int]$value] } + 'inlineStr' { $value = ($cell.SelectNodes('.//*[local-name()="t"]') | ForEach-Object { $_.InnerText }) -join '' } + 'e' { $value = '' } + } + $cells[$address] = [string]$value + if ($cell.SelectSingleNode('./*[local-name()="f"]')) { $formulas[$address] = $true } + } + $sheets[$sheet.GetAttribute('name')] = @{ Cells=$cells; Formulas=$formulas } + } + if (-not $sheets.ContainsKey('Staging') -or -not $sheets.ContainsKey('Server')) { throw 'KIS-Workbook mit Staging und Server erforderlich.' } + $settings = @{} + foreach ($key in $sheets.Staging.Cells.Keys) { + if ($key -notmatch '^A(\d+)$') { continue } + $row = $Matches[1]; $name = $sheets.Staging.Cells[$key] + if ($name -notin @('Projektname','Windows-Server-Version','Netzwerkkarte','GETAC-IP','Netzpräfix','DHCP von','DHCP bis','Medienordner','Proxmox-Medium','ESXi-Medium','Admin-E-Mail')) { continue } + if ($sheets.Staging.Formulas.ContainsKey("B$row")) { throw "Staging!B${row}: Eingabeformeln sind nicht erlaubt." } + if ($settings.ContainsKey($name)) { throw "Doppelte Staging-Einstellung: $name" } + $settings[$name] = [string]$sheets.Staging.Cells["B$row"] + } + $expected = @('Installieren','Servername','PXE-MAC-Adresse','System','Version','Installationsdatenträger','Ziel-IP','Präfix','Gateway','DNS-Server','Benutzername','Hinweis') + for ($i=0; $i -lt $expected.Count; $i++) { + $col = [string][char](65+$i) + if ($sheets.Server.Cells["${col}6"] -cne $expected[$i]) { throw "Server!${col}6: Erwartet '$($expected[$i])'. KIS Schema 0.2 erforderlich." } + } + foreach ($key in $sheets.Server.Cells.Keys) { + if ($key -match '^A(\d+)$' -and [int]$Matches[1] -gt 26 -and $sheets.Server.Cells[$key] -eq 'JA') { throw 'Server ausserhalb der 20 vorbereiteten Zeilen. Bereich zuerst erweitern.' } + } + $servers = @() + for ($r=7; $r -le 26; $r++) { + $values = @{} + for ($i=0; $i -lt $expected.Count; $i++) { + $cell = "$([char](65+$i))$r" + if ($sheets.Server.Formulas.ContainsKey($cell)) { throw "Server!${cell}: Eingabeformeln sind nicht erlaubt." } + $values[$expected[$i]] = ([string]$sheets.Server.Cells[$cell]).Trim() + } + if ($values.Installieren -notin @('','JA','NEIN')) { throw "Server Zeile ${r}: Installieren muss JA oder NEIN sein." } + if ($values.Installieren -eq 'JA') { $values.Row = $r; $servers += $values } + } + return @{ Settings=$settings; Servers=$servers } + } finally { $zip.Dispose() } +} + +function Get-IPv4Number([string]$Value) { + if ($Value -notmatch '^(0|[1-9][0-9]{0,2})(\.(0|[1-9][0-9]{0,2})){3}$') { throw "Ungueltige IPv4-Adresse: $Value" } + [uint64]$n=0 + foreach ($octet in $Value.Split('.')) { if ([int]$octet -gt 255) { throw "Ungueltige IPv4-Adresse: $Value" }; $n=$n*256+[int]$octet } + return $n +} +function Get-Netmask([int]$Prefix) { + $parts = for ($i=0; $i -lt 4; $i++) { $bits=[Math]::Min(8,[Math]::Max(0,$Prefix-8*$i)); [int](256-[Math]::Pow(2,8-$bits)) } + return ($parts -join '.') +} +function Assert-Text([string]$Value,[string]$Pattern,[string]$Label) { + if ([string]::IsNullOrWhiteSpace($Value) -or $Value -notmatch $Pattern) { throw "${Label}: fehlt oder ungueltiges Format." } +} + +function Get-InstallPlan($Config, [switch]$CheckMedia) { + $s=$Config.Settings; $hosts=@($Config.Servers) + if ($hosts.Count -eq 0) { return @() } + foreach ($key in @('Windows-Server-Version','Netzwerkkarte','GETAC-IP','Netzpräfix','DHCP von','DHCP bis','Medienordner')) { + if ([string]::IsNullOrWhiteSpace($s[$key])) { throw "Staging: '$key' fehlt." } + } + Assert-Text $s['Netzpräfix'] '^(?:[1-9]|[12][0-9]|30)$' 'Staging Netzpraefix' + $prefix=[int]$s['Netzpräfix']; [uint64]$block=[Math]::Pow(2,32-$prefix) + $getac=Get-IPv4Number $s['GETAC-IP']; $network=[uint64]([Math]::Floor($getac/$block)*$block); $broadcast=$network+$block-1 + $from=Get-IPv4Number $s['DHCP von']; $to=Get-IPv4Number $s['DHCP bis'] + if ($from -le $network -or $to -ge $broadcast -or $from -gt $to -or ($getac -ge $from -and $getac -le $to) -or $getac -eq $network -or $getac -eq $broadcast) { throw 'Staging: DHCP-Bereich und feste GETAC-IP muessen im selben Netz liegen und sich ausschliessen.' } + $seenMac=@{}; $seenIp=@{}; $seenName=@{}; $versions=@{}; $result=@() + foreach ($h in $hosts) { + $label="Server Zeile $($h.Row)" + Assert-Text $h.Servername '^(?=.{1,253}$)(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\.)+[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?$' "$label Servername (FQDN)" + Assert-Text $h['PXE-MAC-Adresse'] '^(?:[0-9a-fA-F]{2}:){5}[0-9a-fA-F]{2}$' "$label MAC" + $mac=$h['PXE-MAC-Adresse'].ToLowerInvariant() + if (([Convert]::ToInt32($mac.Substring(0,2),16) -band 1) -ne 0 -or $mac -eq '00:00:00:00:00:00') { throw "$label MAC ist keine Unicast-Geraeteadresse." } + if ($seenMac.ContainsKey($mac) -or $seenName.ContainsKey($h.Servername)) { throw "$label Name oder MAC doppelt." } + $seenMac[$mac]=$true; $seenName[$h.Servername]=$true + Assert-Text $h['Präfix'] '^(?:[1-9]|[12][0-9]|30)$' "$label Praefix" + $ip=Get-IPv4Number $h['Ziel-IP'] + if ($seenIp.ContainsKey($h['Ziel-IP'])) { throw "$label IP doppelt." }; $seenIp[$h['Ziel-IP']]=$true + if ([int]$h['Präfix'] -ne $prefix -or $ip -le $network -or $ip -ge $broadcast -or $ip -eq $getac -or ($ip -ge $from -and $ip -le $to)) { throw "$label Ziel-IP muss im GETAC-Netz, ausserhalb DHCP und ungleich GETAC-IP liegen (KIS)." } + $gateway=Get-IPv4Number $h.Gateway + if ($gateway -le $network -or $gateway -ge $broadcast -or $gateway -eq $ip -or ($gateway -ge $from -and $gateway -le $to)) { throw "$label Gateway ungueltig." } + if (-not $h['DNS-Server']) { throw "$label DNS-Server fehlt. Fuer statische Installer-Konfiguration erforderlich." } + $dns=@($h['DNS-Server'].Split(';') | ForEach-Object { $_.Trim(); }) + foreach ($d in $dns) { $null=Get-IPv4Number $d } + if ($h.Benutzername -cne 'root') { throw "$label Installation setzt das root-Konto; andere Konten spaeter anlegen." } + $platform=$h.System; $version=$h.Version + Assert-Text $version '^[0-9]+\.[0-9]+[a-zA-Z0-9._-]*$' "$label Version" + if ($versions.ContainsKey($platform) -and $versions[$platform] -cne $version) { throw 'KIS: Ein Versionssatz je Plattform und Durchlauf.' }; $versions[$platform]=$version + switch ($platform) { + 'Proxmox VE' { + if ($version -notmatch '^(?:8\.[4-9]|9\.[0-9]+)(?:[._-].*)?$') { throw "$label PVE-Version '$version': Generatorprofil derzeit fuer 8.4 und 9.x vorbereitet. Kein stiller Versionsersatz." } + if ($dns.Count -ne 1) { throw "$label PVE-Profil erwartet genau einen DNS-Server." } + Assert-Text $h.Installationsdatenträger '^(?:sd[a-z]+|nvme[0-9]+n[0-9]+|vd[a-z]+|ID_SERIAL=[a-zA-Z0-9_.:+-]+)$' "$label PVE-Disk (Geraetename oder ID_SERIAL=...)" + $mediaName=$s['Proxmox-Medium']; $file='answer.toml' + } + 'VMware ESXi' { + if ($version -notmatch '^[78]\.[0-9]+[a-zA-Z0-9._-]*$') { throw "$label ESXi-Version '$version': Generatorprofil derzeit fuer 7.x/8.x vorbereitet." } + Assert-Text $h.Installationsdatenträger '^(?:naa|eui|t10|mpx)\.[a-zA-Z0-9_.:-]+$' "$label ESXi-Disk (naa./eui./t10./mpx.)" + $mediaName=$s['ESXi-Medium']; $file='ks.cfg' + } + default { throw "$label System muss Proxmox VE oder VMware ESXi sein." } + } + Assert-Text $mediaName '^[^\\/:*?"<>|]+\.iso$' "$label Installationsmedium (ISO-Dateiname)" + $media=Join-Path $s.Medienordner $mediaName + if ($CheckMedia -and -not (Test-Path -LiteralPath $media -PathType Leaf)) { throw "Installationsmedium fehlt: $media" } + $result += [pscustomobject]@{ Name=$h.Servername; Mac=$mac; Platform=$platform; Version=$version; Disk=$h.Installationsdatenträger; IP=$h['Ziel-IP']; Prefix=[int]$h['Präfix']; Gateway=$h.Gateway; DNS=$dns; Media=$media; FileName=$file } + } + foreach ($h in $result) { if ($seenIp.ContainsKey($h.Gateway)) { throw 'Gateway darf keine ausgewaehlte Zielserver-IP sein.' } } + return $result +} + +function New-RootHash([Security.SecureString]$Password) { + if (-not ('Staging.Sha512Crypt' -as [type])) { Add-Type -Path (Join-Path $PSScriptRoot 'Sha512Crypt.cs') } + $pointer=[Runtime.InteropServices.Marshal]::SecureStringToBSTR($Password) + try { + $plain=[Runtime.InteropServices.Marshal]::PtrToStringBSTR($pointer) + # Conservative shared profile; do not weaken the ESXi password policy. + if ($plain.Length -lt 12 -or $plain.Length -gt 64 -or $plain -notmatch '^[\x21-\x7e]+$' -or $plain -notmatch '[A-Z]' -or $plain -notmatch '[a-z]' -or $plain -notmatch '[0-9]' -or $plain -notmatch '[^a-zA-Z0-9]') { throw 'Passwort: 12-64 druckbare ASCII-Zeichen, Gross-/Kleinbuchstaben, Zahl und Sonderzeichen, keine Leerzeichen.' } + return [Staging.Sha512Crypt]::Compute($plain,[Staging.Sha512Crypt]::NewSalt(),100000) + } finally { $plain=$null; [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($pointer) } +} + +function ConvertTo-AnswerText($Server, [string]$Hash, [string]$AdminEmail) { + if ($Hash -notmatch '^\$6\$(?:rounds=[0-9]+\$)?[./a-zA-Z0-9]{1,16}\$[./a-zA-Z0-9]{86}$') { throw 'Ungueltiger SHA-512-crypt-Hash.' } + if ($Server.Platform -eq 'Proxmox VE') { + Assert-Text $AdminEmail '^[a-zA-Z0-9_.+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$' 'PVE Admin-E-Mail' + $disk=if ($Server.Disk.StartsWith('ID_SERIAL=')) { 'filter.ID_SERIAL = "' + $Server.Disk.Substring(10) + '"' } else { 'disk-list = ["' + $Server.Disk + '"]' } + return (@( + '# Generated from KIS workbook. Destructive installation on the specified disk.', + "# Target version: $($Server.Version)", '[global]', 'keyboard = "de"', 'country = "de"', + ('fqdn = "' + $Server.Name + '"'), ('mailto = "' + $AdminEmail + '"'), 'timezone = "Europe/Berlin"', + ('root-password-hashed = "' + $Hash + '"'), '', '[network]', 'source = "from-answer"', + ('cidr = "' + $Server.IP + '/' + $Server.Prefix + '"'), ('gateway = "' + $Server.Gateway + '"'), + ('dns = "' + $Server.DNS[0] + '"'), ('filter.ID_NET_NAME_MAC = "*' + $Server.Mac.Replace(':','') + '"'), + '', '[disk-setup]', 'filesystem = "ext4"', $disk, '' + ) -join "`n") + } + return (@( + '# Generated from KIS workbook. EULA acceptance and disk erase must be approved before use.', + "# Target version: $($Server.Version)", 'vmaccepteula', ('rootpw --iscrypted ' + $Hash), + ('install --disk=' + $Server.Disk + ' --overwritevmfs'), + ('network --bootproto=static --device=' + $Server.Mac + ' --ip=' + $Server.IP + ' --netmask=' + (Get-Netmask $Server.Prefix) + ' --gateway=' + $Server.Gateway + ' --nameserver=' + ($Server.DNS -join ',') + ' --hostname=' + $Server.Name), + 'reboot', '' + ) -join "`n") +} + +function New-PrivateRunDirectory([string]$Parent) { + $name='run-' + [DateTime]::UtcNow.ToString('yyyyMMdd-HHmmss') + '-' + [Guid]::NewGuid().ToString('N').Substring(0,8) + $path=Join-Path $Parent $name + $null=New-Item -ItemType Directory -Path $path -Force + if ([Environment]::OSVersion.Platform -eq [PlatformID]::Win32NT) { + $acl=New-Object Security.AccessControl.DirectorySecurity + $acl.SetAccessRuleProtection($true,$false) + $sid=[Security.Principal.WindowsIdentity]::GetCurrent().User + $acl.SetOwner($sid) + $rule=New-Object Security.AccessControl.FileSystemAccessRule($sid,'FullControl','ContainerInherit,ObjectInherit','None','Allow') + $acl.AddAccessRule($rule) + Set-Acl -LiteralPath $path -AclObject $acl + } else { & chmod 700 $path; if ($LASTEXITCODE -ne 0) { throw 'Ausgabeordner konnte nicht geschuetzt werden.' } } + return $path +} +Export-ModuleMember -Function Read-KisWorkbook,Get-InstallPlan,Get-Netmask,New-RootHash,ConvertTo-AnswerText,New-PrivateRunDirectory diff --git a/Stagging/Prepare-Unattended.ps1 b/Stagging/Prepare-Unattended.ps1 new file mode 100644 index 0000000..41d9206 --- /dev/null +++ b/Stagging/Prepare-Unattended.ps1 @@ -0,0 +1,50 @@ +#requires -Version 5.1 +[CmdletBinding()] +param( + [string]$Workbook = (Join-Path $PSScriptRoot 'outputs/01a07d3f/ConfigWorkbook_KIS.xlsx'), + [switch]$Generate, + [switch]$ShowVersion, + [string]$OutputDirectory = (Join-Path $PSScriptRoot 'runs') +) +$ErrorActionPreference='Stop' +$projectVersion=(Get-Content -LiteralPath (Join-Path $PSScriptRoot 'VERSION') -Raw).Trim() +if ($ShowVersion) { Write-Output $projectVersion; return } +Write-Host "Staging $projectVersion" +Import-Module (Join-Path $PSScriptRoot 'Modules/Unattended.psm1') -Force -DisableNameChecking + +try { + $config=Read-KisWorkbook $Workbook + $plan=@(Get-InstallPlan $config -CheckMedia:$Generate) + if ($plan.Count -eq 0) { Write-Host 'Keine Server ausgewaehlt. In Excel Installieren = JA setzen, wenn der Eintrag vorbereitet ist.'; return } + $plan | Select-Object Name,Platform,Version,Mac,Disk,IP,Media | Format-List | Out-Host + Write-Host 'PVE-Profil: ext4, Tastatur/Land de, Zeitzone Europe/Berlin. Versionen kommen aus Excel.' + Write-Host 'Die angegebene ISO-Version muss inhaltlich zum Medium passen; Dateiname allein ist kein Versionsnachweis.' + if (-not $Generate) { Write-Host 'Pruefung beendet. Mit -Generate werden nach Rueckfrage Antwortdateien erzeugt. Kein PXE-Start.'; return } + + $email=[string]$config.Settings['Admin-E-Mail'] + if (@($plan | Where-Object Platform -eq 'Proxmox VE').Count -gt 0 -and -not $email) { $email=Read-Host 'PVE Administrator-E-Mail (fuer die Antwortdatei)' } + Write-Host 'Antwortdateien loeschen beim spaeteren Installer-Start die oben genannten Datentraeger.' + Write-Host 'Bei ESXi enthalten sie ausserdem die Zustimmung zur VMware-EULA. Dateien erst nach Medien- und Zielpruefung freigeben.' + if ((Read-Host 'Zum Vorbereiten dieser Dateien VORBEREITEN eingeben') -cne 'VORBEREITEN') { Write-Host 'Abgebrochen.'; return } + # Gather all credentials and render in memory before creating a run directory. + $answers=@{} + foreach ($server in $plan) { + $password=Read-Host "Neues root-Passwort fuer $($server.Name)" -AsSecureString + try { $hash=New-RootHash $password; $answers[$server.Mac]=ConvertTo-AnswerText $server $hash $email } + finally { $password.Dispose(); $hash=$null } + } + $run=New-PrivateRunDirectory $OutputDirectory + $utf8=New-Object Text.UTF8Encoding($false) + $manifest=@() + foreach ($server in $plan) { + $hostDir=Join-Path $run $server.Mac.Replace(':','-') + $null=New-Item -ItemType Directory -Path $hostDir + [IO.File]::WriteAllText((Join-Path $hostDir $server.FileName),$answers[$server.Mac],$utf8) + $manifest += [ordered]@{ Hostname=$server.Name; MAC=$server.Mac; Platform=$server.Platform; RequestedVersion=$server.Version; Disk=$server.Disk; Media=$server.Media; MediaSHA256=(Get-FileHash -LiteralPath $server.Media -Algorithm SHA256).Hash; AnswerFile=($server.Mac.Replace(':','-')+'/'+$server.FileName) } + } + [IO.File]::WriteAllText((Join-Path $run 'manifest.json'),(ConvertTo-Json -InputObject @($manifest) -Depth 5),$utf8) + [IO.File]::WriteAllText((Join-Path $run 'NICHT-AUTOMATISCH-STARTEN.txt'),"Vorbereitete Antwortdateien, kein aktiver Deployment-Lauf.`nPXE/HTTP-Anbindung und Installer-Validierung stehen noch aus.`nManifest pruefen. Hashes sind vertraulich. Laufordner nach Nutzung entfernen.`n",$utf8) + $answers.Clear() + Write-Host "Dateien vorbereitet: $run" + Write-Host 'DHCP/PXE wurde nicht gestartet. Naechster Schritt: mit den Medien aus Excel Bootdateien vorbereiten und auf dem GETAC testen.' +} catch { Write-Error $_; exit 1 } diff --git a/Stagging/README.md b/Stagging/README.md index 4c77802..da0da3b 100644 --- a/Stagging/README.md +++ b/Stagging/README.md @@ -1,5 +1,13 @@ # Stagging +Projektversion: **0.1.0**. Änderungen und bekannte Grenzen stehen im [Änderungsverlauf](CHANGELOG.md). Die verbindliche Versionsnummer liegt in [VERSION](VERSION) und kann mit `./Prepare-Unattended.ps1 -ShowVersion` angezeigt werden. Sie ist unabhängig von den Hypervisor-Versionen in Excel und vom Workbook-Schema. + +## Aktueller Programmstand + +Der erste Baustein für unbeaufsichtigte Installationen ist implementiert: `Prepare-Unattended.ps1` liest das KIS-Workbook ohne Excel-Abhängigkeit, prüft ausgewählte Server und erzeugt nach interaktiver Bestätigung PVE-`answer.toml` beziehungsweise ESXi-`ks.cfg`. Die gewünschten Versionen kommen ausschließlich aus Excel. Passwörter werden verdeckt abgefragt und als gesalzene Hashes in die Antwortdateien geschrieben. + +Die [Anleitung](ANLEITUNG.md) beschreibt Prüfung und Dateierzeugung. DHCP/PXE, Medienvorbereitung, Auslieferung und reale Installertests sind noch offen. Auf dem GETAC wurde nichts installiert oder gestartet. + ## Projektauftrag Ein zentraler Staging-Server soll Infrastruktur anhand eines ConfigWorkbooks bereitstellen und konfigurieren. Das ConfigWorkbook ist eine Excel-Datei mit den Parametern für die gewünschte Zielumgebung. diff --git a/Stagging/Tests/Unattended.Tests.ps1 b/Stagging/Tests/Unattended.Tests.ps1 new file mode 100644 index 0000000..696abf1 --- /dev/null +++ b/Stagging/Tests/Unattended.Tests.ps1 @@ -0,0 +1,116 @@ +#requires -Version 5.1 +$ErrorActionPreference='Stop' +Import-Module (Join-Path $PSScriptRoot '../Modules/Unattended.psm1') -Force -DisableNameChecking +Add-Type -Path (Join-Path $PSScriptRoot '../Modules/Sha512Crypt.cs') +$script:count=0 +function Assert($Condition,[string]$Label) { if (-not $Condition) { throw "FAIL: $Label" }; $script:count++ } +function Reject([scriptblock]$Action,[string]$Label) { $caught=$false; try { & $Action | Out-Null } catch { $caught=$true }; Assert $caught $Label } +function Fixture { + return @{ + Settings=@{ 'Windows-Server-Version'='2025'; 'Netzwerkkarte'='Ethernet'; 'GETAC-IP'='192.168.50.1'; 'Netzpräfix'='24'; 'DHCP von'='192.168.50.100'; 'DHCP bis'='192.168.50.199'; 'Medienordner'=[IO.Path]::GetTempPath(); 'Proxmox-Medium'='proxmox-ve_9.0-1.iso'; 'ESXi-Medium'='VMware-VMvisor-Installer-8.0U3.iso' } + Servers=@( + @{Row=7; Installieren='JA'; Servername='pve01.lab.example'; 'PXE-MAC-Adresse'='02:00:00:00:00:11'; System='Proxmox VE'; Version='9.0-1'; Installationsdatenträger='ID_SERIAL=TEST_DISK_01'; 'Ziel-IP'='192.168.50.11'; 'Präfix'='24'; Gateway='192.168.50.254'; 'DNS-Server'='192.168.50.53'; Benutzername='root'}, + @{Row=8; Installieren='JA'; Servername='esxi01.lab.example'; 'PXE-MAC-Adresse'='02:00:00:00:00:12'; System='VMware ESXi'; Version='8.0U3'; Installationsdatenträger='naa.6000000000000001'; 'Ziel-IP'='192.168.50.12'; 'Präfix'='24'; Gateway='192.168.50.254'; 'DNS-Server'='192.168.50.53'; Benutzername='root'} + ) + } +} +$expected='$6$rounds=5000$saltstring$svn8UoSVapNtMuq1ukKS4tPQd8iKwSMHWjl/O817G3uBnIFNjnQJuesI68u4OTLiBFdcbYEdFCoEOfaS35inz1' +$hash=[Staging.Sha512Crypt]::Compute('Hello world!','saltstring',5000) +Assert ($hash -ceq $expected) 'SHA512-crypt published vector' +$hash2=[Staging.Sha512Crypt]::Compute('Hello world!','saltstringsaltst',10000) +Assert ($hash2 -ceq '$6$rounds=10000$saltstringsaltst$OW1/O6BYHV6BcXZu8QVeXbDWra3Oeqh0sbHbbMCVNSnCM/UrjmM0Dp8vOuZeHBy/YTBmSK6H9qs/y3RnOaw5v.') 'SHA512-crypt 10000 rounds vector' +Assert ([Staging.Sha512Crypt]::NewSalt() -ne [Staging.Sha512Crypt]::NewSalt()) 'Random salt' +$source=Join-Path $PSScriptRoot '../outputs/01a07d3f/ConfigWorkbook_KIS.xlsx' +$config=Read-KisWorkbook $source +Assert (@($config.Servers).Count -eq 0) 'Unselected workbook stays inactive' +Assert ($config.Settings['GETAC-IP'] -eq '192.168.50.1') 'Native XLSX import' +Assert (@(Get-InstallPlan $config).Count -eq 0) 'No selected rows, no preparation' +$plan=@(Get-InstallPlan (Fixture)) +Assert ($plan.Count -eq 2) 'Both installer profiles' +Assert ($plan[0].Version -eq '9.0-1' -and $plan[1].Version -eq '8.0U3') 'Versions from workbook' +Assert ((Get-Netmask 24) -eq '255.255.255.0') 'Netmask /24' +Assert ((Get-Netmask 23) -eq '255.255.254.0') 'Netmask /23' +$pve=ConvertTo-AnswerText $plan[0] $hash 'admin@example.test' +$esxi=ConvertTo-AnswerText $plan[1] $hash '' +Assert ($pve.Contains('root-password-hashed = "'+$hash+'"')) 'PVE hashed root password' +Assert ($pve.Contains('filter.ID_SERIAL = "TEST_DISK_01"')) 'PVE exact serial filter' +Assert ($pve.Contains('filter.ID_NET_NAME_MAC = "*020000000011"')) 'PVE NIC selection' +Assert ($esxi.Contains('install --disk=naa.6000000000000001 --overwritevmfs')) 'ESXi explicit disk' +Assert ($esxi.Contains('--device=02:00:00:00:00:12')) 'ESXi NIC selection' +Assert (-not $esxi.Contains('--firstdisk')) 'No first-disk fallback' +Assert (-not ($pve+$esxi).Contains('Hello world!')) 'No plaintext password in answers' +Reject { $c=Fixture; $c.Servers[0].Version=''; Get-InstallPlan $c } 'Missing version' +Reject { $c=Fixture; $c.Servers[0].Version='99.0'; Get-InstallPlan $c } 'Unknown schema version' +Reject { $c=Fixture; $c.Servers[0]['PXE-MAC-Adresse']='02:00:00:00:00:12'; Get-InstallPlan $c } 'Duplicate MAC' +Reject { $c=Fixture; $c.Servers[0]['PXE-MAC-Adresse']='ff:ff:ff:ff:ff:ff'; Get-InstallPlan $c } 'Broadcast MAC' +Reject { $c=Fixture; $c.Servers[0].Installationsdatenträger='*'; Get-InstallPlan $c } 'Wildcard disk' +Reject { $c=Fixture; $c.Servers[0].Installationsdatenträger="sda`nreboot"; Get-InstallPlan $c } 'Directive injection' +Reject { $c=Fixture; $c.Servers[0]['Ziel-IP']='192.168.50.101'; Get-InstallPlan $c } 'DHCP collision' +Reject { $c=Fixture; $c.Servers[0]['Ziel-IP']='192.168.50.1'; Get-InstallPlan $c } 'GETAC collision' +Reject { $c=Fixture; $c.Servers[0]['Ziel-IP']='192.168.50.12'; Get-InstallPlan $c } 'Duplicate target IP' +Reject { $c=Fixture; $c.Servers[0]['Ziel-IP']='192.168.51.11'; Get-InstallPlan $c } 'Different staging subnet' +Reject { $c=Fixture; $c.Servers[0]['DNS-Server']=''; Get-InstallPlan $c } 'Missing DNS' +Reject { $c=Fixture; $c.Servers[0].Gateway=''; Get-InstallPlan $c } 'Missing gateway' +Reject { $c=Fixture; $c.Servers[0].Benutzername='administrator'; Get-InstallPlan $c } 'Unsupported account' +Reject { $c=Fixture; $c.Settings['Proxmox-Medium']='../wrong.iso'; Get-InstallPlan $c } 'Media path traversal' +Reject { $c=Fixture; $c.Settings['GETAC-IP']='192.168.50.150'; Get-InstallPlan $c } 'DHCP includes station' +Reject { ConvertTo-AnswerText $plan[0] $hash "mail@example.test`nroot-password=evil" } 'Email injection' +$pw=ConvertTo-SecureString 'Only-Test-Password-123!' -AsPlainText -Force +try { $secureHash=New-RootHash $pw; Assert ($secureHash.StartsWith('$6$rounds=100000$')) 'Interactive hash profile' } finally { $pw.Dispose() } + +# End-to-end import and file generation using a disposable XLSX fixture and fake +# media. These files are test data, never installation artifacts. +$temp=Join-Path ([IO.Path]::GetTempPath()) ('staging-test-'+[Guid]::NewGuid().ToString('N')) +$null=New-Item -ItemType Directory $temp +try { + $fixturePath=Join-Path $temp 'fixture.xlsx'; Copy-Item -LiteralPath $source -Destination $fixturePath + $zip=[IO.Compression.ZipFile]::Open($fixturePath,[IO.Compression.ZipArchiveMode]::Update) + try { + function Patch-Cells($Archive,[string]$EntryName,$Changes) { + $entry=$Archive.GetEntry($EntryName); $reader=New-Object IO.StreamReader($entry.Open()) + try { [xml]$xml=$reader.ReadToEnd() } finally { $reader.Dispose() } + foreach ($address in $Changes.Keys) { + $node=$xml.SelectSingleNode("//*[local-name()='c' and @r='$address']") + if (-not $node) { throw "Test cell missing: $address" } + $node.RemoveAll(); $node.SetAttribute('r',$address); $node.SetAttribute('t','inlineStr') + $inline=$xml.CreateElement('is',$xml.DocumentElement.NamespaceURI); $t=$xml.CreateElement('t',$xml.DocumentElement.NamespaceURI); $t.InnerText=[string]$Changes[$address] + $null=$inline.AppendChild($t); $null=$node.AppendChild($inline) + } + $entry.Delete(); $entry=$Archive.CreateEntry($EntryName); $writer=New-Object IO.StreamWriter($entry.Open()) + try { $writer.Write($xml.OuterXml) } finally { $writer.Dispose() } + } + Patch-Cells $zip 'xl/worksheets/sheet1.xml' @{ B8='2025'; B14=$temp; B15='test-pve-9.0-1.iso'; B16='test-esxi-8.0U3.iso' } + Patch-Cells $zip 'xl/worksheets/sheet2.xml' @{ A7='JA'; E7='9.0-1'; F7='ID_SERIAL=TEST_DISK'; I7='192.168.50.254'; J7='192.168.50.53'; A8='JA'; E8='8.0U3'; F8='naa.6000000000000001'; I8='192.168.50.254'; J8='192.168.50.53' } + } finally { $zip.Dispose() } + [IO.File]::WriteAllText((Join-Path $temp 'test-pve-9.0-1.iso'),'TEST ONLY - NOT AN ISO') + [IO.File]::WriteAllText((Join-Path $temp 'test-esxi-8.0U3.iso'),'TEST ONLY - NOT AN ISO') + $imported=Read-KisWorkbook $fixturePath + Assert (@($imported.Servers).Count -eq 2) 'Selected XLSX rows imported' + $parsed=@(Get-InstallPlan $imported -CheckMedia) + Assert ($parsed.Count -eq 2 -and $parsed[1].Version -eq '8.0U3') 'Complete XLSX validation' + $global:StagingTestResponses=[Collections.Generic.Queue[string]]::new() + $global:StagingTestResponses.Enqueue('admin@example.test'); $global:StagingTestResponses.Enqueue('VORBEREITEN') + function Read-Host { param($Prompt,[switch]$AsSecureString) + if ($AsSecureString) { return (ConvertTo-SecureString 'Only-Test-Password-123!' -AsPlainText -Force) } + return $global:StagingTestResponses.Dequeue() + } + & (Join-Path $PSScriptRoot '../Prepare-Unattended.ps1') -Workbook $fixturePath -Generate -OutputDirectory (Join-Path $temp 'runs') + $run=@(Get-ChildItem -LiteralPath (Join-Path $temp 'runs') -Directory)[0] + $manifestText=[IO.File]::ReadAllText((Join-Path $run.FullName 'manifest.json')) + $manifest=@(ConvertFrom-Json $manifestText) + Assert ($manifest.Count -eq 2) 'Manifest includes both hosts' + Assert (-not $manifestText.Contains('$6$')) 'Manifest excludes hashes' + foreach ($item in $manifest) { + $answer=[IO.File]::ReadAllText((Join-Path $run.FullName $item.AnswerFile)) + Assert ($answer.Contains('$6$rounds=100000$')) 'Saved answer has salted hash' + Assert (-not $answer.Contains('Only-Test-Password-123!')) 'Saved answer excludes plaintext' + Assert ($item.MediaSHA256 -eq (Get-FileHash -LiteralPath $item.Media).Hash) 'Manifest media hash' + } + Assert (-not (Test-Path (Join-Path $temp 'runs/ks.cfg'))) 'No generic catch-all kickstart' +} finally { + Remove-Item Function:Read-Host -ErrorAction SilentlyContinue + Remove-Variable StagingTestResponses -Scope Global -ErrorAction SilentlyContinue + # Only the unique disposable fixture directory created by this test. + Remove-Item -LiteralPath $temp -Recurse -Force +} +Write-Host "$script:count checks passed. No network services or installations started." diff --git a/Stagging/VERSION b/Stagging/VERSION new file mode 100644 index 0000000..6e8bf73 --- /dev/null +++ b/Stagging/VERSION @@ -0,0 +1 @@ +0.1.0