209 lines
13 KiB
Python
209 lines
13 KiB
Python
#!/usr/bin/env python3
|
|
"""Read-only LocalService W32Time readiness bootstrap; no RMM jobs.
|
|
|
|
A lost SSH reply is resumed using readback --id, never by repeating start.
|
|
The temporary service is separate from the permanent enrolled Windows agent.
|
|
"""
|
|
import argparse
|
|
import hashlib
|
|
import json
|
|
import os
|
|
from pathlib import Path
|
|
import subprocess
|
|
import sys
|
|
import uuid
|
|
|
|
sys.path.insert(0, str(Path(__file__).resolve().parent))
|
|
import client_bootstrap as cb
|
|
|
|
STATE = cb.EVIDENCE / 'clock-readiness'
|
|
ROOT = r'C:\ProgramData\RustDiscoveryClockReadiness'
|
|
SERVICE = 'RmmWindowsClockReadiness'
|
|
|
|
PREPARE = r'''$ErrorActionPreference='Stop'
|
|
$p=([Console]::In.ReadLine()|ConvertFrom-Json)
|
|
if($p.sha -notmatch '^[a-f0-9]{64}$' -or $p.name -notin @('WindowsClockReadiness.exe','ClockReadiness.ps1')){throw 'Fixed artifact'}
|
|
$root='C:\ProgramData\RustDiscoveryClockReadiness'
|
|
function CheckPrivate($path){
|
|
$acl=Get-Acl -LiteralPath $path;$owner=$acl.GetOwner([Security.Principal.SecurityIdentifier]).Value
|
|
if($owner -notin @('S-1-5-18','S-1-5-32-544') -or $acl.Access.Count -eq 0){throw 'Artifact owner/DACL'}
|
|
foreach($ace in $acl.Access){
|
|
$sid=$ace.IdentityReference.Translate([Security.Principal.SecurityIdentifier]).Value
|
|
if($ace.AccessControlType -ne 'Allow' -or $sid -notin @('S-1-5-18','S-1-5-32-544','S-1-5-19')){throw 'Artifact broad ACL'}
|
|
if($sid -eq 'S-1-5-19' -and ([int64]$ace.FileSystemRights -band (-bnot ([int64][Security.AccessControl.FileSystemRights]::ReadAndExecute -bor [int64][Security.AccessControl.FileSystemRights]::Synchronize)))){throw 'Artifact writable by service account'}
|
|
}
|
|
}
|
|
if(!(Test-Path -LiteralPath $root)){
|
|
New-Item -ItemType Directory -Path $root|Out-Null
|
|
$a=New-Object Security.AccessControl.DirectorySecurity;$a.SetAccessRuleProtection($true,$false)
|
|
foreach($sid in @('S-1-5-18','S-1-5-32-544','S-1-5-19')){
|
|
$rights=if($sid -eq 'S-1-5-19'){'ReadAndExecute'}else{'FullControl'}
|
|
$a.AddAccessRule((New-Object Security.AccessControl.FileSystemAccessRule((New-Object Security.Principal.SecurityIdentifier($sid)),$rights,'ContainerInherit,ObjectInherit','None','Allow')))
|
|
}
|
|
$a.SetOwner((New-Object Security.Principal.SecurityIdentifier('S-1-5-32-544')));Set-Acl -LiteralPath $root -AclObject $a
|
|
}
|
|
if((Get-Item -LiteralPath $root).Attributes -band [IO.FileAttributes]::ReparsePoint){throw 'Root reparse'}
|
|
CheckPrivate $root
|
|
$dir=Join-Path $root $p.sha
|
|
if(!(Test-Path -LiteralPath $dir)){New-Item -ItemType Directory -Path $dir|Out-Null}
|
|
if((Get-Item -LiteralPath $dir).Attributes -band [IO.FileAttributes]::ReparsePoint){throw 'Artifact reparse'}
|
|
CheckPrivate $dir
|
|
$file=Join-Path $dir $p.name
|
|
$exists=Test-Path -LiteralPath $file
|
|
if($exists -and ((Get-Item -LiteralPath $file).Attributes -band [IO.FileAttributes]::ReparsePoint)){throw 'File reparse'}
|
|
if($exists){CheckPrivate $file}
|
|
if($exists -and (Get-FileHash -LiteralPath $file -Algorithm SHA256).Hash.ToLowerInvariant() -cne $p.sha){throw 'Artifact immutable'}
|
|
[pscustomobject]@{exists=$exists;sha=$p.sha}|ConvertTo-Json -Compress
|
|
'''
|
|
|
|
SCRIPT = r'''$ErrorActionPreference='Stop'
|
|
$p=([Console]::In.ReadLine()|ConvertFrom-Json)
|
|
$id=[guid]::ParseExact($p.id,'D').ToString()
|
|
if($id -cne $p.id -or $p.binary -notmatch '^[a-f0-9]{64}$' -or $p.source -notmatch '^[a-f0-9]{64}$' -or $p.action -notin @('start','readback')){throw 'Fixed request'}
|
|
$root='C:\ProgramData\RustDiscoveryClockReadiness';$name='RmmWindowsClockReadiness'
|
|
$case=Join-Path $root $id;$intent=Join-Path $case 'intent.json';$result=Join-Path $case 'result.json'
|
|
$exe=Join-Path (Join-Path $root $p.binary) 'WindowsClockReadiness.exe'
|
|
$source=Join-Path (Join-Path $root $p.source) 'ClockReadiness.ps1'
|
|
foreach($file in @($exe,$source)){
|
|
if((Get-Item -LiteralPath $file).Attributes -band [IO.FileAttributes]::ReparsePoint){throw 'Reparse'}
|
|
}
|
|
if((Get-FileHash -LiteralPath $exe -Algorithm SHA256).Hash.ToLowerInvariant() -cne $p.binary -or (Get-FileHash -LiteralPath $source -Algorithm SHA256).Hash.ToLowerInvariant() -cne $p.source){throw 'Qualified source and binary'}
|
|
$command='"'+$exe+'" --service '+$id
|
|
function PrivateFile($path){
|
|
$a=New-Object Security.AccessControl.FileSecurity;$a.SetAccessRuleProtection($true,$false)
|
|
foreach($sid in @('S-1-5-18','S-1-5-32-544')){$a.AddAccessRule((New-Object Security.AccessControl.FileSystemAccessRule((New-Object Security.Principal.SecurityIdentifier($sid)),'FullControl','Allow')))}
|
|
$a.SetOwner((New-Object Security.Principal.SecurityIdentifier('S-1-5-32-544')));Set-Acl -LiteralPath $path -AclObject $a
|
|
}
|
|
function WriteNew($path,$data){
|
|
$bytes=[Text.Encoding]::UTF8.GetBytes(($data|ConvertTo-Json -Depth 12 -Compress));$f=[IO.File]::Open($path,'CreateNew','Write','None')
|
|
try{$f.Write($bytes,0,$bytes.Length);$f.Flush($true)}finally{$f.Dispose()};PrivateFile $path
|
|
}
|
|
if($p.action -eq 'start'){
|
|
if((Test-Path -LiteralPath $case) -or (Get-Service -Name $name -ErrorAction SilentlyContinue)){throw 'Use retained case readback; never repeat start'}
|
|
New-Item -ItemType Directory -Path $case|Out-Null
|
|
WriteNew $intent ([ordered]@{id=$id;binary=$p.binary;source=$p.source;command=$command;service=$name;no_jobs=$true})
|
|
New-Service -Name $name -BinaryPathName $command -StartupType Manual -Credential (New-Object Management.Automation.PSCredential('NT AUTHORITY\LocalService',(New-Object Security.SecureString)))|Out-Null
|
|
& "$env:WINDIR\System32\sc.exe" sidtype $name unrestricted|Out-Null;if($LASTEXITCODE -ne 0){throw 'Readiness service SID'}
|
|
$sid=(New-Object Security.Principal.NTAccount('NT SERVICE\'+$name)).Translate([Security.Principal.SecurityIdentifier])
|
|
$a=Get-Acl -LiteralPath $case;$a.SetAccessRuleProtection($true,$true)
|
|
$a.AddAccessRule((New-Object Security.AccessControl.FileSystemAccessRule($sid,'ReadAndExecute,Write','ContainerInherit,ObjectInherit','None','Allow')));Set-Acl -LiteralPath $case -AclObject $a
|
|
Start-Service -Name $name
|
|
}
|
|
if(!(Test-Path -LiteralPath $intent)){throw 'Missing durable intent'}
|
|
$i=Get-Content -LiteralPath $intent -Raw|ConvertFrom-Json
|
|
if($i.id -cne $id -or $i.binary -cne $p.binary -or $i.source -cne $p.source -or $i.command -cne $command -or $i.service -cne $name){throw 'Retained intent mismatch'}
|
|
$service=Get-CimInstance Win32_Service -Filter "Name='RmmWindowsClockReadiness'"
|
|
if($service -and ($service.PathName -cne $command -or $service.StartName -notin @('NT AUTHORITY\LocalService','NT AUTHORITY\Local Service'))){throw 'Service owner/configuration mismatch'}
|
|
$deadline=[DateTime]::UtcNow.AddSeconds(25)
|
|
while($service -and $service.State -ne 'Stopped' -and [DateTime]::UtcNow -lt $deadline){Start-Sleep -Milliseconds 250;$service=Get-CimInstance Win32_Service -Filter "Name='RmmWindowsClockReadiness'"}
|
|
if($service -and $service.State -ne 'Stopped'){throw 'Readiness still active; retain case and readback'}
|
|
$token=$null;$tokenPath=Join-Path $case 'token.json'
|
|
if(Test-Path -LiteralPath $tokenPath){
|
|
if((Get-Item -LiteralPath $tokenPath).Length -gt 1024 -or ((Get-Item -LiteralPath $tokenPath).Attributes -band [IO.FileAttributes]::ReparsePoint)){throw 'Token report bound'}
|
|
$token=Get-Content -LiteralPath $tokenPath -Raw|ConvertFrom-Json
|
|
if($token.user_sid -cne 'S-1-5-19' -or $token.administrator_member -ne $false -or $token.system_user -ne $false){throw 'Token report identity'}
|
|
PrivateFile $tokenPath
|
|
}
|
|
$data=$null
|
|
if(Test-Path -LiteralPath $result){
|
|
if((Get-Item -LiteralPath $result).Length -gt 16384 -or ((Get-Item -LiteralPath $result).Attributes -band [IO.FileAttributes]::ReparsePoint)){throw 'Result bound'}
|
|
$data=Get-Content -LiteralPath $result -Raw|ConvertFrom-Json
|
|
if($data.case_id -cne $id -or $data.token_sid -cne 'S-1-5-19' -or $data.token.user_sid -cne 'S-1-5-19' -or $data.token.administrator_member -ne $false -or $data.token.system_user -ne $false -or $data.token.elevation_flag -notin @(0,1) -or $data.token.elevation_type -notin @(1,2,3) -or $data.elevated -ne ($data.token.elevation_flag -ne 0) -or $data.service_name -cne $name -or $data.read_only -ne $true){throw 'Actual LocalService report'}
|
|
PrivateFile $result
|
|
}
|
|
if($service){
|
|
$cleanup=Join-Path $case 'cleanup-intent.json'
|
|
if(!(Test-Path -LiteralPath $cleanup)){WriteNew $cleanup ([ordered]@{id=$id;command=$command;service=$name;remove_only_own_stopped_service=$true})}
|
|
else{$c=Get-Content -LiteralPath $cleanup -Raw|ConvertFrom-Json;if($c.id -cne $id -or $c.command -cne $command -or $c.service -cne $name){throw 'Cleanup intent mismatch'}}
|
|
& "$env:WINDIR\System32\sc.exe" delete $name|Out-Null;if($LASTEXITCODE -ne 0){throw 'Readiness cleanup'}
|
|
}
|
|
[pscustomobject]@{id=$id;native_report=$data;partial_token=$token;service_removed=!(Get-Service -Name $name -ErrorAction SilentlyContinue);service_exit_code=if($service){$service.ExitCode}else{$null};service_specific_exit_code=if($service){$service.ServiceSpecificExitCode}else{$null};no_jobs=$true;no_clock_change=$true;no_agent_change=$true}|ConvertTo-Json -Depth 15 -Compress
|
|
'''
|
|
LAUNCH = r'''$ErrorActionPreference='Stop'
|
|
$p=([Console]::In.ReadLine()|ConvertFrom-Json)
|
|
if($p.source -notmatch '^[a-f0-9]{64}$'){throw 'Source hash'}
|
|
$file='C:\ProgramData\RustDiscoveryClockReadiness\'+$p.source+'\ClockReadiness.ps1'
|
|
if((Get-FileHash -LiteralPath $file -Algorithm SHA256).Hash.ToLowerInvariant() -cne $p.source){throw 'Source changed'}
|
|
$inputJson=$p|ConvertTo-Json -Compress
|
|
$raw=$inputJson|& "$env:WINDIR\System32\WindowsPowerShell\v1.0\powershell.exe" -NoLogo -NoProfile -NonInteractive -ExecutionPolicy RemoteSigned -File $file
|
|
if($LASTEXITCODE -ne 0){throw 'Readiness source failed'}
|
|
$raw
|
|
'''
|
|
|
|
|
|
def save(folder, name, value):
|
|
fd = os.open(folder / name, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600)
|
|
with os.fdopen(fd, 'w') as out:
|
|
json.dump(value, out, indent=2)
|
|
out.flush()
|
|
os.fsync(out.fileno())
|
|
|
|
|
|
def stage(path, name):
|
|
digest = hashlib.sha256(path.read_bytes()).hexdigest()
|
|
value = cb.powershell(PREPARE, dict(sha=digest, name=name))
|
|
if not value['exists']:
|
|
access = cb.contract.protected_json(cb.ROOT / 'credentials/windows-dev-access.json')
|
|
prefix = access['ssh_prefix']
|
|
args = ['sftp'] + [p for p in prefix[1:-1] if p != '-T'] + ['-b', '-', prefix[-1]]
|
|
remote = '/C:/ProgramData/RustDiscoveryClockReadiness/' + digest + '/' + name
|
|
batch = 'put ' + json.dumps(str(path.resolve())) + ' ' + json.dumps(remote) + '\n'
|
|
result = subprocess.run(args, input=batch.encode(), capture_output=True, timeout=120)
|
|
if result.returncode:
|
|
raise RuntimeError('CLOCK_ARTIFACT_UPLOAD_FAILED')
|
|
if not cb.powershell(PREPARE, dict(sha=digest, name=name))['exists']:
|
|
raise RuntimeError('CLOCK_ARTIFACT_READBACK_FAILED')
|
|
return digest
|
|
|
|
|
|
def main():
|
|
parser = argparse.ArgumentParser(description=__doc__)
|
|
parser.add_argument('action', choices=('start', 'readback'))
|
|
parser.add_argument('--binary', type=Path)
|
|
parser.add_argument('--id')
|
|
args = parser.parse_args()
|
|
os.umask(0o077)
|
|
STATE.mkdir(parents=True, exist_ok=True, mode=0o700)
|
|
if args.action == 'start':
|
|
if args.id or not args.binary or not args.binary.is_file():
|
|
raise RuntimeError('NEW_CASE_BINARY_REQUIRED')
|
|
ident = str(uuid.uuid4())
|
|
folder = STATE / ident
|
|
folder.mkdir(mode=0o700)
|
|
source_path = folder / 'ClockReadiness.ps1'
|
|
fd = os.open(source_path, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600)
|
|
with os.fdopen(fd, 'w') as out:
|
|
out.write(SCRIPT)
|
|
intent = dict(id=ident, binary=hashlib.sha256(args.binary.read_bytes()).hexdigest(), source=hashlib.sha256(SCRIPT.encode()).hexdigest(), no_jobs=True)
|
|
save(folder, 'intent.json', intent)
|
|
print('Retained readiness case ' + ident, flush=True)
|
|
stage(args.binary, 'WindowsClockReadiness.exe')
|
|
stage(source_path, 'ClockReadiness.ps1')
|
|
save(folder, 'start-intent.json', dict(**intent, action='start'))
|
|
else:
|
|
if not args.id or args.binary:
|
|
raise RuntimeError('READBACK_SAME_CASE_REQUIRED')
|
|
ident = str(uuid.UUID(args.id))
|
|
folder = STATE / ident
|
|
intent = cb.contract.protected_json(folder / 'intent.json')
|
|
if intent['source'] != hashlib.sha256(SCRIPT.encode()).hexdigest():
|
|
raise RuntimeError('QUALIFIED_SOURCE_CHANGED')
|
|
result = cb.powershell(LAUNCH, dict(**intent, action=args.action), timeout=60)
|
|
save(folder, 'readback-' + str(uuid.uuid4()) + '.json', result)
|
|
report = result['native_report']
|
|
if not result['service_removed'] or not report or len(report['samples']) != 2:
|
|
raise RuntimeError('READINESS_NATIVE_REPORT_INCOMPLETE')
|
|
diagnostic = all(s['trusted'] for s in report['samples'])
|
|
qualified = all(s.get('adapter_qualified') is True for s in report['samples'])
|
|
ready = diagnostic and qualified
|
|
completed = dict(native_execution_verified=True, diagnostic_status_ready=diagnostic, adapter_qualified=qualified, clock_ready=ready, **result)
|
|
if not (folder / 'result.json').exists():
|
|
save(folder, 'result.json', completed)
|
|
elif cb.contract.protected_json(folder / 'result.json')['native_report'] != report:
|
|
raise RuntimeError('IMMUTABLE_NATIVE_REPORT_CHANGED')
|
|
print(json.dumps(dict(id=ident,native_execution_verified=True,diagnostic_status_ready=diagnostic,adapter_qualified=qualified,clock_ready=ready,reasons=[s['reason'] for s in report['samples']],rpc_codes=[s['rpc_code'] for s in report['samples']],token=report.get('token'),service_removed=True,no_jobs=True)))
|
|
|
|
|
|
if __name__ == '__main__':
|
|
main()
|