Files
rengine/shared/utils/net.py
T
Yogesh OjhaandClaude Opus 5 d03b29f186 fix(ipv6): give tools an authority they can parse
Three places built a probe target as f"{ip}:{port}". ip_addresses holds
IPv6 — seed_resolution writes both a and aaaa records — so http_probe,
origin_probe and the vulnerability surface handed httpx and nuclei
2001:db8::1:443, which is neither a host nor a host and port. The httpx
parser then made it worse: rsplit(":", 1) turned a bare v6 address into
2001:db8: before it was stored as the asset's host.

The endpoint layer already got this right in two places with the same
inline expression. That expression is now bracketed() in shared/utils/net
alongside host_port() and split_host_port(), and all five sites use it.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01X5roHYDYzSPRNaTkn8hSkJ
2026-09-13 11:34:01 +05:30

83 lines
2.6 KiB
Python

import ipaddress
import socket
from collections.abc import Iterable
from urllib.parse import urlsplit
def is_registry_routable(value: str) -> bool:
"""Whether an address or netblock sits in public space an RIR can hold a record for."""
try:
net = ipaddress.ip_network(value.strip(), strict=False)
except ValueError:
return False
return net.is_global and not net.is_multicast
def validate_public_https_url(raw: str, *, label: str = "URL") -> None:
parts = urlsplit(raw)
if parts.scheme != "https" or not parts.hostname:
msg = f"{label} must be an https:// URL."
raise ValueError(msg)
try:
infos = socket.getaddrinfo(parts.hostname, None)
except OSError as exc:
msg = f"Cannot resolve {label} host: {exc}"
raise ValueError(msg) from exc
for info in infos:
ip = ipaddress.ip_address(info[4][0])
if (
ip.is_private
or ip.is_loopback
or ip.is_link_local
or ip.is_reserved
or ip.is_multicast
or ip.is_unspecified
):
msg = f"{label} resolves to a disallowed address."
raise ValueError(msg)
def cert_covers(
host: str | None, subject_cn: str | None, sans: Iterable[str] = ()
) -> bool:
"""Whether a certificate names the host presenting it."""
if not host:
return False
target = host.strip().lower().rstrip(".")
for raw in (subject_cn, *sans):
if not raw:
continue
name = str(raw).strip().lower().rstrip(".")
if name == target:
return True
if (
name.startswith("*.")
and target.endswith(name[1:])
and target.count(".") == name.count(".")
):
return True
return False
def bracketed(host: str) -> str:
"""An IPv6 literal in brackets. Anything else is returned as it is."""
return f"[{host}]" if ":" in host and not host.startswith("[") else host
def host_port(host: str, port: int | str) -> str:
"""An authority a tool can parse."""
return f"{bracketed(host)}:{port}"
def split_host_port(authority: str) -> tuple[str, str | None]:
"""The host and port of an authority, with an IPv6 literal unwrapped."""
value = authority.strip()
if value.startswith("["):
literal, _, rest = value.partition("]")
port = rest[1:] if rest.startswith(":") else ""
return literal[1:], port or None
if value.count(":") == 1:
host, _, port = value.partition(":")
return host, port or None
return value, None