feat: snapshot Linux-first RMM MVP and pause handover
Rust development slice / linux (push) Failing after 1m10s
Rust development slice / linux (push) Failing after 1m10s
This commit is contained in:
@@ -0,0 +1,96 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Offline, create-only package installation. Never starts/enables services.
|
||||
|
||||
Default staging is testable without root. A live filesystem install requires
|
||||
both --root / and --install-live plus a preexisting dedicated system account.
|
||||
No device/private signing keys or bearer credentials are accepted as inputs.
|
||||
"""
|
||||
from __future__ import annotations
|
||||
|
||||
import argparse
|
||||
import os
|
||||
from pathlib import Path
|
||||
import pwd
|
||||
import stat
|
||||
|
||||
|
||||
def directory(path: Path, mode: int) -> None:
|
||||
if not path.exists():
|
||||
path.mkdir(mode=mode)
|
||||
metadata = path.lstat()
|
||||
if not stat.S_ISDIR(metadata.st_mode) or metadata.st_mode & 0o022:
|
||||
raise ValueError("unsafe installation directory")
|
||||
if metadata.st_uid != os.geteuid():
|
||||
raise ValueError("installation directory has unexpected owner")
|
||||
|
||||
|
||||
def create(path: Path, data: bytes, mode: int) -> None:
|
||||
fd = os.open(path, os.O_WRONLY | os.O_CREAT | os.O_EXCL | os.O_NOFOLLOW, mode)
|
||||
with os.fdopen(fd, "wb") as stream:
|
||||
stream.write(data)
|
||||
stream.flush()
|
||||
os.fsync(stream.fileno())
|
||||
fd = os.open(path.parent, os.O_RDONLY | os.O_DIRECTORY | os.O_NOFOLLOW)
|
||||
try:
|
||||
os.fsync(fd)
|
||||
finally:
|
||||
os.close(fd)
|
||||
|
||||
|
||||
def elf(path: Path) -> bytes:
|
||||
if path.stat().st_size > 100 * 1024 * 1024:
|
||||
raise ValueError("binary size limit")
|
||||
data = path.read_bytes()
|
||||
if len(data) < 64 or data[:6] != b"\x7fELF\x02\x01" or data[18:20] != b"\x3e\x00":
|
||||
raise ValueError("expected Linux x86-64 ELF artifact")
|
||||
return data
|
||||
|
||||
|
||||
def install(root: Path, agent: Path, ca: Path, helper: Path | None, live: bool) -> None:
|
||||
if not root.is_absolute() or ".." in root.parts:
|
||||
raise ValueError("absolute installation root required")
|
||||
if root == Path("/") and not live:
|
||||
raise ValueError("live installation requires --install-live")
|
||||
if live and (root != Path("/") or os.geteuid() != 0):
|
||||
raise ValueError("live installation requires root and --root /")
|
||||
account = pwd.getpwnam("rmm-agent") if live else None
|
||||
if account is not None and (account.pw_uid == 0 or account.pw_gid == 0):
|
||||
raise ValueError("rmm-agent must be a dedicated unprivileged account")
|
||||
# Validate all inputs before creating anything. CA is public, never private.
|
||||
agent_data = elf(agent)
|
||||
helper_data = elf(helper) if helper else None
|
||||
ca_data = ca.read_bytes()
|
||||
if len(ca_data) > 65536 or b"-----BEGIN CERTIFICATE-----" not in ca_data or b"PRIVATE KEY" in ca_data:
|
||||
raise ValueError("expected public CA certificates only")
|
||||
directory(root, 0o755)
|
||||
for relative in ["usr", "usr/local", "usr/local/libexec", "etc", "etc/rmm",
|
||||
"etc/systemd", "etc/systemd/system", "var", "var/lib"]:
|
||||
directory(root / relative, 0o755)
|
||||
units = Path(__file__).parent
|
||||
files = [("usr/local/libexec/rmm-agent", agent_data, 0o755),
|
||||
("etc/rmm/ca.pem", ca_data, 0o644),
|
||||
("etc/systemd/system/rmm-agent.service", (units / "rmm-agent.service").read_bytes(), 0o644)]
|
||||
if helper_data is not None:
|
||||
files += [("usr/local/libexec/rmm-privileged-helper", helper_data, 0o755),
|
||||
("etc/systemd/system/rmm-privileged-helper.service", (units / "rmm-privileged-helper.service").read_bytes(), 0o644)]
|
||||
# Never overwrite binaries, CA, service units, config or enrollment state.
|
||||
if any((root / relative).exists() or (root / relative).is_symlink() for relative, _, _ in files):
|
||||
raise ValueError("existing installation requires a separate controlled upgrade")
|
||||
for relative, data, mode in files:
|
||||
create(root / relative, data, mode)
|
||||
|
||||
|
||||
def main() -> None:
|
||||
parser = argparse.ArgumentParser(description=__doc__)
|
||||
parser.add_argument("--root", type=Path, required=True)
|
||||
parser.add_argument("--agent-binary", type=Path, required=True)
|
||||
parser.add_argument("--helper-binary", type=Path)
|
||||
parser.add_argument("--ca-file", type=Path, required=True)
|
||||
parser.add_argument("--install-live", action="store_true")
|
||||
args = parser.parse_args()
|
||||
install(args.root, args.agent_binary, args.ca_file, args.helper_binary, args.install_live)
|
||||
print("Package files installed. No account, device identity or authorization config created; services not started/enabled.")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
Reference in New Issue
Block a user