Files
rust-discovery/deploy/windows/signed_clock_capture_completion_acceptance.py
T
2026-11-15 08:45:38 +01:00

254 lines
17 KiB
Python

#!/usr/bin/env python3
"""Fixed original-case completion/capture operator; no automatic next action.
Each mutation has a create-only local intent. After an uncertain reply use read;
never repeat a mutation or invent its missing reply, exit proof or outcome.
"""
import argparse
import json
from pathlib import Path
import subprocess
import uuid
import signed_clock_capture_acceptance as original
import signed_clock_capture_completion as completion
ROOT = Path(__file__).resolve().parents[2]
FOLDER = ROOT / 'devstate/windows-signed-clock-capture-completion/ccba6d8f-c58f-4d2d-a51c-1efb3bfbabdf'
GENERATOR_SHA = '65dbbd148e4a7d24843167b984c0d3c8ad5a8a065cff7d47dfd5516d9c97cde6'
ORIGINAL_RUNNER_SHA = 'dd6c575a119751429448e40e6f306cf79efa3a86c49bf2cd32a7783937177770'
COMPLETE_SHA = 'a36f318fb549071765bd92aa405c2ea3cf16b3696151afe857c4f601e36f624c'
DELTA_SHA = '2240d7846c82a56e2e13a48bed2c836fae3c836ce89d585c3390540fef76ef14'
ARTIFACTS = (('SignedClockCaptureCompletion.ps1', COMPLETE_SHA, 16673),
('SignedClockCaptureDelta.ps1', DELTA_SHA, 23306))
ACTIONS = ('stage', 'complete', 'read', 'start-local-service', 'start-system',
'cleanup-local-service', 'cleanup-system')
require, save, load = original.require, original.save, original.load
LAUNCH = r'''$ErrorActionPreference='Stop';$p=([Console]::In.ReadLine()|ConvertFrom-Json)
if(!$p-or$p.id-cne'efd17b43-7e04-49a7-9bd4-862d13365eec'){throw 'Fixed original completion case'}
if($p.action-ceq'complete'){
if((($p.PSObject.Properties.Name|Sort-Object)-join',')-cne'action,id,profile,script_sha256'-or$p.profile-cne'rmm.windows.raw-clock.original-completion.v1'-or$p.script_sha256-cne'a36f318fb549071765bd92aa405c2ea3cf16b3696151afe857c4f601e36f624c'){throw 'Fixed completion action'}
$name='SignedClockCaptureCompletion.ps1';$bytes=16673
}else{
if((($p.PSObject.Properties.Name|Sort-Object)-join',')-cne'action,exe_bytes,exe_sha256,id,manifest_sha256,profile,script_sha256'-or$p.action-notin@('read','start-local-service','start-system','cleanup-local-service','cleanup-system')-or$p.profile-cne'rmm.windows.raw-clock.original-delta.v1'-or$p.script_sha256-cne'2240d7846c82a56e2e13a48bed2c836fae3c836ce89d585c3390540fef76ef14'-or$p.exe_sha256-cne'601c27a43fb67c662f926f9dc289a23a5c31c7e27f62901a77fc9ceaafaea7fb'-or$p.exe_bytes-ne8566784-or$p.manifest_sha256-cne'806c062bdd458627cf44ff1ef3f27738e1ebf2f407a96f772223efef267db0b1'){throw 'Fixed delta action'}
$name='SignedClockCaptureDelta.ps1';$bytes=23306
}
$script=Join-Path (Join-Path 'C:\ProgramData\RustDiscoveryBootstrap' $p.script_sha256) $name
$i=Get-Item -LiteralPath $script -Force;if($i.PSIsContainer-or($i.Attributes-band[IO.FileAttributes]::ReparsePoint)-or$i.Length-ne$bytes-or(Get-FileHash -LiteralPath $script -Algorithm SHA256).Hash.ToLowerInvariant()-cne$p.script_sha256){throw 'Exact fixed controller bytes'}
$parent=$i.Directory;while($null-ne$parent){if($parent.Attributes-band[IO.FileAttributes]::ReparsePoint){throw 'No controller reparse ancestry'};$parent=$parent.Parent}
$a=Get-Acl -LiteralPath $script;if($a.GetOwner([Security.Principal.SecurityIdentifier]).Value-notin@('S-1-5-18','S-1-5-32-544')){throw 'Controller owner'};$rules=@($a.GetAccessRules($true,$true,[Security.Principal.SecurityIdentifier]));if(!$rules.Count){throw 'Nonempty controller DACL'};foreach($r in $rules){if($r.AccessControlType-ne'Allow'-or$r.IdentityReference.Value-notin@('S-1-5-18','S-1-5-32-544')){throw 'Private controller DACL'}}
if($p.action-ceq'complete'){$global:RmmCaptureCompletionPayload=$p}else{$global:RmmCaptureDeltaPayload=$p}
& $script
'''
def verify():
require(original.sha(ROOT / 'deploy/windows/signed_clock_capture_acceptance.py') == ORIGINAL_RUNNER_SHA
and original.sha(ROOT / 'deploy/windows/signed_clock_capture_completion.py') == GENERATOR_SHA,
'reviewed original operator and completion generator unchanged')
original.private(FOLDER, True)
manifest = load(FOLDER / 'manifest.json')
require(manifest['original_case'] == completion.CASE and manifest['generator_sha256'] == GENERATOR_SHA
and manifest['original_controller_sha256'] == completion.OLD_SCRIPT_SHA
and manifest['original_manifest_sha256'] == completion.OLD_MANIFEST_SHA
and manifest['completion'] == dict(sha256=COMPLETE_SHA, bytes=16673,
profile=completion.COMPLETE_PROFILE)
and manifest['delta'] == dict(sha256=DELTA_SHA, bytes=23306, profile=completion.DELTA_PROFILE),
'exact reviewed two-controller package')
for name, digest, size in ARTIFACTS:
path = FOLDER / name
original.private(path)
require(path.stat().st_size == size and original.sha(path) == digest, 'original exact controller bytes')
require(original.sha(completion.ORIGINAL / 'manifest.json') == completion.OLD_MANIFEST_SHA
and original.sha(completion.ORIGINAL / 'SignedClockCaptureAcceptance.ps1') == completion.OLD_SCRIPT_SHA
and original.sha(completion.REPAIR / 'repair-reply.json') == completion.REPAIR_REPLY_SHA
and original.sha(completion.REPAIR / 'repair-preservation.json') == completion.REPAIR_PRESERVATION_SHA,
'original failed setup and actual successful stopped SYSTEM repair')
def payload(action):
require(action in ACTIONS and action != 'stage', 'fixed code-selected controller action')
if action == 'complete':
return dict(id=completion.CASE, profile=completion.COMPLETE_PROFILE,
action=action, script_sha256=COMPLETE_SHA)
return dict(id=completion.CASE, profile=completion.DELTA_PROFILE, action=action,
exe_sha256=completion.EXE_SHA, exe_bytes=completion.EXE_BYTES,
manifest_sha256=completion.OLD_MANIFEST_SHA, script_sha256=DELTA_SHA)
def stage(access):
for name, digest, _ in ARTIFACTS:
require(name in ('SignedClockCaptureCompletion.ps1', 'SignedClockCaptureDelta.ps1'),
'only literal two new stage names')
prepare = original.pipe.u.transport.PREPARE_SCRIPT.replace('TransportAcceptance.ps1', name)
observed = access.powershell(prepare, dict(sha256=digest))
if not observed['already_uploaded']:
credentials = original.pipe.cb.contract.protected_json(access.root / 'credentials/windows-dev-access.json')
prefix = credentials['ssh_prefix']
args = ['sftp'] + [part for part in prefix[1:-1] if part != '-T'] + ['-b', '-', prefix[-1]]
target = '/C:/ProgramData/RustDiscoveryBootstrap/' + digest + '/' + name
transferred = subprocess.run(args, input=('put ' + json.dumps(str(FOLDER / name)) + ' '
+ json.dumps(target) + '\n').encode(), capture_output=True, timeout=60)
require(transferred.returncode == 0, 'one exact transfer; uncertain reply means original read only')
observed = access.powershell(prepare, dict(sha256=digest))
require(observed['already_uploaded'] is True and observed['sha256'] == digest,
'immutable staged exact controller')
return dict(staged=True, original_case=completion.CASE,
completion_sha256=COMPLETE_SHA, delta_sha256=DELTA_SHA)
def linked_receipt(path, action):
receipt = load(path)
ident = receipt['operation_id']
if action == 'read':
require(ident.startswith('read-') and str(uuid.UUID(ident[5:])) == ident[5:]
and uuid.UUID(ident[5:]).version == 4, 'canonical unique actual read operation')
else:
require(ident == action, 'exact once-only actual mutation operation')
require(path.parent == FOLDER and path.name == ident + '-receipt.json'
and receipt['original_case'] == completion.CASE and receipt['action'] == action
and receipt['read_only'] is (action == 'read')
and receipt['operator_sha256'] == original.sha(Path(__file__))
and receipt['completion_sha256'] == COMPLETE_SHA and receipt['delta_sha256'] == DELTA_SHA
and receipt['calibrated'] is False and receipt['clock_authority'] is False,
'same original operation/action/operator/controller receipt')
raw = receipt['raw_reply']
require(set(raw) == {'filename', 'sha256'} and raw['filename'] == ident + '-reply.json'
and original.sha(FOLDER / raw['filename']) == raw['sha256'], 'exact original operation raw reply')
binding = {key: receipt[key] for key in ('original_case', 'action', 'read_only', 'operation_id',
'raw_reply', 'operator_sha256', 'completion_sha256', 'delta_sha256')}
witnesses = {}
for field, suffix in (('server_witness', '-server.json'), ('native_witness', '-native.json'),
('preservation', '-preservation.json')):
link = receipt[field]
require(set(link) == {'filename', 'sha256'} and link['filename'] == ident + suffix
and original.sha(FOLDER / link['filename']) == link['sha256'],
'same separately saved operation witness link')
witness = load(FOLDER / link['filename'])
require(all(witness[key] == value for key, value in binding.items()),
'all witness metadata bind same operation/action/read-only/raw reply')
witnesses[field] = witness
server, native, preservation = (witnesses[key] for key in ('server_witness', 'native_witness', 'preservation'))
require(preservation['server_witness'] == receipt['server_witness']
and preservation['native_witness'] == receipt['native_witness']
and server['before'] == server['after'] == preservation['server']
and native['after'] == preservation['native'] and preservation['no_rmm_jobs'] is True
and preservation['calibrated'] is False and preservation['clock_authority'] is False,
'actual complete linked server/native preservation format')
original.preserved(native['before'], native['after'])
return load(FOLDER / raw['filename'])
def completion_proof():
reply = linked_receipt(FOLDER / 'complete-receipt.json', 'complete')
require(reply.get('id') == completion.CASE and reply.get('setup_repair_completed') is True
and reply.get('original_setup_replayed') is False and reply.get('service_actions') is False
and reply.get('calibrated') is False and reply.get('clock_authority') is False,
'actual completed original-case reply; never synthesize missing replies or proof')
def positive_local_service():
# A fresh linked read may establish an actual saved outcome after a lost
# reply. Never manufacture the missing start reply, process proof or exit.
candidates = [FOLDER / 'start-local-service-receipt.json']
candidates += sorted(FOLDER.glob('read-*-receipt.json'), key=lambda path: path.name)
for path in candidates:
if not path.exists():
continue
response = linked_receipt(path, 'start-local-service' if path.name.startswith('start-') else 'read')
value = response.get('roles', {}).get('local-service')
if value is None or value['markers']['outcome'] is None:
continue
original.validate_role('local-service', value, completion.CASE)
return
raise RuntimeError('actual successful LocalService capture and exact kernel exit required before SYSTEM start')
def witnesses(access, baseline):
server, native = original.server_closed(access), original.native_witness(access)
require(server == baseline['server'], 'original closed server counters and policy unchanged')
original.preserved(baseline['native'], native)
return server, native
def run(action):
verify()
access = original.CaptureAccess(original.ACCESS_ROOT)
baseline = load(completion.ORIGINAL / 'baseline.json')
before_server, before_native = witnesses(access, baseline)
ident = 'read-' + str(uuid.uuid4()) if action == 'read' else action
if action != 'read':
if action != 'stage':
staged = load(FOLDER / 'stage-reply.json')
require(staged == dict(staged=True, original_case=completion.CASE,
completion_sha256=COMPLETE_SHA, delta_sha256=DELTA_SHA), 'one completed original stage')
if action in ('start-local-service', 'start-system', 'cleanup-local-service', 'cleanup-system'):
completion_proof()
if action.startswith('start-'):
require(not any(FOLDER.glob('cleanup-*-attempt.json')), 'cleanup began; no new starts')
if action == 'start-system':
positive_local_service()
require(not (FOLDER / (action + '-reply.json')).exists(), 'no completed mutation replay')
save(FOLDER / (action + '-attempt.json'), dict(original_case=completion.CASE, action=action,
once=True, no_retry=True, operator_sha256=original.sha(Path(__file__)),
completion_sha256=COMPLETE_SHA, delta_sha256=DELTA_SHA))
else:
save(FOLDER / (ident + '-intent.json'), dict(original_case=completion.CASE, read_only=True,
operator_sha256=original.sha(Path(__file__)), controller_sha256=DELTA_SHA))
response = stage(access) if action == 'stage' else access.powershell(LAUNCH, payload(action), timeout=90)
raw_path = FOLDER / (ident + '-reply.json')
save(raw_path, response) # Preserve exact canonical raw response before validation or witnesses.
raw_link = dict(filename=raw_path.name, sha256=original.sha(raw_path))
binding = dict(original_case=completion.CASE, action=action, read_only=action == 'read',
operation_id=ident, raw_reply=raw_link, operator_sha256=original.sha(Path(__file__)),
completion_sha256=COMPLETE_SHA, delta_sha256=DELTA_SHA)
after_server, after_native = witnesses(access, baseline)
require(before_server == after_server, 'server preserved throughout action')
original.preserved(before_native, after_native)
server_path, native_path = FOLDER / (ident + '-server.json'), FOLDER / (ident + '-native.json')
save(server_path, dict(binding, before=before_server, after=after_server))
save(native_path, dict(binding, before=before_native, after=after_native))
server_link = dict(filename=server_path.name, sha256=original.sha(server_path))
native_link = dict(filename=native_path.name, sha256=original.sha(native_path))
preservation_path = FOLDER / (ident + '-preservation.json')
save(preservation_path, dict(binding, server=after_server, native=after_native,
server_witness=server_link, native_witness=native_link,
no_rmm_jobs=True, calibrated=False, clock_authority=False))
# No success/complete-role assertion is made before both linked witnesses.
completed = []
if action == 'complete':
require(response.get('id') == completion.CASE and response.get('setup_repair_completed') is True
and response.get('original_setup_replayed') is False and response.get('service_actions') is False,
'only own setup completion; no service action')
if action not in ('stage', 'complete'):
require(response.get('id') == completion.CASE and response.get('calibrated') is False
and response.get('clock_authority') is False, 'same non-authoritative original case response')
if action == 'read':
require(response.get('read_only') is True, 'actual delta read only')
for role, value in response.get('roles', {}).items():
require(role in ('local-service', 'system'), 'fixed own two roles')
if value['markers']['outcome'] is not None:
original.validate_role(role, value, completion.CASE)
completed.append(role)
if action.startswith('start-'):
require(action.removeprefix('start-') in completed, 'actual successful own capture, exact kernel exit')
if action.startswith('cleanup-'):
role = action.removeprefix('cleanup-')
value = response['roles'][role]
require(value['service'] is None and value['markers']['deleted']['service_absent'] is True,
'actual original stopped fixture removal')
receipt_path = FOLDER / (ident + '-receipt.json')
save(receipt_path, dict(binding, server_witness=server_link, native_witness=native_link,
preservation=dict(filename=preservation_path.name, sha256=original.sha(preservation_path)),
completed_roles=sorted(completed), calibrated=False, clock_authority=False))
print(json.dumps(dict(action=action, original_case=completion.CASE,
completed_roles=sorted(completed), receipt_filename=receipt_path.name,
receipt_sha256=original.sha(receipt_path), read_only=action == 'read')))
if __name__ == '__main__':
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument('action', choices=ACTIONS)
run(parser.parse_args().action)