213 lines
12 KiB
Python
213 lines
12 KiB
Python
"""Retry coverage for the HTTPS Linux bootstrap without installing on the test host."""
|
|
from contextlib import ExitStack, redirect_stdout
|
|
from importlib.util import module_from_spec, spec_from_file_location
|
|
import io
|
|
import json
|
|
import sqlite3
|
|
from pathlib import Path
|
|
import tempfile
|
|
from types import SimpleNamespace
|
|
import subprocess
|
|
import unittest
|
|
from unittest.mock import patch
|
|
|
|
src = Path(__file__).resolve().parents[1] / 'crates/server/src/bootstrap/lifecycle.py'
|
|
spec = spec_from_file_location('rmm_bootstrap_lifecycle', src)
|
|
lifecycle = module_from_spec(spec)
|
|
spec.loader.exec_module(lifecycle)
|
|
|
|
|
|
class EnrollmentRetry(unittest.TestCase):
|
|
def setUp(self):
|
|
self.stack = ExitStack()
|
|
self.addCleanup(self.stack.close)
|
|
folder = Path(self.stack.enter_context(tempfile.TemporaryDirectory()))
|
|
self.base = 'https://bootstrap.example'
|
|
self.tenant = '11111111-1111-4111-8111-111111111111'
|
|
root = folder / 'application'
|
|
(root / 'current').mkdir(parents=True)
|
|
(root / 'config.json').write_text(json.dumps({'bootstrap': self.base, 'tenant': self.tenant}))
|
|
(root / 'current/manifest.json').write_text('{"version":"1.0"}')
|
|
(root / 'lifecycle.py').write_bytes(b'previous installer')
|
|
(root / 'release.lock').touch()
|
|
self.state = folder / 'device'
|
|
self.state.mkdir()
|
|
for field, value in [('ROOT',root),('STATE',self.state)]:
|
|
self.stack.enter_context(patch.object(lifecycle,field,value))
|
|
self.enable = self.stack.enter_context(patch.object(lifecycle,'enable'))
|
|
self.provision = self.stack.enter_context(patch.object(lifecycle,'provision_scripts'))
|
|
self.service = self.stack.enter_context(patch.object(lifecycle,'service'))
|
|
self.healthy = self.stack.enter_context(patch.object(lifecycle,'healthy',return_value=True))
|
|
self.save = self.stack.enter_context(patch.object(lifecycle,'save_token'))
|
|
self.stack.enter_context(patch.object(lifecycle.pwd,'getpwnam'))
|
|
self.token = folder / 'retry.token'
|
|
self.token.write_text('0' * 64)
|
|
|
|
def test_unresolved_effects_delay_release_without_blocking_closed_jobs(self):
|
|
with sqlite3.connect(self.state / 'journal.sqlite') as db:
|
|
db.execute('CREATE TABLE job_attempts (state TEXT)')
|
|
for state, expected in [('running','busy'), ('unknown','busy'), ('awaiting_reboot','busy'),
|
|
('closed_unknown','idle'), ('accepted','idle'), ('succeeded','idle')]:
|
|
with self.subTest(state=state):
|
|
db.execute('DELETE FROM job_attempts')
|
|
db.execute('INSERT INTO job_attempts VALUES(?)', (state,))
|
|
db.commit()
|
|
with redirect_stdout(io.StringIO()) as output:
|
|
lifecycle.device_idle()
|
|
self.assertEqual(output.getvalue().strip(), expected)
|
|
|
|
def bootstrap_tenant(self, tenant):
|
|
def answer(source, route, target):
|
|
self.assertEqual(source, (self.base,'0' * 64))
|
|
target.write_text(json.dumps({'tenant_id': tenant}))
|
|
return self.stack.enter_context(patch.object(lifecycle,'remote',side_effect=answer))
|
|
|
|
def test_completed_enrollment_keeps_identity_and_needs_no_token(self):
|
|
identity = self.state / 'identity.json'
|
|
identity.write_text('{"agent_id":"original"}')
|
|
remote = self.bootstrap_tenant(self.tenant)
|
|
lifecycle.install(self.base,None)
|
|
self.assertEqual(identity.read_text(), '{"agent_id":"original"}')
|
|
self.assertEqual((lifecycle.ROOT / 'lifecycle.py').read_bytes(), src.read_bytes())
|
|
remote.assert_not_called()
|
|
self.save.assert_not_called()
|
|
self.enable.assert_called_once()
|
|
self.provision.assert_called_once_with(False)
|
|
|
|
def test_expired_initial_token_can_be_replaced_in_same_tenant(self):
|
|
self.bootstrap_tenant(self.tenant)
|
|
lifecycle.install(self.base,self.token)
|
|
self.save.assert_called_once()
|
|
self.healthy.assert_called_once_with('1.0',0)
|
|
|
|
def test_timer_starts_only_after_confirmed_first_connection(self):
|
|
self.bootstrap_tenant(self.tenant)
|
|
self.healthy.return_value = False
|
|
with self.assertRaisesRegex(ValueError, 'awaiting authenticated device heartbeat'):
|
|
lifecycle.install(self.base,self.token)
|
|
self.enable.assert_called_once()
|
|
self.service.assert_not_called()
|
|
self.provision.assert_not_called()
|
|
self.healthy.return_value = True
|
|
lifecycle.install(self.base,self.token,enable_admin_scripts=True)
|
|
self.provision.assert_called_once_with(True)
|
|
self.service.assert_called_once_with('enable','--now',lifecycle.TIMER)
|
|
|
|
def test_token_for_another_tenant_cannot_replace_initial_token(self):
|
|
self.bootstrap_tenant('22222222-2222-4222-8222-222222222222')
|
|
with self.assertRaisesRegex(ValueError,'different enrollment tenant'):
|
|
lifecycle.install(self.base,self.token)
|
|
self.save.assert_not_called()
|
|
self.enable.assert_not_called()
|
|
self.assertEqual((lifecycle.ROOT / 'lifecycle.py').read_bytes(), b'previous installer')
|
|
|
|
|
|
class ScriptHelperInstallation(unittest.TestCase):
|
|
def setUp(self):
|
|
self.stack = ExitStack()
|
|
self.addCleanup(self.stack.close)
|
|
base = Path(self.stack.enter_context(tempfile.TemporaryDirectory()))
|
|
self.root = base / 'client'
|
|
self.units = base / 'units'
|
|
self.old = base / 'old-config'
|
|
self.units.mkdir()
|
|
self.uid = SimpleNamespace(pw_uid=990,pw_gid=990)
|
|
self.release = '11111111-1111-4111-8111-111111111111'
|
|
self.previous = '22222222-2222-4222-8222-222222222222'
|
|
self.folder = self.root / 'releases' / self.release
|
|
self.folder.mkdir(parents=True)
|
|
self.manifest = {'release_id': self.release, 'version': 'v2', 'artifacts':[{'role':'helper','sha256':'a'*64}]}
|
|
self.binding = {'tenant_id':self.previous, 'agent_id':self.release, 'public_key_hex':'f'*64}
|
|
self.pin = {'helper_binary_sha256':'a'*64,'policy_sha256':'b'*64}
|
|
lifecycle.save(self.folder / 'manifest.json', self.manifest)
|
|
(self.root / 'release.lock').touch()
|
|
for field, value in [('ROOT',self.root),('UNIT_DIR',self.units),('OLD_HELPER_CONFIG',self.old)]:
|
|
self.stack.enter_context(patch.object(lifecycle,field,value))
|
|
lifecycle.link(self.root, self.release)
|
|
self.unit = self.units / lifecycle.HELPER
|
|
self.service = self.stack.enter_context(patch.object(lifecycle,'service'))
|
|
self.state = self.stack.enter_context(patch.object(lifecycle,'helper_state',return_value='not-found'))
|
|
|
|
def legacy(self, enabled=True):
|
|
self.old.mkdir()
|
|
settings = lifecycle.script_settings(self.binding,self.uid,'c'*64)
|
|
settings['allow_root_scripts'] = enabled
|
|
lifecycle.save(self.old / 'helper.json',settings)
|
|
legacy_image = self.root / 'releases' / self.previous / 'helper'
|
|
self.unit.write_bytes(lifecycle.helper_unit(legacy_image,self.old / 'helper.json'))
|
|
|
|
def test_no_unit_or_explicitly_disabled_local_policy_stays_service_only(self):
|
|
for state, opt_in in [('not-found',False), ('masked',True), ('disabled',True)]:
|
|
with self.subTest(state=state):
|
|
self.state.return_value = state
|
|
lifecycle.provision_scripts(opt_in)
|
|
self.service.assert_not_called()
|
|
self.assertFalse((self.folder / 'script-helper.json').exists())
|
|
|
|
def test_legacy_predecessor_migrates_only_for_exact_authorized_profile(self):
|
|
self.legacy(enabled=False)
|
|
with self.assertRaisesRegex(ValueError,'different binding or profile'):
|
|
lifecycle.helper_unit_files(self.binding,self.uid)
|
|
settings = lifecycle.read(self.old / 'helper.json')
|
|
settings['allow_root_scripts'] = True
|
|
lifecycle.save(self.old / 'helper.json',settings)
|
|
with self.assertRaisesRegex(ValueError,'different binding or profile'):
|
|
lifecycle.helper_unit_files(dict(self.binding, public_key_hex='0'*64),self.uid)
|
|
files = dict(lifecycle.helper_unit_files(self.binding,self.uid))
|
|
self.assertIn(b'lifecycle.py run-helper',files[self.unit])
|
|
self.assertIn(str(self.previous).encode(),self.unit.read_bytes())
|
|
|
|
def test_service_environment_cannot_replace_restrictive_operator_pin_or_claim_a_release(self):
|
|
lifecycle.save(self.root / 'config.json', {'gateway':'https://127.0.0.1','tenant':self.previous})
|
|
lifecycle.save(self.folder / 'script-pin.json',self.pin)
|
|
self.state.return_value = 'enabled'
|
|
environment = {'RMM_FULL_MAINTENANCE_POLICY_FILE':'/etc/site/restricted.json',
|
|
'RMM_SCRIPT_HELPER_RELEASE':self.previous}
|
|
with patch.dict(lifecycle.os.environ,environment,clear=True), patch.object(lifecycle.os,'execv'):
|
|
lifecycle.run_agent()
|
|
self.assertEqual(lifecycle.os.environ['RMM_FULL_MAINTENANCE_POLICY_FILE'],'/etc/site/restricted.json')
|
|
self.assertNotIn('RMM_SCRIPT_HELPER_RELEASE',lifecycle.os.environ)
|
|
with patch.dict(lifecycle.os.environ,{},clear=True), patch.object(lifecycle.os,'execv'):
|
|
lifecycle.run_agent()
|
|
self.assertEqual(lifecycle.os.environ['RMM_SCRIPT_HELPER_RELEASE'],self.release)
|
|
|
|
def test_rejected_pair_does_not_run_candidate_and_altered_policy_stays_intact(self):
|
|
with patch.object(lifecycle.subprocess,'check_output',side_effect=subprocess.CalledProcessError(1,'verify')) as run:
|
|
with self.assertRaises(subprocess.CalledProcessError):
|
|
lifecycle.prepare_script_helper(self.folder,self.binding,self.uid)
|
|
self.assertEqual(run.call_count,1)
|
|
config = self.folder / 'script-helper.json'
|
|
self.assertFalse(config.exists())
|
|
with patch.object(lifecycle.subprocess,'check_output',side_effect=[json.dumps(self.manifest),json.dumps(self.pin).encode()]):
|
|
self.assertEqual(lifecycle.prepare_script_helper(self.folder,self.binding,self.uid),self.pin)
|
|
settings = lifecycle.read(config)
|
|
settings['allow_root_scripts'] = False
|
|
lifecycle.save(config,settings)
|
|
with patch.object(lifecycle.subprocess,'check_output',return_value=json.dumps(self.manifest)) as run:
|
|
with self.assertRaisesRegex(ValueError,'binding changed'):
|
|
lifecycle.prepare_script_helper(self.folder,self.binding,self.uid)
|
|
self.assertEqual(run.call_count,1)
|
|
self.assertEqual(lifecycle.read(config),settings)
|
|
|
|
def test_rollback_selects_previous_pair_and_keeps_pending_until_confirmed(self):
|
|
self.state.return_value = 'enabled'
|
|
previous = self.root / 'releases' / self.previous
|
|
previous.mkdir()
|
|
lifecycle.save(previous / 'manifest.json',dict(self.manifest,release_id=self.previous,version='v1'))
|
|
lifecycle.save(previous / 'script-pin.json',self.pin)
|
|
pending = self.root / 'pending.json'
|
|
intent = {'previous':self.previous,'sequence':2,'script_helper':True}
|
|
lifecycle.save(pending,intent)
|
|
with patch.object(lifecycle,'start_pair') as start, patch.object(lifecycle,'healthy',side_effect=[False,True]):
|
|
with self.assertRaisesRegex(ValueError,'has not yet confirmed'):
|
|
lifecycle.revert(intent)
|
|
self.assertEqual(lifecycle.active_folder(),previous)
|
|
self.assertTrue(pending.exists())
|
|
lifecycle.revert(intent,report_failure=False)
|
|
self.assertFalse(pending.exists())
|
|
self.assertEqual(start.call_count,2)
|
|
self.assertEqual(lifecycle.read(self.root / 'failed.json')['release_sequence'],2)
|
|
|
|
if __name__ == '__main__':
|
|
unittest.main()
|