Compare commits

...
3 Commits
Author SHA1 Message Date
kevin_janssen 332c12d70e Open a bounded Windows maintenance window from the operator console
Rust development slice / linux (push) Failing after 7s
2026-11-15 14:23:00 +01:00
kevin_janssen 1934e88896 Merge commit '45b533705dd391afa460bf49fa2181aca7c69053' 2026-11-15 14:22:09 +01:00
kevin_janssen 45b533705d Prepare explicit Windows protected key file fixture test
Rust development slice / linux (push) Failing after 6s
2026-11-15 14:21:16 +01:00
5 changed files with 260 additions and 0 deletions
@@ -703,4 +703,130 @@ mod tests {
}
std::fs::remove_dir_all(directory).unwrap();
}
/// Deliberately selected fixture-only native I/O, never a default elevated
/// operation. Uses the production KeyFiles implementation; no service,
/// account, impersonation, installed state or network operation is involved.
#[cfg(windows)]
#[test]
#[ignore = "explicit Windows administrator fixture; does not prove LocalService execution"]
fn protected_key_files_create_new_reopen_acl_and_hardlink_guards() {
use std::{fs, os::windows::ffi::OsStrExt, ptr};
use windows_sys::Win32::{
Foundation::LocalFree,
Security::{
Authorization::ConvertStringSecurityDescriptorToSecurityDescriptorW,
CheckTokenMembership, CreateWellKnownSid, SECURITY_ATTRIBUTES,
WinBuiltinAdministratorsSid,
},
Storage::FileSystem::CreateDirectoryW,
};
// The current token must already be an administrator. This fixture
// never obtains or substitutes a different principal's token.
let mut admin = [0usize; 16];
let mut length = std::mem::size_of_val(&admin) as u32;
let mut member = 0;
assert!(
unsafe {
CreateWellKnownSid(
WinBuiltinAdministratorsSid,
ptr::null_mut(),
admin.as_mut_ptr().cast(),
&mut length,
)
} != 0
);
assert!(
unsafe {
CheckTokenMembership(ptr::null_mut(), admin.as_mut_ptr().cast(), &mut member)
} != 0
&& member == 1
);
let service_sid = crate::native::service_sid().unwrap();
let create_directory = |path: &std::path::Path, broad: bool| {
let sddl = format!(
"O:BAG:BAD:P(A;OICI;FA;;;SY)(A;OICI;FA;;;BA)(A;OICI;FA;;;{service_sid}){}",
if broad { "(A;OICI;FR;;;BU)" } else { "" }
);
let sddl: Vec<u16> = sddl.encode_utf16().chain(Some(0)).collect();
let mut descriptor = ptr::null_mut();
assert!(
unsafe {
ConvertStringSecurityDescriptorToSecurityDescriptorW(
sddl.as_ptr(),
1,
&mut descriptor,
ptr::null_mut(),
)
} != 0
);
let wide: Vec<u16> = path.as_os_str().encode_wide().chain(Some(0)).collect();
let attributes = SECURITY_ATTRIBUTES {
nLength: std::mem::size_of::<SECURITY_ATTRIBUTES>() as u32,
lpSecurityDescriptor: descriptor,
bInheritHandle: 0,
};
let created = unsafe { CreateDirectoryW(wide.as_ptr(), &attributes) };
unsafe {
LocalFree(descriptor.cast());
}
assert!(created != 0, "fresh protected fixture directory required");
};
let root =
std::env::temp_dir().join(format!("rmm-protected-key-fixture-{}", Uuid::new_v4()));
create_directory(&root, false);
// On failure retain this isolated case for the operator to inspect;
// successful cleanup addresses only this newly created fixed namespace.
let files = ProtectedKeyFiles::open(&root).unwrap();
// A broad ACL is tested only on an empty, separate fixture directory;
// no private key is ever written there.
let broad = root.join("broad-empty");
create_directory(&broad, true);
let denied = match ProtectedKeyFiles::open(&broad) {
Err(error) => error,
Ok(_) => panic!("broad fixture DACL must be refused"),
};
assert_eq!(denied.to_string(), "PRIVATE_PATH_BROAD_ACL");
fs::remove_dir(broad).unwrap();
let version = Uuid::new_v4();
let key = KeyPair::generate().unwrap();
let pem = key.serialize_pem();
files.create(version, pem.as_bytes()).unwrap();
let path = root.join(format!("device-{version}.key"));
crate::native::private_path(&path, false).unwrap();
let read = files.read(version).unwrap();
// Never put private key bytes into assert_eq's panic formatter.
assert!(read == pem.as_bytes(), "private key bytes changed");
let parsed = KeyPair::from_pem(std::str::from_utf8(&read).unwrap()).unwrap();
use sha2::{Digest, Sha256};
assert_eq!(
Sha256::digest(parsed.public_key_raw()),
Sha256::digest(key.public_key_raw())
);
let duplicate = files
.create(version, b"must not replace the key")
.unwrap_err();
assert_eq!(
duplicate.downcast_ref::<std::io::Error>().unwrap().kind(),
std::io::ErrorKind::AlreadyExists
);
assert!(files.read(version).unwrap() == pem.as_bytes());
// The actual held directory handle must prevent rename while in use.
assert!(fs::rename(&root, root.with_extension("renamed")).is_err());
drop(files);
let files = ProtectedKeyFiles::open(&root).unwrap();
assert!(files.read(version).unwrap() == pem.as_bytes());
let link = root.join("own-fixture-hardlink");
fs::hard_link(&path, &link).unwrap();
let denied = match files.read(version) {
Err(error) => error,
Ok(_) => panic!("hardlinked private key must be refused"),
};
assert_eq!(denied.to_string(), "ROTATION_FILE_TYPE_OR_LINKS");
fs::remove_file(link).unwrap();
assert!(files.read(version).unwrap() == pem.as_bytes());
drop(files);
fs::remove_file(path).unwrap();
fs::remove_dir(root).unwrap();
}
}
@@ -0,0 +1,71 @@
#requires -Version 5.1
#requires -RunAsAdministrator
[CmdletBinding()]
param(
[Parameter(Mandatory)][DateTimeOffset]$PreviousExpiry,
[Parameter(Mandatory)][DateTimeOffset]$Until
)
$ErrorActionPreference = 'Stop'
$utcNow = [DateTimeOffset]::UtcNow
if ($PreviousExpiry -ge $utcNow -or $Until -le $utcNow -or $Until -gt $utcNow.AddHours(4)) {
throw 'Expected an expired previous window and a new deadline within four hours.'
}
$dir = 'C:\ProgramData\RmmDevAccess'
$configPath = Join-Path $dir 'bootstrap-public.json'
$raw = [IO.File]::ReadAllText($configPath)
$cfg = $raw | ConvertFrom-Json
$user = Get-LocalUser -Name 'rmm-dev'
$task = Get-ScheduledTask -TaskPath '\' -TaskName 'RmmDevReverseTunnel'
if ($task.State -ne 'Ready' -or !$user.Enabled -or !$user.AccountExpires -or
$user.AccountExpires.ToUniversalTime() -ne $PreviousExpiry.UtcDateTime -or
[DateTimeOffset]::Parse($cfg.expires_at) -ne $PreviousExpiry -or
$cfg.server -cne 'discovery.ease-technologies.de' -or (Get-Service sshd).Status -ne 'Running') {
throw 'Unexpected account, task, server or previous expiry.'
}
$pinned = (Get-Content -LiteralPath (Join-Path $dir 'known_hosts') -Raw).Trim()
if ($pinned -cne ('discovery.ease-technologies.de ' + $cfg.server_host_key)) {
throw 'Unexpected SSH host pin.'
}
$listeners = @(Get-NetTCPConnection -State Listen -LocalPort 22222)
if ($listeners.Count -ne 1 -or $listeners[0].LocalAddress -ne '127.0.0.1') {
throw 'Expected only the original loopback SSH listener.'
}
$backup = Join-Path $dir ('console-window-' + [guid]::NewGuid().ToString() + '.bak')
$candidate = $backup + '.new'
$cfg.expires_at = $Until.ToUniversalTime().ToString('yyyy-MM-ddTHH:mm:sszzz')
[IO.File]::WriteAllText($candidate, ($cfg | ConvertTo-Json -Compress), (New-Object Text.UTF8Encoding($false)))
$sshArgs = @('-F','NUL','-N','-T','-o','BatchMode=yes','-o','IdentitiesOnly=yes',
'-o','ForwardAgent=no','-o','StrictHostKeyChecking=yes','-o','GlobalKnownHostsFile=NUL',
'-o',('UserKnownHostsFile=' + $dir + '\known_hosts'),'-o','ExitOnForwardFailure=yes',
'-o','ConnectTimeout=10','-o','ServerAliveInterval=15','-o','ServerAliveCountMax=2',
'-i',($dir + '\tunnel_ed25519'),'-R','127.0.0.1:22240:127.0.0.1:22222',
'rmm-win-tunnel@discovery.ease-technologies.de')
$ssh = $null
$disabled = $false
$accountChanged = $false
try {
Disable-ScheduledTask -InputObject $task | Out-Null
$disabled = $true
if ((Get-ScheduledTask -TaskPath '\' -TaskName $task.TaskName).State -ne 'Disabled' -or
[IO.File]::ReadAllText($configPath) -cne $raw) { throw 'Existing bootstrap changed.' }
[IO.File]::Replace($candidate, $configPath, $backup)
Set-LocalUser -SID $user.SID -AccountExpires $Until.LocalDateTime
$accountChanged = $true
if ((Get-LocalUser -SID $user.SID).AccountExpires.ToUniversalTime() -ne $Until.UtcDateTime) {
throw 'Unexpected account expiry after renewal.'
}
$ssh = Start-Process -FilePath "$env:WINDIR\System32\OpenSSH\ssh.exe" -ArgumentList $sshArgs -PassThru -NoNewWindow
if ($ssh.WaitForExit(1500)) { throw "SSH exited with code $($ssh.ExitCode)." }
Write-Host "Tunnelfenster gestartet bis $($Until.LocalDateTime). Zum Beenden Strg+C druecken."
while ([DateTimeOffset]::UtcNow -lt $Until) {
if ($ssh.WaitForExit(500)) { throw "SSH exited with code $($ssh.ExitCode)." }
}
} finally {
if ($null -ne $ssh) {
try { if (!$ssh.HasExited) { $ssh.Kill(); $ssh.WaitForExit() } } finally { $ssh.Dispose() }
}
if ($accountChanged) { Set-LocalUser -SID $user.SID -AccountExpires $PreviousExpiry.LocalDateTime }
if (Test-Path -LiteralPath $backup) { [IO.File]::Replace($backup, $configPath, ($backup + '.closed')) }
if ($disabled -and [IO.File]::ReadAllText($configPath) -ceq $raw) { Enable-ScheduledTask -InputObject $task | Out-Null }
if (Test-Path -LiteralPath $candidate) { Remove-Item -LiteralPath $candidate }
}
+8
View File
@@ -27,6 +27,14 @@ Nur portable Logik mit synthetischen KeyFiles, keine echte TLS-Rotation oder
LocalService-Keydateiabnahme. Originalfehler und genaue Grenzen bleiben im
verlinkten Bericht erhalten.
Zusätzlich vorbereitet, noch nicht nativ ausgeführt: eine ausdrücklich
auszuwählende Windows-Keydatei-Unit im bestehenden Lib-Testbinary. Sie prüft
geschütztes CreateNew/Flush/Reopen, öffentlichen Keyhash, Nichtüberschreiben,
breite DACL an leerer Fixture, gehaltenes Verzeichnis und Hardlinkablehnung.
Keine Dienste/Accounts/Tokenübernahme oder permanente Dateien betroffen.
Produktcode unverändert; ein Administratorlauf ersetzt keinen LocalService-
Nachweis. Default-`ignored` ist hier ein ausdrücklich offenes natives Gate.
## Windowsfortsetzung: Nichtstart-Kern nativ qualifiziert — 2026-11-14
Der zusätzliche enge deny-only Nichtstart-Kern ist implementiert und mit
+35
View File
@@ -128,3 +128,38 @@ Die Dateiflags folgen [CreateFileW](https://learn.microsoft.com/en-us/windows/wi
und [FlushFileBuffers](https://learn.microsoft.com/en-us/windows/win32/api/fileapi/nf-fileapi-flushfilebuffers);
der öffentliche Selektor übernimmt den vorhandenen
[SQLite-WAL/FULL-Vertrag](https://www.sqlite.org/pragma.html#pragma_synchronous).
Eine weitere enge native Datei-I/O-Unit ist **vorbereitet, nicht ausgeführt**:
`certificate_rotation::tests::protected_key_files_create_new_reopen_acl_and_hardlink_guards`.
Sie steckt im vorhandenen Lib-Testbinary; kein zusätzliches Diagnostikbinary,
keine Tokenübernahme, Impersonation, Dienste oder Accounts. Wegen ihrer
expliziten Administrator-/Dateisystemwirkung ist sie im Defaultlauf als
`ignored` markiert und muss separat mit `--ignored --exact` ausgewählt werden.
Dies ist ein offenes natives Gate und wird nicht als bestandener Test gezählt.
Die Unit verlangt bereits vorhandene Administratorrechte und die vorhandene
Agent-Service-SID, erstellt ausschließlich einen eigenen zufälligen Unterordner
im temporären Verzeichnis mit expliziter SYSTEM-/Administratoren-/Agent-SID-DACL
und nutzt darin den unveränderten `ProtectedKeyFiles`-Produktpfad. Sie prüft
CreateNew/Flush, die wirkliche geerbte DACL, bytegleiche Wiederöffnung samt
öffentlichem P-256-Keyhash, verweigertes Überschreiben, verweigertes Umbenennen
des gehaltenen Verzeichnisses und Hardlinkablehnung. Eine zu breite DACL wird
nur an einer separaten **leeren** eigenen Verzeichnisfixture geprüft.
Private Schlüsselbytes stehen weder in stdout noch in Assert-Debugausgaben.
Bei Erfolg entfernt sie ausschließlich ihre eigenen Fixturedateien und das
leere eigene Verzeichnis; ein Fehler lässt den isolierten Fall erhalten.
Das belegt nach einem zukünftigen tatsächlichen Lauf nur Datei-I/O des bereits
vorhandenen Administratorprincipals und die geprüfte Service-SID-DACL. Die
produktive Ownerprüfung bleibt vollständig bestehen; ein unzulässiger
Dateieigentümer wird weiterhin verweigert. Tatsächliche LocalService-Erzeugung,
Wiederöffnung und erneutes Öffnen nach Prozessabbruch sind damit weiterhin
nicht nachgewiesen. Es wurde kein konkreter Produkt-I/O-Fehler nachgewiesen,
also kein Produktguard dafür verändert. Der Controller-/Dienstupgradeumfang
und die permanente Identität bleiben unberührt.
Für diesen vorbereiteten Testschnitt tatsächlich lokal: Linux23/23 ohne
Filter, Windows-GNU-Lib `--no-run`, Windows-Alltargets-Clippy mit
`system-helper`/`-D warnings` und Workspacefmt bestanden. Noch kein neuer
Zielaufruf. Das vorbereitete Windows-Testbinary hat SHA256
`cd385c3b8696303220d8e601768d70ac96a6e4187a14cbac9d511162a57eee5a`.
+20
View File
@@ -260,3 +260,23 @@ Ausgabe und expliziten Root-/SYSTEM-Ausführungsrechten gelegt. Paketabnahmen
sind nachgeordnet. Der erneuerte SSH-Bootstrapzugang verleiht selbst keine
RMM-Ausführungsrechte und ersetzt keine dieser noch separat nachzuweisenden
Genehmigungs- und Ausführungsgrenzen.
## Manuelles Wartungsfenster am 15. November 2026
Der Server bestätigte die abgelaufene Freigabe vom 15. November um 13:05:58 UTC.
Für die Windows-Entwicklung wurde die Frist desselben Forwarding-Schlüssels auf
15:30:00 UTC (16:30 Uhr MEZ) gesetzt. Ein separater SSH-Lesezugriff bestätigte
Frist, Hostpin, Schlüsselbindung, SSH-Profil und Konto. Der Port ist serverseitig
an Loopback gebunden. Ein einmaliger, aktiver Servertimer für 15:30:00 UTC
begrenzt auch eine noch offene Weiterleitung des dedizierten Tunnelkontos dieser
Schlüsselgeneration. Das tatsächliche Auslösen des Timers steht noch aus.
Die Bedienperson öffnet das Fenster in der VM-Konsole mit
`deploy/windows/Open-ConsoleMaintenanceWindow.ps1`; Parameter sind
`-PreviousExpiry '2026-11-15T13:05:58+00:00' -Until '2026-11-15T15:30:00+00:00'`.
Während der einmaligen SSH-Verbindung pausiert das Skript den vorhandenen
Autostarttask. Bei normalem Ende oder Strg+C beendet es den Client und stellt die
vorherigen Fristen und den Task wieder her. Bei hartem Abbruch oder VM-Ausfall
den Zustand über die Konsole prüfen. Lokales PowerShell-Parsing bestanden.
VM-Ausführung, SSH-Readback und Dienstwechsel stehen bei Veröffentlichung aus.
Die WebUI-Freigabe für Agentjobs gilt weiterhin.