Enable per-order privileged scripts on managed devices
This commit is contained in:
@@ -8,6 +8,10 @@ fn main() -> anyhow::Result<()> {
|
||||
println!("enrolled-windows-update/1");
|
||||
return Ok(());
|
||||
}
|
||||
if std::env::args().skip(1).eq(["--managed-script-helper-version"]) {
|
||||
println!("managed-script-helper/1");
|
||||
return Ok(());
|
||||
}
|
||||
rmm_agent_windows::helper_system::dispatch()
|
||||
}
|
||||
#[cfg(not(windows))]
|
||||
|
||||
@@ -11,6 +11,10 @@ fn main() -> anyhow::Result<()> {
|
||||
println!("release-job-lock/1");
|
||||
Ok(())
|
||||
}
|
||||
Some(flag) if flag == "--managed-script-helper-version" && args.next().is_none() => {
|
||||
println!("managed-script-helper/1");
|
||||
Ok(())
|
||||
}
|
||||
Some(flag) if flag == "--verify-bootstrap" => {
|
||||
let release = rmm_updater::verify_bootstrap_files(
|
||||
rmm_agent_windows::release_platform::VERIFY,
|
||||
|
||||
@@ -107,10 +107,13 @@ impl Settings {
|
||||
})
|
||||
}
|
||||
pub(crate) fn windows_update_only(&self) -> bool {
|
||||
self.schema_version >= 3 && self.enable_effects && self.windows_update_max_runtime_seconds.is_some()
|
||||
(3..=4).contains(&self.schema_version) && self.enable_effects && self.windows_update_max_runtime_seconds.is_some()
|
||||
&& self.allowed_script_profiles.is_none() && self.allowed_services.is_empty()
|
||||
&& self.allowed_msi_recipe_sha256.is_none() && !self.allow_reboot && self.max_runtime_seconds <= 30
|
||||
}
|
||||
pub(crate) fn managed_scripts(&self) -> bool {
|
||||
self.schema_version == 5
|
||||
}
|
||||
fn permits_script(&self, job: &JobPayload) -> bool {
|
||||
self.schema_version >= 3
|
||||
&& job.execution_identity == "system"
|
||||
@@ -133,7 +136,12 @@ impl Settings {
|
||||
}
|
||||
pub fn validate(&self) -> Result<()> {
|
||||
ensure!(
|
||||
matches!(self.schema_version, 1..=4)
|
||||
matches!(self.schema_version, 1..=5)
|
||||
&& (!self.managed_scripts()
|
||||
|| (self.enable_effects && self.allowed_services.is_empty()
|
||||
&& self.allowed_msi_recipe_sha256.is_none() && !self.allow_reboot
|
||||
&& self.allowed_script_profiles.as_deref()
|
||||
== Some(&[rmm_domain::jobs::PrivilegedScriptProfile::FullMaintenanceV1])))
|
||||
&& (self.schema_version >= 2 || self.allowed_msi_recipe_sha256.is_none())
|
||||
&& (self.schema_version >= 3 || self.allowed_script_profiles.is_none())
|
||||
&& self
|
||||
@@ -891,7 +899,7 @@ impl SystemHelper {
|
||||
let pin = settings.pin()?;
|
||||
ipc::publish_self_query_rights(&settings.agent.service_sid, &settings.helper.service_sid)?;
|
||||
let (guard, db) = LedgerGuard::acquire(&settings.helper.service_sid, &settings.binding)?;
|
||||
let clock = if settings.windows_update_only() {
|
||||
let clock = if settings.windows_update_only() || settings.managed_scripts() {
|
||||
RuntimeClock::enrolled_windows_update_helper(settings.binding.clone(), settings.helper.clone())
|
||||
} else { RuntimeClock::new(rmm_time_attestation::Role::SystemHelper) }.for_generation(0);
|
||||
let boot = WindowsBoot::capture()?;
|
||||
|
||||
@@ -319,10 +319,16 @@ fn local_manifest(installed: &Installed) -> Result<ReleaseManifest> {
|
||||
|
||||
// Only typed release UUIDs enter the fixed SCM command. The actual service path,
|
||||
// LocalService account and absence of an independently provisioned helper are checked again on the target.
|
||||
fn select(from: Uuid, to: Uuid) -> Result<()> {
|
||||
fn select(from: &Installed, to: &Installed) -> Result<()> {
|
||||
let manifest = local_manifest(to)?;
|
||||
let [agent, helper] = manifest.artifacts.as_slice() else {
|
||||
anyhow::bail!("incomplete installed release pair");
|
||||
};
|
||||
let script = include_str!("release_service_switch.ps1")
|
||||
.replace("FROM_UUID", &from.to_string())
|
||||
.replace("TO_UUID", &to.to_string());
|
||||
.replace("FROM_UUID", &from.release_id.to_string())
|
||||
.replace("TO_UUID", &to.release_id.to_string())
|
||||
.replace("SELECTED_AGENT_SHA256", &agent.sha256)
|
||||
.replace("SELECTED_HELPER_SHA256", &helper.sha256);
|
||||
let windows = std::env::var_os("SystemRoot").context("Windows directory")?;
|
||||
let ps = Path::new(&windows).join(r"System32\WindowsPowerShell\v1.0\powershell.exe");
|
||||
let result = Command::new(ps)
|
||||
@@ -338,8 +344,7 @@ fn select(from: Uuid, to: Uuid) -> Result<()> {
|
||||
Ok(())
|
||||
}
|
||||
async fn rollback(t: &Transition) -> Result<()> {
|
||||
local_manifest(&t.old)?;
|
||||
select(t.new.release_id, t.old.release_id)?;
|
||||
select(&t.new, &t.old)?;
|
||||
write_record("rejected-release.json", &t.new)?;
|
||||
fs::remove_file(record_path(INTENT))?;
|
||||
Ok(())
|
||||
@@ -494,7 +499,7 @@ async fn cycle() -> Result<()> {
|
||||
let t = Transition { old: active, new };
|
||||
write_record(INTENT, &t)?;
|
||||
let start = chrono::Utc::now();
|
||||
let selected = select(t.old.release_id, t.new.release_id);
|
||||
let selected = select(&t.old, &t.new);
|
||||
if selected.is_ok() {
|
||||
for _ in 0..18 {
|
||||
if let Ok(h) = device.health().await
|
||||
|
||||
@@ -4,6 +4,31 @@ function Get-Image([string]$Id) {
|
||||
$image = Join-Path ([Environment]::GetFolderPath('ProgramFiles')) ('RustDiscovery\releases\' + $Id + '\rmm-agent-windows.exe')
|
||||
return '"' + $image + '" --service --config "' + $configPath + '"'
|
||||
}
|
||||
function Get-HelperImage([string]$Id) {
|
||||
Join-Path ([Environment]::GetFolderPath('ProgramFiles')) ('RustDiscovery\releases\' + $Id + '\rmm-helper-windows.exe')
|
||||
}
|
||||
function Wait-Stopped([string]$Name) {
|
||||
$control = Get-Service $Name
|
||||
if ($control.Status -ne 'Stopped') {
|
||||
$control.Stop()
|
||||
$control.WaitForStatus('Stopped', [TimeSpan]::FromSeconds(45))
|
||||
}
|
||||
}
|
||||
function Select-Image($Service, [string]$Image) {
|
||||
if ($Service.PathName -cne $Image) {
|
||||
$result = Invoke-CimMethod -InputObject $Service -MethodName Change -Arguments @{PathName=$Image}
|
||||
if ($result.ReturnValue -ne 0) { throw 'SCM path change failed.' }
|
||||
}
|
||||
}
|
||||
function Replace-Pin([string]$Path, [string]$Value) {
|
||||
$temp = "$Path.next-$([Guid]::NewGuid())"
|
||||
try {
|
||||
[IO.File]::WriteAllText($temp, $Value, [Text.UTF8Encoding]::new($false))
|
||||
[IO.File]::Replace($temp, $Path, $null)
|
||||
} finally {
|
||||
if (Test-Path -LiteralPath $temp) { Remove-Item -LiteralPath $temp }
|
||||
}
|
||||
}
|
||||
$configPath = Join-Path ([Environment]::GetFolderPath('CommonApplicationData')) 'RustDiscovery\config.json'
|
||||
$from = Get-Image 'FROM_UUID'
|
||||
$to = Get-Image 'TO_UUID'
|
||||
@@ -13,16 +38,36 @@ if ($config.PSObject.Properties['enable_jobs'] -and $config.enable_jobs) {
|
||||
if (-not $config.PSObject.Properties['localservice_time_policy'] -or
|
||||
$config.localservice_time_policy -cne (Join-Path (Split-Path $configPath) 'job-time.json')) { throw 'Job-enabled pair requires a coordinated helper handoff.' }
|
||||
}
|
||||
$managed = $config.PSObject.Properties['managed_script_helper'] -and $config.managed_script_helper
|
||||
$helper = Get-CimInstance -ClassName Win32_Service -Filter "Name='RmmDiscoverySystemHelper'"
|
||||
if (-not $service -or $service.StartName -ine 'NT AUTHORITY\LocalService' -or
|
||||
$service.PathName -cnotin @($from,$to) -or (Get-Service 'RmmDiscoverySystemHelper' -ErrorAction SilentlyContinue)) { throw 'Unexpected service configuration.' }
|
||||
if ($service.PathName -cne $to) {
|
||||
$control = Get-Service 'RmmDiscoveryWindows'
|
||||
if ($control.Status -ne 'Stopped') {
|
||||
$control.Stop()
|
||||
$control.WaitForStatus('Stopped', [TimeSpan]::FromSeconds(45))
|
||||
}
|
||||
$res = Invoke-CimMethod -InputObject $service -MethodName Change -Arguments @{PathName=$to}
|
||||
if ($res.ReturnValue -ne 0) { throw 'SCM path change failed.' }
|
||||
$service.PathName -cnotin @($from,$to) -or ([bool]$helper -ne [bool]$managed)) { throw 'Unexpected service configuration.' }
|
||||
if ($managed) {
|
||||
$helperExe = Get-HelperImage 'TO_UUID'
|
||||
$helperTo = '"' + $helperExe + '" --service'
|
||||
$helperFrom = '"' + (Get-HelperImage 'FROM_UUID') + '" --service'
|
||||
if ($helper.StartName -ine 'LocalSystem' -or $helper.PathName -cnotin @($helperFrom,$helperTo)) { throw 'Unexpected managed helper service.' }
|
||||
$policyRoot = Join-Path ([Environment]::GetFolderPath('CommonApplicationData')) 'RustDiscoverySystem'
|
||||
$settingsPath = Join-Path $policyRoot 'helper.json'
|
||||
$settings = Get-Content -LiteralPath $settingsPath -Raw | ConvertFrom-Json
|
||||
if ($settings.schema_version -ne 5) { throw 'Managed helper settings required.' }
|
||||
$rendered = ([ordered]@{binding=$settings.binding; release_id='TO_UUID'
|
||||
agent_sha256='SELECTED_AGENT_SHA256'; helper_sha256='SELECTED_HELPER_SHA256'
|
||||
max_runtime_seconds=$settings.windows_update_max_runtime_seconds; managed_scripts=$true} | ConvertTo-Json -Depth 6 -Compress) |
|
||||
& $helperExe --prepare-enrolled-windows-update
|
||||
if ($LASTEXITCODE -ne 0) { throw 'Signed successor helper could not render its pins.' }
|
||||
$pins = $rendered | ConvertFrom-Json
|
||||
Wait-Stopped 'RmmDiscoveryWindows'
|
||||
Wait-Stopped 'RmmDiscoverySystemHelper'
|
||||
Replace-Pin $settingsPath $pins.helper_settings
|
||||
Replace-Pin (Join-Path $policyRoot 'agent-pin.json') $pins.agent_pin
|
||||
Select-Image $helper $helperTo
|
||||
Select-Image $service $to
|
||||
Start-Service 'RmmDiscoverySystemHelper'
|
||||
(Get-Service 'RmmDiscoverySystemHelper').WaitForStatus('Running', [TimeSpan]::FromSeconds(45))
|
||||
} elseif ($service.PathName -cne $to) {
|
||||
Wait-Stopped 'RmmDiscoveryWindows'
|
||||
Select-Image $service $to
|
||||
}
|
||||
$control = Get-Service 'RmmDiscoveryWindows'
|
||||
if ($control.Status -ne 'Running') {
|
||||
|
||||
@@ -40,6 +40,8 @@ struct Config {
|
||||
localservice_time_policy: Option<PathBuf>,
|
||||
#[serde(default)]
|
||||
windows_update_helper: bool,
|
||||
#[serde(default)]
|
||||
managed_script_helper: bool,
|
||||
// Explicit protected opt-in only; this flag never qualifies a clock or pins.
|
||||
#[serde(default)]
|
||||
enable_jobs: bool,
|
||||
@@ -99,7 +101,8 @@ impl Config {
|
||||
fn read(path: &Path) -> Result<Self> {
|
||||
let raw = protected_read(path, 32768)?;
|
||||
let config: Self = serde_json::from_slice(&raw)?;
|
||||
if config.windows_update_helper {
|
||||
ensure!(!(config.windows_update_helper && config.managed_script_helper), "AMBIGUOUS_ENROLLED_HELPER");
|
||||
if config.windows_update_helper || config.managed_script_helper {
|
||||
ensure!(config.localservice_time_policy.is_some() && cfg!(feature = "system-helper"), "ENROLLED_WINDOWS_UPDATE_HELPER_REQUIRED");
|
||||
}
|
||||
if let Some(policy) = &config.localservice_time_policy {
|
||||
@@ -817,7 +820,8 @@ impl Agent {
|
||||
&identity.certificate_pem,
|
||||
&identity.private_key_pem,
|
||||
)?;
|
||||
let helper = if self.config.localservice_time_policy.is_some() && !self.config.windows_update_helper {
|
||||
let helper = if self.config.localservice_time_policy.is_some()
|
||||
&& !self.config.windows_update_helper && !self.config.managed_script_helper {
|
||||
None
|
||||
} else { rmm_agent_windows::helper_runtime::Client::discover(
|
||||
&self.identity.agent_id,
|
||||
@@ -1406,7 +1410,9 @@ impl Agent {
|
||||
}
|
||||
fn supported_job(&self, job: &rmm_domain::jobs::JobPayload) -> bool {
|
||||
if self.config.localservice_time_policy.is_some() && job.execution_identity != "agent_service"
|
||||
&& !(self.config.windows_update_helper && job.execution_identity == "system" && job.action.windows_update_or_identity_probe()) {
|
||||
&& !(job.execution_identity == "system"
|
||||
&& (self.config.windows_update_helper && job.action.windows_update_or_identity_probe()
|
||||
|| self.config.managed_script_helper && job.action.full_maintenance())) {
|
||||
return false;
|
||||
}
|
||||
if self.config.windows_echo_probe_only
|
||||
|
||||
@@ -42,12 +42,21 @@ pub fn qualified(
|
||||
pin.validate()?;
|
||||
let (settings, _handles) = helper_system::read_settings()?;
|
||||
ensure!(serde_json::to_vec(&settings.pin()?)? == serde_json::to_vec(pin)?, "system qualification pin");
|
||||
if settings.windows_update_only() {
|
||||
// The caller has verified an independent helper-role clock and the live
|
||||
// peer. Only the two built-in scripts pass both local and server gates.
|
||||
return Ok(vec!["helper.system.v1".into(), format!("helper.binary.sha256:{}",pin.helper.binary_sha256),
|
||||
format!("helper.policy.sha256:{}",pin.policy_sha256), "system:run_script".into(),
|
||||
rmm_domain::jobs::WINDOWS_UPDATE_LONG_CAPABILITY.into()]);
|
||||
if settings.windows_update_only() || settings.managed_scripts() {
|
||||
// The caller has verified the live enrolled peer and its independent clock.
|
||||
let mut caps = vec![
|
||||
"helper.system.v1".into(),
|
||||
format!("helper.binary.sha256:{}", pin.helper.binary_sha256),
|
||||
format!("helper.policy.sha256:{}", pin.policy_sha256),
|
||||
"system:run_script".into(),
|
||||
];
|
||||
if settings.windows_update_max_runtime_seconds.is_some() {
|
||||
caps.push(rmm_domain::jobs::WINDOWS_UPDATE_LONG_CAPABILITY.into());
|
||||
}
|
||||
if settings.managed_scripts() {
|
||||
caps.push(rmm_domain::jobs::FULL_MAINTENANCE_CAPABILITY.into());
|
||||
}
|
||||
return Ok(caps);
|
||||
}
|
||||
let ordinary = load_ordinary(pin);
|
||||
let (q, result_bytes) = match ordinary {
|
||||
|
||||
@@ -20,6 +20,8 @@ struct Input {
|
||||
agent_sha256: String,
|
||||
helper_sha256: String,
|
||||
max_runtime_seconds: u32,
|
||||
#[serde(default)]
|
||||
managed_scripts: bool,
|
||||
}
|
||||
|
||||
pub fn render() -> Result<()> {
|
||||
@@ -48,7 +50,7 @@ pub fn render() -> Result<()> {
|
||||
})
|
||||
};
|
||||
let settings = Settings {
|
||||
schema_version: 3,
|
||||
schema_version: if data.managed_scripts { 5 } else { 3 },
|
||||
binding: data.binding,
|
||||
agent: role(
|
||||
crate::SERVICE_NAME,
|
||||
@@ -63,11 +65,13 @@ pub fn render() -> Result<()> {
|
||||
data.helper_sha256,
|
||||
)?,
|
||||
allowed_services: vec![],
|
||||
max_runtime_seconds: 30,
|
||||
max_runtime_seconds: if data.managed_scripts { 120 } else { 30 },
|
||||
enable_effects: true,
|
||||
allow_reboot: false,
|
||||
allowed_msi_recipe_sha256: None,
|
||||
allowed_script_profiles: None,
|
||||
allowed_script_profiles: data.managed_scripts.then(|| {
|
||||
vec![rmm_domain::jobs::PrivilegedScriptProfile::FullMaintenanceV1]
|
||||
}),
|
||||
windows_update_max_runtime_seconds: Some(data.max_runtime_seconds),
|
||||
};
|
||||
settings.validate()?;
|
||||
|
||||
Reference in New Issue
Block a user