"""Cloud-init public networking and NoCloud seed behavior.""" from __future__ import annotations import importlib.util import json import uuid import pytest from virsh_panel.cloud_init import ( ROOT_PASSWORD_ALPHABET, ROOT_PASSWORD_DIGITS, ROOT_PASSWORD_LENGTH, ROOT_PASSWORD_LOWERCASE, ROOT_PASSWORD_SYMBOLS, ROOT_PASSWORD_UPPERCASE, build_seed_iso, generate_root_password, hash_root_password, read_seed_network, validate_cloud_network, ) PUBLIC_KEY = ( "ssh-ed25519 " "AAAAC3NzaC1lZDI1NTE5AAAAIF7mFh4aYz3lRzNqjoFQasAQLpm7BdSULhe1iWuvj3y5 " "panel-test" ) GUEST_PASSWORD = "A-strong-guest-password-2026" def _user_data(seed: bytes) -> dict: """Read the single-line JSON cloud-config embedded in the generated ISO.""" prefix = b"#cloud-config\n" start = seed.index(prefix) + len(prefix) return json.loads(seed[start:seed.index(b"\n", start)]) def _meta_data(seed: bytes) -> dict: """Read the single-line JSON meta-data embedded in the generated ISO.""" prefix = b'{"instance-id":' start = seed.index(prefix) return json.loads(seed[start:seed.index(b"\n", start)]) def _network_data(seed: bytes) -> dict: """Read the single-line JSON network-config embedded in the ISO.""" prefix = b'{"version": 2, "ethernets":' start = seed.index(prefix) return json.loads(seed[start:seed.index(b"\n", start)]) @pytest.mark.parametrize( ("address", "gateway"), [ ("8.8.8.18/24", "8.8.8.1"), ("8.8.8.18/28", "8.8.8.17"), ("123.123.123.114/24", "123.123.123.113"), ], ) def test_public_network_accepts_24_and_28(address, gateway): validated = validate_cloud_network( address, gateway, ["1.1.1.1", "8.8.8.8"], PUBLIC_KEY, ) assert validated == { "public_ip_cidr": address, "gateway": gateway, "dns_servers": ["1.1.1.1", "8.8.8.8"], "guest_ssh_public_key": PUBLIC_KEY, } def test_cloud_login_accepts_key_and_root_password_together(): network = ("8.8.8.18/24", "8.8.8.1", ["1.1.1.1"]) password_hash = hash_root_password(GUEST_PASSWORD) assert password_hash.startswith("$6$") assert GUEST_PASSWORD not in password_hash assert hash_root_password(GUEST_PASSWORD) != password_hash validated = validate_cloud_network( *network, "", root_password_hash=password_hash, ) assert validated["root_password_hash"] == password_hash assert not validated["guest_ssh_public_key"] together = validate_cloud_network( *network, PUBLIC_KEY, root_password_hash=password_hash, ) assert together["guest_ssh_public_key"] == PUBLIC_KEY assert together["root_password_hash"] == password_hash with pytest.raises(ValueError): validate_cloud_network(*network, "", root_password_hash=None) with pytest.raises(ValueError): validate_cloud_network(*network, "", root_password_hash=GUEST_PASSWORD) @pytest.mark.parametrize("invalid", [ "Short1!", "alllowercase12!", "ALLUPPERCASE12!", "NoSymbolPassword12", "NoDigitsLong!Aa", "A-lowercase password12!", "A-lowercase\npassword12!", "A-lowercase-password-1" + "x" * 110, "ValidAscii1!含中文", ]) def test_manual_root_password_requires_ascii_and_all_character_classes(invalid): with pytest.raises(ValueError, match="初始 root 密码"): hash_root_password(invalid) def test_generated_root_password_always_meets_policy(): assert ROOT_PASSWORD_ALPHABET == ( "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz" "0123456789!@#$%*-_=+?" ) samples = set() for _ in range(50): password = generate_root_password() samples.add(password) assert len(password) == ROOT_PASSWORD_LENGTH assert set(password) <= set(ROOT_PASSWORD_ALPHABET) assert any(char in ROOT_PASSWORD_UPPERCASE for char in password) assert any(char in ROOT_PASSWORD_LOWERCASE for char in password) assert any(char in ROOT_PASSWORD_DIGITS for char in password) assert any(char in ROOT_PASSWORD_SYMBOLS for char in password) assert len(samples) == 50 assert len({password[:4] for password in samples}) > 1 assert hash_root_password(password).startswith("$6$") def test_generated_root_password_rejects_whole_noncompliant_candidate(monkeypatch): # First candidate is 32 uppercase A characters and must be discarded. # The second one is a known compliant candidate with no post-processing. indexes = iter([0] * 32 + [0, 26, 52, 62] * 8) bounds = [] def deterministic_randbelow(bound): bounds.append(bound) return next(indexes) monkeypatch.setattr("virsh_panel.cloud_init.secrets.randbelow", deterministic_randbelow) assert generate_root_password() == "Aa0!" * 8 assert bounds == [len(ROOT_PASSWORD_ALPHABET)] * 64 @pytest.mark.parametrize( ("address", "gateway"), [ ("192.168.1.18/24", "192.168.1.1"), ("10.0.0.18/24", "10.0.0.1"), ("172.16.0.18/24", "172.16.0.1"), ("127.0.0.18/24", "127.0.0.1"), ("169.254.0.18/24", "169.254.0.1"), ("224.0.0.18/24", "224.0.0.1"), ("2001:4860:4860::8888/64", "2001:4860:4860::1"), ("8.8.8.0/24", "8.8.8.1"), ("8.8.8.255/24", "8.8.8.1"), ("8.8.8.18/28", "8.8.8.1"), ("8.8.8.18", "8.8.8.1"), ], ) def test_public_network_rejects_nonpublic_or_unroutable_pairs(address, gateway): with pytest.raises(ValueError): validate_cloud_network(address, gateway, ["1.1.1.1"], PUBLIC_KEY) @pytest.mark.parametrize( ("dns", "key"), [ (["not-an-ip"], PUBLIC_KEY), (["192.168.1.1"], PUBLIC_KEY), ([], PUBLIC_KEY), (["1.1.1.1"], "not-an-ssh-key"), (["1.1.1.1"], PUBLIC_KEY + "\nruncmd: [evil]"), ], ) def test_public_network_rejects_bad_dns_and_ssh_key(dns, key): with pytest.raises(ValueError): validate_cloud_network("8.8.8.18/24", "8.8.8.1", dns, key) @pytest.mark.skipif(importlib.util.find_spec("pycdlib") is None, reason="pycdlib is not installed") def test_seed_iso_has_nocloud_files_and_mac_specific_static_network(): vm_uuid = str(uuid.uuid4()) mac = "52:54:00:12:34:56" validated = validate_cloud_network( "8.8.8.18/28", "8.8.8.17", ["1.1.1.1"], PUBLIC_KEY, ) seed = build_seed_iso(vm_uuid, "cloud-vm", mac, validated) assert isinstance(seed, bytes) assert seed[32769:32774] == b"CD001" # ISO-9660 primary volume descriptor assert b"CIDATA" in seed for marker in ( b"user-data", b"meta-data", b"network-config", b"8.8.8.18/28", b"8.8.8.17", b"1.1.1.1", mac.encode(), PUBLIC_KEY.encode(), ): assert marker in seed assert b'"routes": [{"to": "0.0.0.0/0", "via": "8.8.8.17"}]' in seed assert b'"to": "default"' not in seed assert b'"renderer": "networkd"' not in seed assert b'"set-name"' not in seed assert b"IPv6AcceptRA=no" not in seed assert b"systemd-machine-id-setup" not in seed user_data = _user_data(seed) metadata = _meta_data(seed) assert user_data["disable_root"] is False assert user_data["ssh_pwauth"] is False assert user_data["users"][0]["name"] == "root" assert user_data["users"][0]["ssh_authorized_keys"] == [PUBLIC_KEY] assert "hashed_passwd" not in user_data["users"][0] assert "passwd" not in user_data["users"][0] sshd_dropin = user_data["write_files"][0] assert sshd_dropin["path"] == "/etc/ssh/sshd_config.d/00-virsh-panel-root.conf" assert "PermitRootLogin prohibit-password" in sshd_dropin["content"] assert "PasswordAuthentication no" in sshd_dropin["content"] assert "runcmd" not in user_data assert "bootcmd" not in user_data assert "dsmode" not in metadata assert all( item["path"] != "/etc/systemd/network/05-virt-cloud-public.network" for item in user_data["write_files"] ) assert b"almalinux" not in seed assert read_seed_network(seed) == { "public_ip_cidr": "8.8.8.18/28", "gateway": "8.8.8.17", "dns_servers": ["1.1.1.1"], "mac": mac, } @pytest.mark.skipif(importlib.util.find_spec("pycdlib") is None, reason="pycdlib is not installed") def test_debian12_network_fix_uses_standard_nocloud_network_config(): mac = "52:54:00:12:34:56" validated = validate_cloud_network( "8.8.8.18/28", "8.8.8.17", ["1.1.1.1", "8.8.8.8"], PUBLIC_KEY, ) seed = build_seed_iso( str(uuid.uuid4()), "debian-12-vm", mac, validated, debian12_network_fix=True, ) user_data = _user_data(seed) metadata = _meta_data(seed) network_data = _network_data(seed) assert network_data == { "version": 2, "ethernets": { "public0": { "match": {"macaddress": mac}, "dhcp4": False, "dhcp6": False, "addresses": ["8.8.8.18/28"], "routes": [{"to": "0.0.0.0/0", "via": "8.8.8.17"}], "nameservers": {"addresses": ["1.1.1.1", "8.8.8.8"]}, "accept-ra": False, }, }, "renderer": "networkd", } assert metadata["dsmode"] == "local" bootcmd = user_data["bootcmd"] assert bootcmd[0][:2] == ["/bin/sh", "-ec"] queue_networkd = bootcmd[0][2] assert queue_networkd.splitlines() == [ "systemd-machine-id-setup", "netplan generate", "systemctl unmask systemd-networkd.service", "systemctl enable systemd-networkd.service", "systemctl start --no-block systemd-networkd.service", ] assert "ip address" not in queue_networkd assert "ip route" not in queue_networkd assert "restart" not in json.dumps(bootcmd) assert "--now" not in json.dumps(bootcmd) assert "runcmd" not in user_data assert b'"set-name"' not in seed assert b"enp1s0" not in seed assert all( not item["path"].startswith("/etc/systemd/network/") for item in user_data["write_files"] ) assert read_seed_network(seed) == { "public_ip_cidr": "8.8.8.18/28", "gateway": "8.8.8.17", "dns_servers": ["1.1.1.1", "8.8.8.8"], "mac": mac, } @pytest.mark.parametrize("invalid", [None, 0, 1, "networkd"]) def test_seed_rejects_invalid_debian12_network_fix_option(invalid): validated = validate_cloud_network( "8.8.8.18/28", "8.8.8.17", ["1.1.1.1"], PUBLIC_KEY, ) with pytest.raises(ValueError, match="Debian 12 网络修复选项"): build_seed_iso( str(uuid.uuid4()), "cloud-vm", "52:54:00:12:34:56", validated, debian12_network_fix=invalid, ) @pytest.mark.skipif(importlib.util.find_spec("pycdlib") is None, reason="pycdlib is not installed") def test_read_seed_network_rejects_invalid_iso_without_exposing_credentials(): with pytest.raises(ValueError): read_seed_network(b"not an ISO") with pytest.raises(ValueError): read_seed_network(b"x" * (1024 * 1024 + 1)) @pytest.mark.skipif(importlib.util.find_spec("pycdlib") is None, reason="pycdlib is not installed") def test_password_seed_sets_root_hash_and_enables_ssh_password_login(): password_hash = hash_root_password(GUEST_PASSWORD) validated = validate_cloud_network( "8.8.8.18/28", "8.8.8.17", ["1.1.1.1"], "", root_password_hash=password_hash, ) seed = build_seed_iso( str(uuid.uuid4()), "password-vm", "52:54:00:12:34:56", validated, ) user_data = _user_data(seed) assert user_data["disable_root"] is False assert user_data["ssh_pwauth"] is True assert user_data["users"][0]["name"] == "root" assert user_data["users"][0]["lock_passwd"] is False assert user_data["users"][0]["hashed_passwd"] == password_hash assert "ssh_authorized_keys" not in user_data["users"][0] sshd_dropin = user_data["write_files"][0] assert sshd_dropin["path"] == "/etc/ssh/sshd_config.d/00-virsh-panel-root.conf" assert "PermitRootLogin yes" in sshd_dropin["content"] assert "PasswordAuthentication yes" in sshd_dropin["content"] assert GUEST_PASSWORD.encode() not in seed @pytest.mark.skipif(importlib.util.find_spec("pycdlib") is None, reason="pycdlib is not installed") def test_seed_allows_root_password_and_ssh_key_together(): password_hash = hash_root_password(GUEST_PASSWORD) validated = validate_cloud_network( "8.8.8.18/28", "8.8.8.17", ["1.1.1.1"], PUBLIC_KEY, root_password_hash=password_hash, ) seed = build_seed_iso( str(uuid.uuid4()), "both-vm", "52:54:00:12:34:56", validated, ) user_data = _user_data(seed) root = user_data["users"][0] assert root["name"] == "root" assert root["lock_passwd"] is False assert root["ssh_authorized_keys"] == [PUBLIC_KEY] assert root["hashed_passwd"] == password_hash assert user_data["ssh_pwauth"] is True assert "PermitRootLogin yes" in user_data["write_files"][0]["content"] assert "PasswordAuthentication yes" in user_data["write_files"][0]["content"] assert GUEST_PASSWORD.encode() not in seed