From ce3e1879b879b5f144560af4f52b426d5a4b289d Mon Sep 17 00:00:00 2001 From: Ion Vasilian <78395581+ionvasilian@users.noreply.github.com> Date: Wed, 18 Nov 2026 21:02:21 -0800 Subject: [PATCH] Add the isolation_session network test baseline Add tests/scripts/run_isolation_session_network_test.ps1, a network test pass for the isolation_session backend. Its 35 rows are adapted from the process_container network areas (capability matrix, model-3 equivalence, egress rules, host loopback, proxy), using the WSLC GA-egress matrix as the row template where it fits. Each row runs the shipping wxc-exec, and its outcome is judged at runtime; there is no build flag: - admitted: the probe inside the sandbox must show the requested posture (reachable where allowed, blocked where denied). Admitted but narrower or broader than requested is FAIL. - rejected with the named isolation_session network rejection: UNSUPPORTED, reported with the capability it needs. Any other error is FAIL. - KNOWN-GAP only for a recorded gap (a killed wxc-exec can leak its agent user). When a later change admits a shape, its row starts enforcing without editing the script. On today's MXC the all-allow row passes and every restricted row reports UNSUPPORTED. Row E13 pins that the link-local metadata address 169.254.169.254 is never reachable: an explicit allow of 169.254.0.0/16 must be rejected (linkLocal) or, if admitted, the probe to 169.254.169.254:80 must be blocked. The script skips in session 0 and where the backend is unavailable, and prints the summary line the Windows integration harness parses. The TestBundle build stages the script (optional on older bundled branches), so the Windows integration tests that consume the bundle can run it. Add the invalid v1.1.0-alpha fixture isolation_session_declared_loopback_ports.json, which pins that a declared-loopback shape is rejected today. No product code changes. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Copilot-Session: 9e4e00d4-9956-456c-93ca-1c66128be594 --- .../IsolationSession.TestBundle.Build.Job.yml | 12 + scripts/ci/build-windows-sdk-test-bundle.ps1 | 5 +- ...ation_session_declared_loopback_ports.json | 31 + .../run_isolation_session_network_test.ps1 | 594 ++++++++++++++++++ 4 files changed, 640 insertions(+), 2 deletions(-) create mode 100644 src/mxc-sdk/tests/mxc_contract/v1_1_0_alpha/fixtures/one_shot/invalid/isolation_session_declared_loopback_ports.json create mode 100644 tests/scripts/run_isolation_session_network_test.ps1 diff --git a/.azure-pipelines/templates/IsolationSession.TestBundle.Build.Job.yml b/.azure-pipelines/templates/IsolationSession.TestBundle.Build.Job.yml index 4f2ba70af..1ed004d5e 100644 --- a/.azure-pipelines/templates/IsolationSession.TestBundle.Build.Job.yml +++ b/.azure-pipelines/templates/IsolationSession.TestBundle.Build.Job.yml @@ -315,6 +315,18 @@ jobs: Write-Host " -> test_scripts/$s" } + # Optional until every bundled branch carries it (the feature bundle builds an older branch). + $optionalScripts = @('run_isolation_session_network_test.ps1') + foreach ($s in $optionalScripts) { + $src = "$(Build.SourcesDirectory)/tests/scripts/$s" + if (Test-Path -LiteralPath $src -PathType Leaf) { + Copy-Item $src "$out/test_scripts/" + Write-Host " -> test_scripts/$s" + } else { + Write-Host " (skip) optional test script not on this branch: $s" + } + } + # Use self's staging logic even when the selected source branch predates the helper. & "$(Pipeline.Workspace)/lock-check/scripts/ci/stage-isolation-session-test-helpers.ps1" ` -SourceDirectory "$(Build.SourcesDirectory)/tests/scripts" ` diff --git a/scripts/ci/build-windows-sdk-test-bundle.ps1 b/scripts/ci/build-windows-sdk-test-bundle.ps1 index 9ac9dc0df..1319a54fc 100644 --- a/scripts/ci/build-windows-sdk-test-bundle.ps1 +++ b/scripts/ci/build-windows-sdk-test-bundle.ps1 @@ -213,7 +213,7 @@ Copy-Item -LiteralPath $nodeExe, (Join-Path (Split-Path -Parent $nodeExe) 'LICEN Copy-Item -Path (Join-Path $repoRoot 'tests\configs\isolation_session_*.json') -Destination (New-Directory (Join-Path $OutputDirectory 'test_configs')) $scriptsOut = New-Directory (Join-Path $OutputDirectory 'test_scripts') -foreach ($name in 'run_isolation_session_tests.ps1', 'run_isolation_session_state_aware_tests.ps1', 'run_isolation_session_resize_smoke.ps1') { +foreach ($name in 'run_isolation_session_tests.ps1', 'run_isolation_session_state_aware_tests.ps1', 'run_isolation_session_resize_smoke.ps1', 'run_isolation_session_network_test.ps1') { Copy-Item -LiteralPath (Join-Path $repoRoot "tests\scripts\$name") -Destination $scriptsOut } $helperPaths = @(& (Join-Path $PSScriptRoot 'stage-isolation-session-test-helpers.ps1') ` @@ -307,7 +307,8 @@ $required = @( "sdk-integration\node_modules\@microsoft\mxc-sdk\bin\$Architecture\mxc-wslc-gateway.tar", 'test_scripts\run_isolation_session_tests.ps1', 'test_scripts\run_isolation_session_state_aware_tests.ps1', - 'test_scripts\run_isolation_session_resize_smoke.ps1' + 'test_scripts\run_isolation_session_resize_smoke.ps1', + 'test_scripts\run_isolation_session_network_test.ps1' ) if ($Architecture -eq 'x64') { $required += @( diff --git a/src/mxc-sdk/tests/mxc_contract/v1_1_0_alpha/fixtures/one_shot/invalid/isolation_session_declared_loopback_ports.json b/src/mxc-sdk/tests/mxc_contract/v1_1_0_alpha/fixtures/one_shot/invalid/isolation_session_declared_loopback_ports.json new file mode 100644 index 000000000..f5a0e1c26 --- /dev/null +++ b/src/mxc-sdk/tests/mxc_contract/v1_1_0_alpha/fixtures/one_shot/invalid/isolation_session_declared_loopback_ports.json @@ -0,0 +1,31 @@ +{ + "version": "1.1.0-alpha", + "containment": "isolation_session", + "process": { + "commandLine": "echo" + }, + "network": { + "egress": { + "default": "deny", + "allow": [ + { + "to": [ + { + "cidr": "127.0.0.1/32" + } + ], + "ports": [ + { + "protocol": "tcp", + "port": 5001 + } + ] + } + ] + }, + "ingress": { + "default": "deny", + "hostLoopback": "deny" + } + } +} diff --git a/tests/scripts/run_isolation_session_network_test.ps1 b/tests/scripts/run_isolation_session_network_test.ps1 new file mode 100644 index 000000000..63411150b --- /dev/null +++ b/tests/scripts/run_isolation_session_network_test.ps1 @@ -0,0 +1,594 @@ +# Copyright (c) Microsoft Corporation. +# Licensed under the MIT License. + +<# +.SYNOPSIS + IsolationSession network test pass. Judges every row at runtime: a + request is either admitted and its posture holds, or it is rejected + with a named network rejection. + +.DESCRIPTION + This is the isolation_session counterpart of the ProcessContainer network + areas (capability matrix, model-3 equivalence, egress rules, host loopback, + proxy, rejections), with the LXC GA egress matrix as the row template. + Rows are ordered by priority: on/off, L3/L4 egress, host loopback, bring- + your-own proxy, then the rejection surface. A row asserts capability + outcomes only, never a ProcessContainer capability name, field coupling, + or schema shape. + + Every row runs wxc-exec for real (no --dry-run, no build flag, no host + setup). The request carries a probe command that runs inside the session + and tries a fixed set of targets. The outcome is decided by what the + binary under test does with the request: + + PASS admitted and the requested posture held: every target the + request allows was reached, every other target was + blocked. Rejection-surface rows (X*) pass when rejected. + E13 also passes when rejected naming linkLocal. + UNSUPPORTED rejected with the named network rejection. The row records + the capability it needs. Not a failure. + FAIL admitted but broader than requested (a target outside the + request was reached), admitted but narrower (an allowed + target was blocked), the baseline all-allow row rejected, + a rejection-surface row admitted, or any other error. + KNOWN-GAP a recorded gap; see G13 below. Not a failure. + + A row therefore starts enforcing its posture as soon as a binary admits + its shape, without editing this script. + + Probe targets (inside the session): + external TCP to -ExternalAddress:-ExternalPort + udp UDP send to -ExternalAddress:53 + dns resolve -DnsName + declared TCP to a host loopback listener whose port the request names + other TCP to a second host loopback listener the request never names + down TCP to a host loopback port with no listener + linklocal TCP to 169.254.169.254:80 (instance metadata); judged only + in E13, recorded in every other row + Loopback listeners answer with a per-run nonce, so a relay that accepts + locally cannot pass as reaching the host. DNS is report-only in every + restricted row: name resolution may leave a default-deny session, so it + is recorded but never fails a restricted row. In the all-allow row it + must resolve. + + Known gap G13: if a session outlives its timeout this script kills + wxc-exec; a killed wxc-exec can leave its session's agent user behind. + The row fails and a G13 KNOWN-GAP row is added. + + Runtime rows provision sessions, so run interactively as the console + user, never in Session 0. + + Exit codes: 0 no row failed (UNSUPPORTED and KNOWN-GAP included), 1 any + row failed or the environment cannot judge external reachability. + +.PARAMETER WxcExePath + Path to wxc-exec.exe built with --features isolation_session. + +.PARAMETER ExternalAddress + IPv4 address used as the external destination. It must be reachable from + the host itself, so a denial inside the session is attributable to policy. + +.PARAMETER DnsName + Name resolved by the dns probe. + +.PARAMETER Version + Contract version of the generated requests. + +.PARAMETER Row + Optional row ids to run (default: all). + +.PARAMETER ResultsPath + Optional path for a JSON array of row results. + +.PARAMETER ConfigDir + Accepted for compatibility with the OS MXC integration harness, which + passes it to every bundle orchestrator. Unused: rows build their own + requests. + +.EXAMPLE + .\run_isolation_session_network_test.ps1 -WxcExePath C:\test\wxc-exec.exe + .\run_isolation_session_network_test.ps1 -Row A01,L01 -ResultsPath .\net.json +#> + +param( + [string]$WxcExePath, + [string]$ExternalAddress = '1.1.1.1', + [int]$ExternalPort = 443, + [string]$DnsName = 'www.microsoft.com', + [string]$Version = '1.1.0-alpha', + [string[]]$Row, + [string]$ResultsPath, + [string]$ConfigDir +) + +$ErrorActionPreference = 'Stop' +$RepoRoot = Split-Path -Parent (Split-Path -Parent $PSScriptRoot) +$SessionTimeoutMs = 120000 +$KillGraceMs = 60000 + +# A named network rejection mentions the isolation session and the network. +$NetworkRejection = '(?i)isolation ?session[^\r\n]{0,60}network' + +if (-not $WxcExePath) { + # Repo build (honors CARGO_TARGET_DIR), then the TestBundle layout. + $roots = @($env:CARGO_TARGET_DIR, (Join-Path $RepoRoot 'src\target')) | Where-Object { $_ } + $candidates = foreach ($root in $roots) { + foreach ($cfg in 'release', 'debug') { Join-Path $root "$cfg\wxc-exec.exe" } + } + $candidates += @(Get-ChildItem (Join-Path $RepoRoot 'bin\*\wxc-exec.exe') -ErrorAction Ignore).FullName + $WxcExePath = $candidates | Where-Object { $_ -and (Test-Path $_) } | Select-Object -First 1 +} +if (-not $WxcExePath -or -not (Test-Path $WxcExePath)) { + Write-Host 'FAILED: wxc-exec.exe not found; pass -WxcExePath.' -ForegroundColor Red + exit 1 +} + +Write-Host "`nIsolationSession network test pass (Preview API, not a contract)" -ForegroundColor Cyan +Write-Host "Binary: $WxcExePath`n" -ForegroundColor Gray + +# ---------------------------------------------------------------- preflight + +if ((Get-Process -Id $PID).SessionId -eq 0) { + Write-Host 'SKIPPED: Session 0; run interactively as the console user.' -ForegroundColor Yellow + exit 0 +} +$probeOut = & { $ErrorActionPreference = 'Continue'; & $WxcExePath --probe 2>&1 | Out-String } +if ($LASTEXITCODE -le -1073741824 -or $probeOut -notmatch '"isolationSessionAvailable"\s*:\s*(true|false)') { + Write-Host ("FAILED: '$WxcExePath --probe' exited $LASTEXITCODE without a probe report " + + '(missing runtime DLL?). No rows were run.') -ForegroundColor Red + exit 1 +} +if ($Matches[1] -eq 'false') { + Write-Host 'SKIPPED: wxc-exec --probe reports isolationSessionAvailable=false' -ForegroundColor Yellow + exit 0 +} +$hostExternal = $false +try { + $c = [Net.Sockets.TcpClient]::new() + $hostExternal = $c.ConnectAsync($ExternalAddress, $ExternalPort).Wait(5000) + $c.Close() +} catch {} +if (-not $hostExternal) { + Write-Host ("FAILED: the host cannot reach $ExternalAddress`:$ExternalPort, so no row can judge " + + 'external reachability. Pass a reachable -ExternalAddress.') -ForegroundColor Red + exit 1 +} + +# ---------------------------------------------------------------- helpers + +[System.Collections.ArrayList]$Rows = @() +$script:Killed = @() + +function Add-Row { + param([string]$Id, [string]$Area, [string]$Capability, [string]$Needs, + [string]$Expected, [string]$Actual, [string]$Verdict, [string]$Detail = '') + $color = switch ($Verdict) { 'PASS' { 'Green' } 'FAIL' { 'Red' } default { 'Yellow' } } + $label = if ($Verdict -eq 'UNSUPPORTED') { "UNSUPPORTED (needs $Needs)" } else { $Verdict } + Write-Host (" {0,-5} {1,-46} {2}" -f $Id, $Capability, $label) -ForegroundColor $color + if ($Verdict -eq 'FAIL' -or $Verdict -eq 'KNOWN-GAP') { + Write-Host " expected: $Expected" -ForegroundColor Gray + Write-Host " actual: $Actual" -ForegroundColor Gray + } + if ($Detail) { Write-Host " $Detail" -ForegroundColor DarkGray } + $null = $Rows.Add([pscustomobject]@{ + Id = $Id; Area = $Area; Capability = $Capability; Needs = $Needs + Expected = $Expected; Actual = $Actual; Verdict = $Verdict; Detail = $Detail + }) +} + +# Requests go to wxc-exec by file, never on its command line, because a +# request can carry a credential (for example in a proxy URL). +function Invoke-WxcRequest { + param([hashtable]$Request) + $dir = Join-Path ([IO.Path]::GetTempPath()) ('mxc-net-' + [guid]::NewGuid().ToString('N')) + New-Item -ItemType Directory -Path $dir | Out-Null + $cfg = Join-Path $dir 'config.json' + [IO.File]::WriteAllText($cfg, ($Request | ConvertTo-Json -Compress -Depth 12)) + $psi = New-Object Diagnostics.ProcessStartInfo + $psi.FileName = $WxcExePath + $psi.Arguments = "--debug --config `"$cfg`"" + $psi.UseShellExecute = $false + $psi.RedirectStandardOutput = $true + $psi.RedirectStandardError = $true + $psi.CreateNoWindow = $true + $killed = $false + try { + $p = [Diagnostics.Process]::Start($psi) + $so = $p.StandardOutput.ReadToEndAsync() + $se = $p.StandardError.ReadToEndAsync() + if (-not $p.WaitForExit($SessionTimeoutMs + $KillGraceMs)) { + $killed = $true + try { $p.Kill() } catch {} + [void]$p.WaitForExit(10000) + } + $p.WaitForExit() + $out = $so.Result + $se.Result + $code = $p.ExitCode + } finally { + Remove-Item -Path $dir -Recurse -Force -ErrorAction Ignore + } + return [pscustomobject]@{ ExitCode = $code; Output = [string]$out; Killed = $killed } +} + +function New-Request { + param($Network, [hashtable]$RuntimeConfig, [string]$CommandLine) + $r = @{ + version = $Version + containment = 'isolation_session' + process = @{ commandLine = $CommandLine; cwd = 'C:\'; timeout = $SessionTimeoutMs } + } + if ($null -ne $Network) { $r['network'] = $Network } + if ($null -ne $RuntimeConfig) { $r['runtimeConfig'] = $RuntimeConfig } + return $r +} + +function Rule { + param([string[]]$Cidr = @(), [string[]]$Except = @(), [string]$Protocol, $Port, $EndPort, + [switch]$NoPorts) + $rule = [ordered]@{} + if ($Cidr.Count -gt 0) { + $rule['to'] = @(foreach ($c in $Cidr) { + $peer = [ordered]@{ cidr = $c } + if ($Except.Count -gt 0) { $peer['except'] = @($Except) } + $peer + }) + } + if (-not $NoPorts) { + $sel = [ordered]@{} + if ($Protocol) { $sel['protocol'] = $Protocol } + if ($null -ne $Port) { $sel['port'] = [int]$Port } + if ($null -ne $EndPort) { $sel['endPort'] = [int]$EndPort } + $rule['ports'] = @($sel) + } + return $rule +} + +$AllowAll = @{ egress = @{ default = 'allow' }; ingress = @{ default = 'allow'; hostLoopback = 'allow' } } +$DenyIngress = @{ default = 'deny'; hostLoopback = 'deny' } +function DenyDefault { + param([object[]]$Allow, $Ingress = $DenyIngress, [object[]]$Deny) + $egress = @{ default = 'deny' } + if ($Allow) { $egress['allow'] = @($Allow) } + if ($Deny) { $egress['deny'] = @($Deny) } + $n = @{ egress = $egress } + if ($null -ne $Ingress) { $n['ingress'] = $Ingress } + return $n +} +$Lo = '127.0.0.1/32' + +# ---------------------------------------------------------------- probe + +# Runs inside the session under Windows PowerShell 5.1. Prints one +# 'PROBE ' line per target; verdicts are REACHED, CONNECTED, +# CLOSED, RESOLVED, SENT, TIMEOUT, or WSA. +$ProbeBody = @' +function Get-Wsa($e) { + while ($e) { + if ($e -is [Net.Sockets.SocketException]) { return "WSA$($e.ErrorCode)" } + $e = $e.InnerException + } + return 'ERR' +} +function Test-Tcp($name, $addr, $port, $nonce) { + $ip = [Net.IPAddress]::Parse($addr) + $c = New-Object Net.Sockets.TcpClient($ip.AddressFamily) + try { + $t = $c.ConnectAsync($ip, $port) + if (-not $t.Wait(8000)) { "PROBE $name TIMEOUT"; return } + # A non-loopback server may send nothing until the client speaks (TLS), so a connect + # alone proves reachability there. + if (-not $nonce) { "PROBE $name CONNECTED"; return } + # Always read: a loopback relay accepts locally and only resets after its host-side + # connect fails, so a connect alone cannot tell "reached" from "relay refused". + $s = $c.GetStream() + $s.ReadTimeout = 5000 + $buf = New-Object byte[] 256 + $n = $s.Read($buf, 0, $buf.Length) + if ($n -eq 0) { "PROBE $name CLOSED"; return } + $text = [Text.Encoding]::ASCII.GetString($buf, 0, $n) + if ($text.Contains($nonce)) { "PROBE $name REACHED" } else { "PROBE $name CONNECTED" } + } catch { + "PROBE $name $(Get-Wsa $_.Exception)" + } finally { + $c.Close() + } +} +function Test-Udp($name, $addr, $port) { + $u = New-Object Net.Sockets.UdpClient + try { + $u.Connect($addr, $port) + [void]$u.Send([byte[]](1, 2, 3), 3) + "PROBE $name SENT" + } catch { + "PROBE $name $(Get-Wsa $_.Exception)" + } finally { + $u.Close() + } +} +function Test-Dns($name, $hostName) { + try { + [void][Net.Dns]::GetHostAddresses($hostName) + "PROBE $name RESOLVED" + } catch { + "PROBE $name $(Get-Wsa $_.Exception)" + } +} +'@ + +function Start-NonceListener { + $listener = [Net.Sockets.TcpListener]::new([Net.IPAddress]::Loopback, 0) + $listener.Start() + $nonce = 'MXC-NONCE-' + [guid]::NewGuid().ToString('N') + $ps = [PowerShell]::Create() + [void]$ps.AddScript({ + param($l, $n) + $bytes = [Text.Encoding]::ASCII.GetBytes("$n`n") + while ($true) { + try { + $client = $l.AcceptTcpClient() + $stream = $client.GetStream() + $stream.Write($bytes, 0, $bytes.Length) + $stream.Flush() + $client.Close() + } catch { break } + } + }).AddArgument($listener).AddArgument($nonce) + $handle = $ps.BeginInvoke() + return [pscustomobject]@{ + Port = $listener.LocalEndpoint.Port + Nonce = $nonce + Stop = { + try { $listener.Stop() } catch {} + try { [void]$ps.EndInvoke($handle) } catch {} + try { $ps.Dispose() } catch {} + }.GetNewClosure() + } +} + +function Get-FreeLoopbackPort { + $l = [Net.Sockets.TcpListener]::new([Net.IPAddress]::Loopback, 0) + $l.Start() + $p = $l.LocalEndpoint.Port + $l.Stop() + return $p +} + +$Reach = @{ + external = 'CONNECTED'; udp = 'SENT'; dns = 'RESOLVED'; declared = 'REACHED'; other = 'REACHED' + linklocal = 'CONNECTED' +} +$Targets = @('external', 'udp', 'dns', 'declared', 'other', 'down', 'linklocal') + +function Test-Blocked([string]$v) { return $v -match '^(WSA\d+|TIMEOUT|CLOSED)$' } + +# Judges an admitted row. $Allow lists the targets the request allows; every +# other target must be blocked. dns is report-only unless the row allows it +# and DnsRequired is set; linklocal is report-only unless LinkLocalJudged is set. +function Get-PostureVerdict { + param([hashtable]$Verdicts, [string[]]$Allow, [switch]$DnsRequired, [switch]$LinkLocalJudged) + $broader = @(); $narrower = @(); $unknown = @() + foreach ($t in $Targets) { + $got = $Verdicts[$t] + if (-not $got) { $got = 'NORUN' } + if ($t -eq 'dns' -and -not $DnsRequired) { continue } + if ($t -eq 'linklocal' -and -not $LinkLocalJudged) { continue } + if ($Allow -contains $t) { + if ($got -ne $Reach[$t]) { + if (Test-Blocked $got) { $narrower += "$t=$got" } else { $unknown += "$t=$got" } + } + } elseif (-not (Test-Blocked $got)) { + if ($Reach.ContainsKey($t) -and $got -eq $Reach[$t]) { $broader += "$t=$got" } + else { $unknown += "$t=$got" } + } + } + $actual = (@($Targets | ForEach-Object { + $g = $Verdicts[$_]; if (-not $g) { $g = 'NORUN' }; "$_=$g" + })) -join ' ' + $why = @() + if ($broader) { $why += "broader than requested: $($broader -join ', ')" } + if ($narrower) { $why += "allowed target blocked: $($narrower -join ', ')" } + if ($unknown) { $why += "indeterminate: $($unknown -join ', ')" } + return [pscustomobject]@{ Ok = ($why.Count -eq 0); Actual = $actual; Why = ($why -join '; ') } +} + +# ---------------------------------------------------------------- rows + +$declared = Start-NonceListener +$other = Start-NonceListener +# Keep the never-named listener clear of the small port ranges rows declare. +while ([Math]::Abs($other.Port - $declared.Port) -le 4) { + $prev = $other; $other = Start-NonceListener; & $prev.Stop +} +$downPort = Get-FreeLoopbackPort +$D = $declared.Port +$X = "$ExternalAddress/32" +$proxyUrl = "http://127.0.0.1:$D" + +# Allow: targets the request allows. Needs: the capability a binary must have +# to admit the shape (named when it is rejected). Baseline: rejection fails. +# Reject: a rejection-surface row; admission fails, any clean rejection passes. +$Matrix = @( + # On/off (PC: capability matrix, model-3 equivalence) + @{ Id = 'A01'; Area = 'on-off'; Cap = 'all-allow posture'; Needs = '-'; Baseline = $true + Net = $AllowAll; Allow = @('external', 'udp', 'dns', 'declared', 'other'); DnsRequired = $true } + @{ Id = 'A02'; Area = 'on-off'; Cap = 'deny-all (no rules)'; Needs = 'defaultDeny' + Net = (DenyDefault -Allow @()); Allow = @() } + @{ Id = 'A03'; Area = 'on-off'; Cap = 'network omitted (default off)'; Needs = 'defaultDeny' + Net = $null; Allow = @() } + @{ Id = 'A04'; Area = 'on-off'; Cap = 'egress omitted, ingress denied'; Needs = 'defaultDeny' + Net = @{ ingress = $DenyIngress }; Allow = @() } + # L3/L4 egress (PC: egress rules; LXC GA egress matrix) + @{ Id = 'E01'; Area = 'egress'; Cap = 'allow external /32 tcp port'; Needs = 'egressRules' + Net = (DenyDefault -Allow @(Rule -Cidr $X -Protocol tcp -Port $ExternalPort)); Allow = @('external') } + @{ Id = 'E02'; Area = 'egress'; Cap = 'allow any destination tcp port'; Needs = 'egressRules' + Net = (DenyDefault -Allow @(Rule -Protocol tcp -Port $ExternalPort)); Allow = @('external') } + @{ Id = 'E03'; Area = 'egress'; Cap = 'allow 0.0.0.0/0 tcp port'; Needs = 'egressRules' + Net = (DenyDefault -Allow @(Rule -Cidr '0.0.0.0/0' -Protocol tcp -Port $ExternalPort)); Allow = @('external') } + @{ Id = 'E04'; Area = 'egress'; Cap = 'deny rule wins over allow'; Needs = 'egressRules' + Net = (DenyDefault -Allow @(Rule -Cidr '0.0.0.0/0' -Protocol tcp -Port $ExternalPort) ` + -Deny @(Rule -Cidr $X -Protocol tcp -Port $ExternalPort)); Allow = @() } + @{ Id = 'E05'; Area = 'egress'; Cap = 'allow default with allow rules'; Needs = 'egressFiltering' + Net = @{ egress = @{ default = 'allow'; allow = @(Rule -Cidr '192.0.2.0/24') } + ingress = @{ default = 'allow'; hostLoopback = 'allow' } } + Allow = @('external', 'udp', 'declared', 'other') } + @{ Id = 'E06'; Area = 'egress'; Cap = 'except excludes the target'; Needs = 'egressRules' + Net = (DenyDefault -Allow @(Rule -Cidr '0.0.0.0/0' -Except $X -Protocol tcp -Port $ExternalPort)); Allow = @() } + @{ Id = 'E07'; Area = 'egress'; Cap = 'IPv6 destination only'; Needs = 'egressRules' + Net = (DenyDefault -Allow @(Rule -Cidr '2001:db8::/32' -Protocol tcp -Port $ExternalPort)); Allow = @() } + @{ Id = 'E08'; Area = 'egress'; Cap = 'udp/53 to any destination'; Needs = 'egressRules' + Net = (DenyDefault -Allow @(Rule -Cidr '0.0.0.0/0' -Protocol udp -Port 53)); Allow = @('udp') } + @{ Id = 'E09'; Area = 'egress'; Cap = 'icmp only'; Needs = 'egressRules' + Net = (DenyDefault -Allow @(Rule -Cidr '0.0.0.0/0' -Protocol icmp)); Allow = @() } + @{ Id = 'E10'; Area = 'egress'; Cap = 'wrong port'; Needs = 'egressRules' + Net = (DenyDefault -Allow @(Rule -Cidr $X -Protocol tcp -Port ($ExternalPort + 1))); Allow = @() } + @{ Id = 'E11'; Area = 'egress'; Cap = 'port range covering the target'; Needs = 'egressRules' + Net = (DenyDefault -Allow @(Rule -Cidr $X -Protocol tcp -Port ($ExternalPort - 1) -EndPort ($ExternalPort + 1))) + Allow = @('external') } + @{ Id = 'E12'; Area = 'egress'; Cap = 'protocol any to the target'; Needs = 'egressRules' + Net = (DenyDefault -Allow @(Rule -Cidr $X -Protocol any -Port $ExternalPort)); Allow = @('external') } + # Link-local / instance metadata is never reachable, whatever the policy allows. Preferred: + # rejected naming linkLocal (PASS); else admitted with 169.254.169.254:80 blocked. + @{ Id = 'E13'; Area = 'egress'; Cap = 'link-local metadata address never reachable'; Needs = 'egressRules' + Net = (DenyDefault -Allow @(Rule -Cidr '169.254.0.0/16' -Protocol tcp -Port 80)); Allow = @() + LinkLocalJudged = $true; PassOnRejection = 'linkLocal' } + # Host loopback (PC: host loopback). Declared ports only, never all ports. + @{ Id = 'L01'; Area = 'loopback'; Cap = '127.0.0.1/32 exact tcp port'; Needs = 'loopbackPorts' + Net = (DenyDefault -Allow @(Rule -Cidr $Lo -Protocol tcp -Port $D)); Allow = @('declared') } + @{ Id = 'L02'; Area = 'loopback'; Cap = 'declared port, host listener down'; Needs = 'loopbackPorts' + Net = (DenyDefault -Allow @((Rule -Cidr $Lo -Protocol tcp -Port $D), (Rule -Cidr $Lo -Protocol tcp -Port $downPort))) + Allow = @('declared'); DownCode = 'WSA10054' } + @{ Id = 'L03'; Area = 'loopback'; Cap = 'endPort equal to port'; Needs = 'loopbackPorts' + Net = (DenyDefault -Allow @(Rule -Cidr $Lo -Protocol tcp -Port $D -EndPort $D)); Allow = @('declared') } + @{ Id = 'L04'; Area = 'loopback'; Cap = 'small port range'; Needs = 'loopbackPorts' + Net = (DenyDefault -Allow @(Rule -Cidr $Lo -Protocol tcp -Port ($D - 1) -EndPort ($D + 1))); Allow = @('declared') } + @{ Id = 'L05'; Area = 'loopback'; Cap = 'ingress omitted (defaults to deny)'; Needs = 'loopbackPorts' + Net = (DenyDefault -Allow @(Rule -Cidr $Lo -Protocol tcp -Port $D) -Ingress $null); Allow = @('declared') } + @{ Id = 'L06'; Area = 'loopback'; Cap = 'all-ports loopback (no ports)'; Needs = 'hostLoopbackAllPorts' + Net = (DenyDefault -Allow @(Rule -Cidr $Lo -NoPorts)); Allow = @('declared', 'other') } + @{ Id = 'L07'; Area = 'loopback'; Cap = '127.0.0.0/8 tcp port'; Needs = 'egressRules' + Net = (DenyDefault -Allow @(Rule -Cidr '127.0.0.0/8' -Protocol tcp -Port $D)); Allow = @('declared') } + @{ Id = 'L08'; Area = 'loopback'; Cap = '::1/128 only'; Needs = 'ipv6Loopback' + Net = (DenyDefault -Allow @(Rule -Cidr '::1/128' -Protocol tcp -Port $D)); Allow = @() } + @{ Id = 'L09'; Area = 'loopback'; Cap = 'hostLoopback=allow'; Needs = 'hostLoopbackAllPorts' + Net = (DenyDefault -Allow @() -Ingress @{ default = 'deny'; hostLoopback = 'allow' }) + Allow = @('declared', 'other') } + @{ Id = 'L10'; Area = 'loopback'; Cap = 'ingress.default=allow (inbound)'; Needs = 'inboundPath' + Net = (DenyDefault -Allow @(Rule -Cidr $Lo -Protocol tcp -Port $D) -Ingress @{ default = 'allow'; hostLoopback = 'deny' }) + Allow = @('declared'); Note = 'inbound path not probed' } + @{ Id = 'L11'; Area = 'loopback'; Cap = 'egress allow, host loopback denied'; Needs = 'egressFiltering' + Net = @{ egress = @{ default = 'allow' }; ingress = $DenyIngress }; Allow = @('external', 'udp') } + # Bring-your-own proxy (PC: proxy). The proxy is the declared listener. + @{ Id = 'P01'; Area = 'proxy'; Cap = 'networkProxy with all-allow'; Needs = 'runtimeProxy' + Net = $AllowAll; Rc = @{ networkProxy = $proxyUrl }; Allow = @('external', 'udp', 'declared', 'other') } + @{ Id = 'P02'; Area = 'proxy'; Cap = 'networkProxy with its port declared'; Needs = 'loopbackPorts' + Net = (DenyDefault -Allow @(Rule -Cidr $Lo -Protocol tcp -Port $D)); Rc = @{ networkProxy = $proxyUrl } + Allow = @('declared') } + @{ Id = 'P03'; Area = 'proxy'; Cap = 'networkProxy port implied (no rules)'; Needs = 'loopbackPorts' + Net = (DenyDefault -Allow @()); Rc = @{ networkProxy = $proxyUrl }; Allow = @('declared') } + # Rejection surface (PC: rejections). Never admitted on any build. + @{ Id = 'X01'; Area = 'rejection'; Cap = 'legacy network.allowedHosts'; Needs = '-'; Reject = $true + Net = @{ allowedHosts = @('example.com') } } + @{ Id = 'X02'; Area = 'rejection'; Cap = 'legacy network.proxy'; Needs = '-'; Reject = $true + Net = @{ proxy = @{ url = 'http://127.0.0.1:8888' } } } + @{ Id = 'X03'; Area = 'rejection'; Cap = 'malformed CIDR'; Needs = '-'; Reject = $true + Net = (DenyDefault -Allow @(Rule -Cidr '127.0.0.1/33' -Protocol tcp -Port $D)) } + @{ Id = 'X04'; Area = 'rejection'; Cap = 'loopback port 0'; Needs = '-'; Reject = $true + Net = (DenyDefault -Allow @(Rule -Cidr $Lo -Protocol tcp -Port 0)) } +) +if ($Row) { + # powershell.exe -File passes a list as one comma-joined string. + $ids = @($Row | ForEach-Object { $_ -split ',' } | ForEach-Object { $_.Trim() } | Where-Object { $_ }) + $Matrix = @($Matrix | Where-Object { $ids -contains $_.Id }) +} + +$calls = @( + "Test-Tcp 'other' '127.0.0.1' $($other.Port) '$($other.Nonce)'", + "Test-Tcp 'external' '$ExternalAddress' $ExternalPort `$null", + "Test-Tcp 'linklocal' '169.254.169.254' 80 `$null", + "Test-Udp 'udp' '$ExternalAddress' 53", + "Test-Dns 'dns' '$DnsName'", + "Test-Tcp 'down' '127.0.0.1' $downPort `$null", + "Test-Tcp 'declared' '127.0.0.1' $D '$($declared.Nonce)'" +) +$probeScript = $ProbeBody + "`n" + ($calls -join "`n") +$b64 = [Convert]::ToBase64String([Text.Encoding]::Unicode.GetBytes($probeScript)) +$probeCommand = "$env:SystemRoot\System32\WindowsPowerShell\v1.0\powershell.exe -NoProfile -NonInteractive -EncodedCommand $b64" + +Write-Host "Listeners: declared=$D other=$($other.Port) down=$downPort; external=$ExternalAddress`:$ExternalPort" -ForegroundColor DarkGray +try { + foreach ($r in $Matrix) { + $req = New-Request -Network $r.Net -RuntimeConfig $r.Rc -CommandLine $probeCommand + $run = Invoke-WxcRequest -Request $req + if ($run.Killed) { $script:Killed += $r.Id } + $verdicts = @{} + foreach ($m in [regex]::Matches($run.Output, 'PROBE (\S+) (\S+)')) { + $verdicts[$m.Groups[1].Value] = $m.Groups[2].Value + } + $admitted = $verdicts.Count -gt 0 + $tail = (($run.Output -split "`r?`n") | Where-Object { $_.Trim() } | Select-Object -Last 2) -join ' | ' + $crashed = $run.ExitCode -le -1073741824 + $expected = if ($r.Reject) { 'rejected' } else { "admitted with {$($r.Allow -join ',')} or rejected naming network" } + if ($run.Killed) { + Add-Row $r.Id $r.Area $r.Cap $r.Needs $expected "killed after $($SessionTimeoutMs + $KillGraceMs) ms" 'FAIL' $tail + } elseif ($r.Reject) { + if ($admitted) { + Add-Row $r.Id $r.Area $r.Cap $r.Needs $expected 'admitted' 'FAIL' 'a rejection-surface request was admitted' + } elseif ($run.ExitCode -ne 0 -and -not $crashed) { + Add-Row $r.Id $r.Area $r.Cap $r.Needs $expected "rejected (exit $($run.ExitCode))" 'PASS' + } else { + Add-Row $r.Id $r.Area $r.Cap $r.Needs $expected "exit $($run.ExitCode)" 'FAIL' $tail + } + } elseif ($admitted) { + $pv = Get-PostureVerdict -Verdicts $verdicts -Allow $r.Allow -DnsRequired:([bool]$r.DnsRequired) ` + -LinkLocalJudged:([bool]$r.LinkLocalJudged) + $ok = $pv.Ok + $why = $pv.Why + if ($ok -and $r.DownCode -and $verdicts['down'] -ne $r.DownCode) { + $ok = $false; $why = "declared port with no listener must fail with $($r.DownCode)" + } + if ($ok -and $run.ExitCode -ne 0) { $ok = $false; $why = "session exited $($run.ExitCode)" } + $detail = @($why, $r.Note) | Where-Object { $_ } + if (-not $r.DnsRequired) { $detail += "dns=$($verdicts['dns']) (report-only)" } + Add-Row $r.Id $r.Area $r.Cap $r.Needs $expected "admitted: $($pv.Actual)" ` + ($(if ($ok) { 'PASS' } else { 'FAIL' })) ($detail -join '; ') + } elseif (-not $crashed -and $run.ExitCode -ne 0 -and $run.Output -match $NetworkRejection) { + $needs = $r.Needs + if ($run.Output -match "requires platform capability '([A-Za-z]+)'") { $needs = $Matches[1] } + if ($r.Baseline) { + Add-Row $r.Id $r.Area $r.Cap $needs $expected 'rejected' 'FAIL' $tail + } elseif ($r.PassOnRejection -and $needs -eq $r.PassOnRejection -and $needs -ne $r.Needs) { + Add-Row $r.Id $r.Area $r.Cap $needs $expected "rejected ($needs)" 'PASS' + } else { + Add-Row $r.Id $r.Area $r.Cap $needs $expected 'rejected (network)' 'UNSUPPORTED' + } + } else { + Add-Row $r.Id $r.Area $r.Cap $r.Needs $expected "exit $($run.ExitCode), no probe output" 'FAIL' $tail + } + } +} finally { + & $declared.Stop + & $other.Stop +} + +if ($script:Killed.Count -gt 0) { + Add-Row 'G13' 'quiesce' 'killed wxc-exec may leave its agent user' '-' 'no killed wxc-exec' ` + "killed in $($script:Killed -join ',')" 'KNOWN-GAP' 'check for and remove a leftover agent user' +} + +# ---------------------------------------------------------------- summary + +$pass = @($Rows | Where-Object Verdict -eq 'PASS').Count +$fail = @($Rows | Where-Object Verdict -eq 'FAIL').Count +$unsup = @($Rows | Where-Object Verdict -eq 'UNSUPPORTED').Count +$gap = @($Rows | Where-Object Verdict -eq 'KNOWN-GAP').Count +Write-Host "`nSummary: $pass passed, $fail failed, $unsup unsupported, $gap known gaps, $($Rows.Count) rows" -ForegroundColor Cyan +# Harness-parsed summary line ("X/Y passed[, N FAILED]"); UNSUPPORTED and KNOWN-GAP are not failures. +$counted = $pass + $fail +if ($fail -gt 0) { Write-Host "$pass/$counted passed, $fail FAILED ($unsup unsupported, $gap known gaps):" } +else { Write-Host "$pass/$counted passed, $unsup unsupported, $gap known gaps" } +if ($ResultsPath) { + $Rows | ConvertTo-Json -Depth 4 | Set-Content -Path $ResultsPath -Encoding ascii + Write-Host "Results: $ResultsPath" -ForegroundColor Gray +} +if ($fail -gt 0) { exit 1 } +exit 0