From 3bc149a3e6afa950dce4547debedf318287d9494 Mon Sep 17 00:00:00 2001 From: Madzone Date: Fri, 9 Oct 2026 15:08:41 +0200 Subject: [PATCH] Update --- NDTrack/ANLEITUNG-Geprueft.md | 24 ++++++++++ NDTrack/NDTrack-Geprueft.ps1 | 65 ++++++++++++++++++++++---- NDTrack/tests/Test-DomainSelection.ps1 | 26 +++++++++++ 3 files changed, 105 insertions(+), 10 deletions(-) create mode 100644 NDTrack/tests/Test-DomainSelection.ps1 diff --git a/NDTrack/ANLEITUNG-Geprueft.md b/NDTrack/ANLEITUNG-Geprueft.md index c7e27b4..2a8cf6c 100644 --- a/NDTrack/ANLEITUNG-Geprueft.md +++ b/NDTrack/ANLEITUNG-Geprueft.md @@ -52,6 +52,30 @@ Ergebnisse liegen unter `C:\SCAN\RESULTS`, Protokolle unter `C:\SCAN\SCRIPT\Logs Eine `.ndtrack-running`-Sperre wird für direkte Scans angelegt und normalerweise entfernt. Nach einem Verbindungs-/Systemabbruch kann sie zurückbleiben. Erst den tatsächlichen Prozesszustand prüfen und dann eine verwaiste Sperre manuell entfernen. Extern gestartete Scans oder gleichzeitig gestartete Skriptinstanzen können nicht vollständig ausgeschlossen werden; das Skript bietet keine transaktionale Sperre über Verteilung, Task und Sammlung hinweg. +## Einsatz in unterschiedlichen AD-Domänen + +Das Hauptskript enthält keine fest vorgegebene Kundendomäne. Bei leeren Werten für `TargetDomain` und `DomainController` verwendet es `USERDNSDOMAIN`, also die DNS-Domäne des ausführenden Windows-Benutzers. Die Suchbasis wird aus dem AD selbst ermittelt. Es werden aktivierte Windows-Server der ausgewählten Domäne über ihre vollständigen DNS-Hostnamen angesprochen. Es erfolgt keine automatische Suche über alle Domänen einer Gesamtstruktur. + +Für eine andere Domäne in `Initialize-Configuration` setzen, zum Beispiel: + +```powershell +$script:TargetDomain = 'firma.example' +$script:DomainController = '' +``` + +Optional einen bestimmten DC angeben: + +```powershell +$script:TargetDomain = 'firma.example' +$script:DomainController = 'dc01.firma.example' +``` + +Die Namen sind Beispiele und müssen durch die tatsächlichen DNS-Namen ersetzt werden. Bei beiden Angaben prüft das Skript, ob der DC zur angegebenen Domäne gehört. Ohne automatisch erkennbare Benutzerdomäne und ohne explizite Konfiguration bricht die AD-Auswahl mit einem Hinweis ab. Eine explizite `TestServers`-Liste umgeht die AD-Suche. + +AD-Abfrage und WinRM verwenden das aktuelle Windows-Konto. Das bei Option 2 eingegebene Konto gilt nur für die Ausführung des Tasks. DNS, Netzwerkzugriff und Berechtigungen müssen in der Zieldomäne vorhanden sein. Bei nicht vertrauenswürdigen Domänen reicht die Angabe des Domänennamens allein nicht; das Skript richtet keine Vertrauensstellung oder alternative WinRM-Anmeldung ein. Es kann auf einem passend berechtigten Verwaltungsrechner der jeweiligen Domäne verwendet werden. Linux-Ziele bleiben unabhängig davon in der Textdatei definiert. + +Sieben isolierte Tests der Domänenauswahl bestanden; echte domänenübergreifende AD-/WinRM-Verbindungen wurden nicht getestet. Test: `pwsh -NoProfile -File ./NDTrack/tests/Test-DomainSelection.ps1`. + ## Zielserver ohne Laufwerk C: — Beispiel SQL-Server Die festen Pfade `C:\SCAN\...` gelten ausschließlich für den ausführenden Windows-Verwaltungsrechner. Dieser benötigt für die aktuelle Konfiguration ein Laufwerk C: und Schreibrechte in diesen Ordnern. Auf den entfernten Windows-Servern ist kein Laufwerk C: erforderlich. diff --git a/NDTrack/NDTrack-Geprueft.ps1 b/NDTrack/NDTrack-Geprueft.ps1 index 8ca93c6..c30133e 100644 --- a/NDTrack/NDTrack-Geprueft.ps1 +++ b/NDTrack/NDTrack-Geprueft.ps1 @@ -19,6 +19,8 @@ function Initialize-Configuration { $script:LinuxLauncher = 'RunNdTrackLinuxUnix_Local.sh' $script:Ergebnisordner = 'C:\SCAN\RESULTS' $script:LogFolder = 'C:\SCAN\SCRIPT\Logs' + $script:TargetDomain = '' # Leer = DNS-Domaene des angemeldeten Benutzers + $script:DomainController = '' # Optional: FQDN eines DCs der Zieldomaene $script:TestServers = @() # Zum Test z.B. @('GARRDSV003'); leer = AD/RDS $script:RDSConnectionBroker = '' # Leer: wird bei Option 8 abgefragt # Option 8 verwendet einen VOLLSTAENDIGEN, auf den RDS-Servern erreichbaren CMD-Pfad. @@ -47,24 +49,67 @@ function Assert-ServerName { throw "Ungueltiger Servername: $Name (DNS-Name oder IPv4 verwenden)." } } +function Get-DirectoryEndpoint { + # Keine kundenspezifischen Domain-DNs oder Servernamen. + if ($script:DomainController) { + Assert-ServerName $script:DomainController + return $script:DomainController + } + if ($script:TargetDomain) { + Assert-ServerName $script:TargetDomain + return $script:TargetDomain + } + if ($env:USERDNSDOMAIN) { + Assert-ServerName $env:USERDNSDOMAIN + return $env:USERDNSDOMAIN + } + throw 'Keine Benutzerdomaene ermittelbar. TargetDomain oder DomainController konfigurieren oder TestServers mit expliziten Zielservern fuellen.' +} function GetADServer { - if ($script:TestServers.Count) { return $script:TestServers } - $root = [ADSI]'LDAP://RootDSE' - $entry = New-Object System.DirectoryServices.DirectoryEntry("LDAP://$($root.defaultNamingContext)") - $searcher = New-Object System.DirectoryServices.DirectorySearcher($entry) - $results = $null + if ($script:TestServers.Count) { + foreach ($server in $script:TestServers) { Assert-ServerName $server } + return $script:TestServers | Sort-Object -Unique + } + $endpoint = Get-DirectoryEndpoint + $root = $null; $entry = $null; $searcher = $null; $results = $null try { + $root = New-Object System.DirectoryServices.DirectoryEntry("LDAP://$endpoint/RootDSE") + $namingContext = [string]$root.Properties['defaultNamingContext'].Value + $dc = [string]$root.Properties['dnsHostName'].Value + if (-not $namingContext -or -not $dc) { throw 'RootDSE liefert keine AD-Domaene bzw. keinen DC.' } + Assert-ServerName $dc + # Optionalen DC auf Zugehoerigkeit zur expliziten Zieldomaene pruefen. + if ($script:TargetDomain) { + Assert-ServerName $script:TargetDomain + $expected = ($script:TargetDomain.TrimEnd('.').Split('.') | ForEach-Object { 'DC=' + $_ }) -join ',' + if ($namingContext -ine $expected) { throw "DC gehoert zu $namingContext, erwartet wurde $expected." } + } + Write-Host "AD-AUSWAHL: $namingContext ueber $dc (aktuelles Windows-Konto)." + $entry = New-Object System.DirectoryServices.DirectoryEntry("LDAP://$dc/$namingContext") + $searcher = New-Object System.DirectoryServices.DirectorySearcher($entry) $searcher.Filter = '(&(objectCategory=computer)(operatingSystem=*Server*)(!(userAccountControl:1.2.840.113556.1.4.803:=2)))' $searcher.PageSize = 1000 + [void]$searcher.PropertiesToLoad.Add('dnshostname') + [void]$searcher.PropertiesToLoad.Add('name') $results = $searcher.FindAll() - @($results | ForEach-Object { - if ($_.Properties['dnshostname'].Count) { [string]$_.Properties['dnshostname'][0] } - else { [string]$_.Properties['name'][0] } - }) | Sort-Object -Unique + $servers = @($results | ForEach-Object { + if ($_.Properties['dnshostname'].Count) { + $name = [string]$_.Properties['dnshostname'][0] + Assert-ServerName $name + $name + } else { + Write-Warning "AD-Computer $($_.Properties['name'][0]) ohne DNS-Hostnamen wird uebersprungen." + } + } | Sort-Object -Unique) + if (-not $servers.Count) { throw 'Keine aktivierten Windows-Server mit DNS-Hostnamen gefunden.' } + $servers } + catch { throw "AD-Abfrage fuer '$endpoint' fehlgeschlagen: $($_.Exception.Message)" } finally { if ($null -ne $results) { $results.Dispose() } - $searcher.Dispose(); $entry.Dispose(); $root.Dispose() + if ($null -ne $searcher) { $searcher.Dispose() } + if ($null -ne $entry) { $entry.Dispose() } + if ($null -ne $root) { $root.Dispose() } } } function GetRDSServer { diff --git a/NDTrack/tests/Test-DomainSelection.ps1 b/NDTrack/tests/Test-DomainSelection.ps1 new file mode 100644 index 0000000..0133b77 --- /dev/null +++ b/NDTrack/tests/Test-DomainSelection.ps1 @@ -0,0 +1,26 @@ +$ErrorActionPreference='Stop' +. (Join-Path (Split-Path $PSScriptRoot -Parent) 'NDTrack-Geprueft.ps1') -LibraryOnly +$saved=$env:USERDNSDOMAIN +function Assert { param($Condition) if(-not $Condition){throw 'Domaenenauswahl falsch'} } +try { + $script:TargetDomain=''; $script:DomainController='' + $env:USERDNSDOMAIN='first.example' + Assert ((Get-DirectoryEndpoint) -eq 'first.example') + $env:USERDNSDOMAIN='second.example' + Assert ((Get-DirectoryEndpoint) -eq 'second.example') + $script:TargetDomain='target.example' + Assert ((Get-DirectoryEndpoint) -eq 'target.example') + $script:DomainController='dc01.target.example' + Assert ((Get-DirectoryEndpoint) -eq 'dc01.target.example') + $script:DomainController=''; $script:TargetDomain=''; $env:USERDNSDOMAIN='' + $failed=$false + try { Get-DirectoryEndpoint } catch { $failed=$true } + Assert $failed + $script:TargetDomain='invalid/path' + $failed=$false + try { Get-DirectoryEndpoint } catch { $failed=$true } + Assert $failed + $script:TestServers=@('sql01.target.example','sql01.target.example') + Assert ((@(GetADServer)).Count -eq 1) + Write-Host '7 Domaenenauswahl-Pruefungen bestanden; keine echte AD-Verbindung.' +} finally { $env:USERDNSDOMAIN=$saved }