Edit

[EDIT] FILE: domain.py

#!/opt/cloudlinux/venv/bin/python3 -sbb
# -*- coding: utf-8 -*-
#
# Copyright © Cloud Linux GmbH & Cloud Linux Software, Inc 2010-2021 All Rights Reserved
#
# Licensed under CLOUD LINUX LICENSE AGREEMENT
# http://cloudlinux.com/docs/LICENCE.TXT
#
import functools
import logging
import os
import shutil
import subprocess
import tempfile
from collections import defaultdict
from pathlib import Path

from clcommon import ClPwd
from clcommon.clcagefs import setup_mount_dir_cagefs, CAGEFSCTL_TOOL
from clcommon.cpapi import cpusers, is_panel_feature_supported
from clcommon.cpapi import docroot as get_domain_docroot
from clcommon.const import Feature
from clcommon.cpapi.cpapiexceptions import NoDomain

from lve_utils.pylve_wrapper import PyLve

from .fs import user_exists
from .exceptions import UserNotFoundError
from .webisolation import admin_config, config, jail_utils, litespeed
from .webisolation.config import DOCROOTS_ISOLATED_BASE
from .webisolation.docroot_validation import validate_docroot, validate_docroot_no_symlinks
from .webisolation.jail_config_builder import write_jail_mounts_config
from .webisolation.php import reload_processes_with_docroots
from .webisolation.service import start_monitoring_service, stop_monitoring_service
from .webisolation.triggers import trigger_xray_ini_regeneration, trigger_ssa_ini_regeneration

def is_website_isolation_allowed_server_wide():
    return os.path.isfile(admin_config.WEBSITE_ISOLATION_MARKER)

def is_website_isolation_feature_available():
    return os.path.isfile(admin_config.WEBSITE_ISOLATION_AVAILABLE_MARKER)

def get_isolation_user_mode() -> str | None:
    """Return the current user mode for website isolation.

Returns:
        ``"allow_all"`` – all users allowed, denied dir lists exceptions.
        ``"deny_all"``  – no users allowed, allowed dir lists exceptions.
        ``None``        – not initialised yet.
    """
    has_denied = os.path.isdir(admin_config.ISOLATION_DENIED_DIR)
    has_allowed = os.path.isdir(admin_config.ISOLATION_ALLOWED_DIR)
    if has_denied and has_allowed:
        # Error state – both dirs present.  Treat as allow_all and clean up.
        logging.warning(
            "Both site-isolation.users.allowed and site-isolation.users.denied "
            "directories exist. Removing allowed directory, treating as allow_all mode."
        )
        shutil.rmtree(admin_config.ISOLATION_ALLOWED_DIR, ignore_errors=True)
        return "allow_all"
    if has_denied:
        return "allow_all"
    if has_allowed:
        return "deny_all"
    return None

def is_website_isolation_allowed_for_user(user: str) -> bool:
    """Check whether *user* is allowed to use website isolation.

Combines the global marker with the two-mode user model:
    * **allow_all** – allowed unless the user is in the denied directory.
    * **deny_all**  – denied unless the user is in the allowed directory.
    """
    if not os.path.isfile(admin_config.WEBSITE_ISOLATION_MARKER):
        return False
    mode = get_isolation_user_mode()
    if mode == "allow_all":
        return not admin_config.user_in_dir(admin_config.ISOLATION_DENIED_DIR, user)
    if mode == "deny_all":
        return admin_config.user_in_dir(admin_config.ISOLATION_ALLOWED_DIR, user)
    return False  # not initialised

def _ensure_isolation_mount_and_marker():
    """Set up mount directories and the global marker if not already done."""
    if not os.path.isfile(admin_config.WEBSITE_ISOLATION_MARKER):
        setup_mount_dir_cagefs(
            str(DOCROOTS_ISOLATED_BASE), prefix="*",
            remount_cagefs=True, remount_in_background=False,
        )
        marker_path = Path(admin_config.WEBSITE_ISOLATION_MARKER)
        marker_path.parent.mkdir(parents=True, exist_ok=True)
        marker_path.touch()
        # Remount kills redis processes, restart clwpos_monitoring service if it's running
        subprocess.run(
            ["/usr/bin/systemctl", "try-restart", "clwpos_monitoring.service"],
            capture_output=True,
            text=True
        )

PROXY_COMMANDS_PATH = "/etc/cagefs/proxy.commands"
CAGEFSCTL_USER_PROXY_ENTRY = "CAGEFSCTL_USER:noproceed:nolve=root:/usr/sbin/cagefsctl-user"

CAGEFSCTL_USER_BINARIES = [
    "/usr/sbin/cagefsctl-user",
]

LVD_PROXY_ENTRIES = {
    "LVD_REGISTRY_HELPER": "/usr/share/lve-utils/lvd-registry-helper",
    "LVD_LIMITS_HELPER": "/usr/share/lve-utils/lvd-limits-helper",
}

def _add_proxy_entries(content, entries):
    """Append missing proxy entries to *content*, return (new_content, added).

Each entry in *entries* is a ``{KEY: path}`` dict.  An entry is added
    only when its KEY is not yet present AND the binary exists on disk.
    Returns the (possibly updated) content string and a bool indicating
    whether any entries were added.
    """
    added = False
    for key, binary in entries.items():
        if key in content:
            continue
        if not os.path.exists(binary):
            continue
        if content and not content.endswith("\n"):
            content += "\n"
        content += f"{key}={binary}\n"
        added = True
    return content, added

def _remove_proxy_entries(content, entries):
    """Remove proxy entries whose binaries no longer exist on disk.

Returns the (possibly updated) content string and a bool indicating
    whether any entries were removed.
    """
    removed = False
    for key, binary in entries.items():
        if key not in content:
            continue
        if os.path.exists(binary):
            continue
        lines = content.splitlines(keepends=True)
        lines = [l for l in lines if not l.startswith(f"{key}=")]
        content = "".join(lines)
        removed = True
    return content, removed

def ensure_proxyexec_command():
    """Register the ``cagefsctl-user`` proxyexec alias if not already present.

Appends the ``CAGEFSCTL_USER`` entry to ``/etc/cagefs/proxy.commands``
    and runs ``cagefsctl --update-list`` to pull the required binaries into
    the CageFS skeleton.  This is a no-op when the entry already exists.

Also registers/unregisters the LVD helper binaries
    (``lvd-registry-helper``, ``lvd-limits-helper``) depending on whether
    they are present on disk.
    """
    try:
        with open(PROXY_COMMANDS_PATH, "r", encoding="utf-8") as f:
            content = f.read()
    except FileNotFoundError:
        content = ""

changed = False

if "CAGEFSCTL_USER" not in content:
        logging.info("Registering cagefsctl-user in %s", PROXY_COMMANDS_PATH)
        if content and not content.endswith("\n"):
            content += "\n"
        content += CAGEFSCTL_USER_PROXY_ENTRY + "\n"
        changed = True

content, added = _add_proxy_entries(content, LVD_PROXY_ENTRIES)
    if added:
        logging.info("Registering LVD helpers in %s", PROXY_COMMANDS_PATH)
        changed = True

content, removed = _remove_proxy_entries(content, LVD_PROXY_ENTRIES)
    if removed:
        logging.info("Removing stale LVD helpers from %s", PROXY_COMMANDS_PATH)
        changed = True

if not changed:
        return

proxy_dir = os.path.dirname(PROXY_COMMANDS_PATH)
    os.makedirs(proxy_dir, exist_ok=True)
    fd, tmp_path = tempfile.mkstemp(dir=proxy_dir, prefix=".proxy.commands.")
    try:
        with os.fdopen(fd, "w", encoding="utf-8") as f:
            f.write(content)
        os.replace(tmp_path, PROXY_COMMANDS_PATH)
    except BaseException:
        os.unlink(tmp_path)
        raise

update_list = ("\n".join(CAGEFSCTL_USER_BINARIES) + "\n").encode()
    subprocess.run(
        [CAGEFSCTL_TOOL, "--wait-lock", "--update-list"],
        input=update_list,
        stdout=subprocess.DEVNULL,
        stderr=subprocess.DEVNULL,
        check=False,
    )

subprocess.run(
        [CAGEFSCTL_TOOL, "--update-wrappers"],
        stdout=subprocess.DEVNULL,
        stderr=subprocess.DEVNULL,
        check=False,
    )

def toggle_isolation_user_mode() -> str:
    """Flip the isolation user mode without modifying any per-user state.

Unlike :func:`allow_website_isolation_server_wide` and
    :func:`deny_website_isolation_server_wide`, this function only flips
    the mode indicator directories.  It does **not** clean up existing
    user isolation or alter the per-user exception lists.

* ``allow_all`` → ``deny_all``
    * ``deny_all``  → ``allow_all``
    * not initialised → ``allow_all``

Returns:
        The new mode after toggling (``"allow_all"`` or ``"deny_all"``).
    """
    _ensure_isolation_mount_and_marker()
    current = get_isolation_user_mode()
    if current == "allow_all":
        new_mode = "deny_all"
        os.makedirs(admin_config.ISOLATION_ALLOWED_DIR, mode=admin_config.DIR_MODE, exist_ok=True)
        shutil.rmtree(admin_config.ISOLATION_DENIED_DIR, ignore_errors=True)
    else:
        # deny_all or not initialised → allow_all
        new_mode = "allow_all"
        os.makedirs(admin_config.ISOLATION_DENIED_DIR, mode=admin_config.DIR_MODE, exist_ok=True)
        shutil.rmtree(admin_config.ISOLATION_ALLOWED_DIR, ignore_errors=True)
    return new_mode

# CLOS-4614: lve-stats3 ships this marker once it can chart per-domain
# (website-isolation) LVE usage. Until then cagefs must NOT auto allow/enable
# LVE per-domain limits: the per-user isolation LVP (lvp<uid>) + domain LVEs it
# would create are misattributed by lve-stats (CLOS-4608, usage graph) and
# destabilise the user's enforced limit (CLOS-4609). CageFS website isolation
# (the filesystem separation) is independent of this and always works; only the
# trailing lvectl domain-limit calls are gated.
LVESTATS_SUPPORTS_DOMAIN_LVE_LIMITS_MARKER = (
    '/opt/cloudlinux/flags/available-flags.d/'
    'lvestats-supports-domain-lve-limits.flag'
)

@functools.lru_cache(maxsize=1)
def _domain_limits_supported():
    """Check if the running kernel supports per-domain LVE limits."""
    try:
        py = PyLve()
    except (AttributeError, OSError):
        return False

if not py.initialize():
        return False

return py.domains_supported()

def _domain_limits_auto_enabled():
    """Whether cagefs should auto allow/enable LVE per-domain limits (CLOS-4614).

True once the installed lve-stats3 can chart per-domain isolation usage (it
    ships ``LVESTATS_SUPPORTS_DOMAIN_LVE_LIMITS_MARKER``). Gates only the AUTO
    *allow/enable*; the deny/disable paths stay active regardless so any LVPs
    created by an earlier build can always be torn down.
    """
    return os.path.exists(LVESTATS_SUPPORTS_DOMAIN_LVE_LIMITS_MARKER)

def _allow_domain_limits(username):
    """Create LVP infrastructure for user via lvectl (idempotent)."""
    if not is_panel_feature_supported(Feature.LVE):
        return
    if not _domain_limits_supported():
        return
    if not _domain_limits_auto_enabled():
        # CLOS-4614: paused until lve-stats3 can chart per-domain usage.
        return
    subprocess.run(['/usr/sbin/lvectl', 'allow-domain-limits', username],
                   check=True, capture_output=True)

def _deny_domain_limits(username):
    """Tear down LVP infrastructure for user via lvectl."""
    if not is_panel_feature_supported(Feature.LVE):
        return
    if not _domain_limits_supported():
        return
    subprocess.run(['/usr/sbin/lvectl', 'deny-domain-limits', username],
                   check=True, capture_output=True)

def _register_domain_lve(user, domain):
    """Register domain LVE under user's LVP via lvectl."""
    if not is_panel_feature_supported(Feature.LVE):
        return
    if not _domain_limits_supported():
        return
    if not _domain_limits_auto_enabled():
        # CLOS-4614: paused until lve-stats3 can chart per-domain usage.
        return
    subprocess.run(
        ['/usr/sbin/lvectl', 'enable-domain-limits', domain],
        check=True, capture_output=True,
    )

def _unregister_domain_lve(user, domain):
    """Unregister domain LVE via lvectl."""
    if not is_panel_feature_supported(Feature.LVE):
        return
    if not _domain_limits_supported():
        return
    subprocess.run(
        ['/usr/sbin/lvectl', 'disable-domain-limits', domain],
        check=True, capture_output=True,
    )

def allow_website_isolation_server_wide():
    """Switch to *allow_all* mode – all users are allowed by default."""
    _ensure_isolation_mount_and_marker()
    ensure_proxyexec_command()
    # Create empty denied-users directory → allow_all mode indicator
    os.makedirs(admin_config.ISOLATION_DENIED_DIR, mode=admin_config.DIR_MODE, exist_ok=True)
    # Remove allowed-users directory (belongs to deny_all mode)
    shutil.rmtree(admin_config.ISOLATION_ALLOWED_DIR, ignore_errors=True)

for username in cpusers():
        if not user_exists(username):
            continue

try:
            _allow_domain_limits(username)
        except (subprocess.CalledProcessError, OSError):
            logging.exception(
                "Failed to enable domain limits for user %s, skipping.",
                username,
            )

def deny_website_isolation_server_wide():
    """Switch to *deny_all* mode – no users are allowed by default.

Disables domain isolation for every user and switches the mode.
    """
    _cleanup_all_users_isolation()

for username in cpusers():
        if not user_exists(username):
            continue

try:
            _deny_domain_limits(username)
        except (subprocess.CalledProcessError, OSError):
            logging.exception(
                "Failed to disable domain limits for user %s, skipping.",
                username,
            )

_ensure_isolation_mount_and_marker()
    # Create empty allowed-users directory → deny_all mode indicator
    os.makedirs(admin_config.ISOLATION_ALLOWED_DIR, mode=admin_config.DIR_MODE, exist_ok=True)
    # Remove denied-users directory (belongs to allow_all mode)
    shutil.rmtree(admin_config.ISOLATION_DENIED_DIR, ignore_errors=True)

def allow_website_isolation_for_user(username: str):
    """Allow website isolation for *username* (mode-aware).

* **allow_all** – removes *username* from the denied directory.
    * **deny_all**  – adds *username* to the allowed directory.
    * **not initialised** – sets up infrastructure in *deny_all* mode
      with *username* as the first allowed user.
    """
    _ensure_isolation_mount_and_marker()
    ensure_proxyexec_command()
    mode = get_isolation_user_mode()
    if mode == "allow_all":
        admin_config.remove_user_from_dir(admin_config.ISOLATION_DENIED_DIR, username)
    elif mode == "deny_all":
        admin_config.add_user_to_dir(admin_config.ISOLATION_ALLOWED_DIR, username)
    else:
        # Not initialised → start in deny_all mode with this user allowed
        os.makedirs(admin_config.ISOLATION_ALLOWED_DIR, mode=admin_config.DIR_MODE, exist_ok=True)
        admin_config.add_user_to_dir(admin_config.ISOLATION_ALLOWED_DIR, username)

_allow_domain_limits(username)

def deny_website_isolation_for_user(username: str):
    """Deny website isolation for *username* (mode-aware).

* **allow_all** – adds *username* to the denied directory.
    * **deny_all**  – removes *username* from the allowed directory.

Also disables all domain isolation for the user.
    """
    mode = get_isolation_user_mode()
    if mode == "allow_all":
        admin_config.add_user_to_dir(admin_config.ISOLATION_DENIED_DIR, username)
    elif mode == "deny_all":
        admin_config.remove_user_from_dir(admin_config.ISOLATION_ALLOWED_DIR, username)

# Clean up existing domain isolation for the user
    _cleanup_user_isolation(username)
    _deny_domain_limits(username)

def _cleanup_user_isolation(username: str):
    """Remove all domain isolation state for a single user."""
    if not user_exists(username):
        return
    user_cfg = config.load_user_config(username)
    if not user_cfg.enabled_websites:
        return

domain_docroot_map = {
        d: _get_docroot_or_none(d) for d in user_cfg.enabled_websites
    }
    config.save_user_config(username, config=None)
    write_jail_mounts_config(username, user_config=None)

# CLOS-4642: drop dedicated LiteSpeed pools on full teardown
    # (--isolates-deny / --isolates-deny-all). No-op off standalone LiteSpeed.
    try:
        litespeed.remove_all_dedicated_php_handlers(username)
    except Exception:
        logging.exception(
            "Failed to remove LiteSpeed dedicated PHP handlers for %s", username)

reload_processes_with_docroots(
        username, filter_by_docroots=list(domain_docroot_map.values())
    )
    for d, docroot in domain_docroot_map.items():
        if docroot is None:
            logging.error(
                "Unable to detect document root for domain %s, "
                "configuration cleanup failed. Contact CloudLinux support "
                "if the error repeats.",
                d,
            )
            continue
        jail_utils.remove_website_token_directory(username, docroot)

def _cleanup_all_users_isolation():
    """Remove domain isolation state for every user that has it."""
    for username in list(users_with_enabled_domain_isolation()):
        try:
            _cleanup_user_isolation(username)
        except Exception:
            logging.exception(
                "Unable to disable website isolation for user %s, skipping.",
                username,
            )
    users_left = users_with_enabled_domain_isolation()
    if not users_left:
        stop_monitoring_service()

def _get_docroot_or_none(domain: str):
    try:
        return get_domain_docroot(domain)[0]
    except (NoDomain, IndexError):
        return None

def is_isolation_enabled(user):
    if not is_website_isolation_allowed_server_wide():
        return False
    try:
        domains_config_path = jail_utils.get_jail_config_path(user)
    except UserNotFoundError:
        return False
    return os.path.exists(domains_config_path)

def users_with_enabled_domain_isolation() -> dict:
    users = [u for u in cpusers() if user_exists(u) and is_isolation_enabled(u)]
    user_domain_pairs = {}
    for user in users:
        domains_with_isolation = get_websites_with_enabled_isolation(user)
        if domains_with_isolation:
            user_domain_pairs[user] = domains_with_isolation
    return user_domain_pairs

def get_websites_with_enabled_isolation(user: str):
    if not user_exists(user):
        logging.warning(
            "User %s not found, cannot get websites with enabled isolation", user)
        return []
    return config.load_user_config(user).enabled_websites

def get_docroots_of_isolated_websites() -> dict:
    """
    Returns pairs user: set(docroots) for all users with website isolation enabled
    Used by monitoring service to watch docroots changes to load actual list of docroot paths
    instead of stale storage
    """
    users_with_isolation = users_with_enabled_domain_isolation()
    pairs = defaultdict(set)
    for user, domains in users_with_isolation.items():
        for domain in domains:
            try:
                dr = get_domain_docroot(domain)[0]
            except (NoDomain, IndexError):
                continue
            pairs[user].add(dr)
    return pairs

def enable_website_isolation(user, domain):
    if not user_exists(user):
        logging.warning(
            "User %s not found, cannot enable website isolation", user)
        return
    user_config = config.load_user_config(user)

# if it crashes just let the command fail with NoDomain
    # exception, it should be a very rare case because
    # we validate input domain name in cagefsctl.py
    # Validate at the trust boundary: docroot is panel-supplied and is
    # consumed verbatim by the jail mount config writer (raw bind
    # source/target and bracketed section header). See docroot_validation.
    # Skip-and-log on invalid docroot (matches the user-not-found path
    # above) so a single bad domain does not abort the multi-domain loop
    # in cagefsctl_user.py's site-isolation-enable handler. The
    # symlink-rejecting check on top of the lexical one blocks the tenant
    # from pre-aiming the bind source at an arbitrary host path via a
    # symlink in their own writable ancestor tree.
    try:
        document_root = validate_docroot(get_domain_docroot(domain)[0])
        validate_docroot_no_symlinks(document_root, ClPwd().get_pw_by_name(user).pw_dir)
    except ValueError as exc:
        logging.warning(
            "Skipping website isolation for user %s domain %s: %s",
            user, domain, exc)
        return

if domain not in user_config.enabled_websites:
        user_config.enabled_websites.append(domain)

# Create website token directory and overlay storage
    jail_utils.create_website_token_directory(user, document_root)
    jail_utils.create_overlay_storage_directory(user, document_root)

config.save_user_config(user, user_config)

# regenerate alt-php ini configuration for selector for the specific domain
    # scanner-triage: bare-name cagefsctl is safe. The only tenant-reachable
    # path is the CAGEFSCTL_USER proxyexec alias, which is marked `root:` in
    # proxy.commands and thus goes through scrub_env_for_root_exec — PATH is
    # reset before execv. The other caller (root admin CLI) is root-to-root.
    subprocess.run(["cagefsctl", "--rebuild-alt-php-ini", "--domain", domain], check=True)

# F-15 (CLOS-5953) DiD, follow-up: --rebuild-alt-php-ini reaches
    # configure_alt_php which invokes make_userdir on
    # <home>/.cagefs/websites/<website_id> and re-chowns that leaf back
    # to the tenant with mode 0o771 -- undoing the seal
    # create_overlay_storage_directory applied a few lines above and
    # letting the tenant plant a `home` symlink under it before the
    # jail mounter reads write_jail_mounts_config's output. Re-seal the
    # overlay chain (leaf + websites, root:root 0o755) here to close
    # that window. Idempotent no-op on teardown/rollback paths where
    # the overlay tree is already gone.
    jail_utils.seal_overlay_storage_ancestors(user, document_root)

write_jail_mounts_config(user, user_config)

# CLOS-4642: configure the dedicated per-domain lsphp pool BEFORE reloading
    # workers so that on standalone LiteSpeed the reloaded workers come up in the
    # dedicated pool (per-website namespace) instead of the shared per-user pool.
    # No-op on Apache+mod_lsapi / Plesk / DirectAdmin.
    try:
        litespeed.enable_dedicated_php_handler(user, document_root)
    except Exception:
        logging.exception(
            "Failed to apply LiteSpeed dedicated PHP handler for %s/%s", user, domain)

reload_processes_with_docroots(user, filter_by_docroots=[_get_docroot_or_none(domain)])
    start_monitoring_service()

# Trigger xray/ssa ini regeneration for per-domain PHP selector
    trigger_xray_ini_regeneration(user, domain)
    trigger_ssa_ini_regeneration(user)

_register_domain_lve(user, domain)

def regenerate_isolation_configuration(user):
    if not user_exists(user):
        logging.warning(
            "User %s not found, cannot regenerate website isolation configuration", user)
        return
    user_config = config.load_user_config(user)
    # F-08 (CLOS-5946) DiD: filter enabled_websites down to domains whose
    # CURRENTLY resolved docroot still passes the lexical + no-symlink
    # validation before rewriting the jail mount config. A docroot that
    # passed at enable time can change on disk (panel edit, tenant plants
    # a symlink under an owned ancestor); without this re-check the root-
    # run bind mounts in write_jail_mounts_config would follow the
    # symlink. Mirrors the shape used at enable_website_isolation above.
    # A missing on-disk component here short-circuits the walk as safe
    # — see validate_docroot_no_symlinks (jail.c refuses to follow a
    # tenant-planted symlink at bind time and skips ENOENT sources).
    home = ClPwd().get_pw_by_name(user).pw_dir
    valid_websites = []
    rejected_domains = []
    for domain in user_config.enabled_websites:
        current_docroot = _get_docroot_or_none(domain)
        if current_docroot is None:
            # Preserve legacy behaviour: keep the entry so downstream
            # code can log/handle the disappearing-domain case below.
            valid_websites.append(domain)
            continue
        try:
            validate_docroot(current_docroot)
            validate_docroot_no_symlinks(current_docroot, home)
        except ValueError as exc:
            logging.warning(
                "Skipping website isolation regeneration for user %s domain %s: %s",
                user, domain, exc)
            # Capture (domain, docroot) so the teardown below can
            # remove the stale token, unregister LVE, and reload
            # workers for the rejected docroot — mirrors the
            # disable_website_isolation sequence. Without this,
            # workers keep the stale isolation mount for a docroot
            # that no longer appears in the mounts config.
            rejected_domains.append((domain, current_docroot))
            continue
        valid_websites.append(domain)
    if len(valid_websites) != len(user_config.enabled_websites):
        # Persist the filtered list to disk. Without this, dropped
        # domains linger in the saved config and reappear on the next
        # load — the F-08 revalidation would then have to reject them
        # again on every regeneration cycle. Mirrors the persist-then-
        # write-mounts pattern used in enable/disable/cleanup above.
        user_config.enabled_websites = valid_websites
        config.save_user_config(user, user_config)
    else:
        user_config.enabled_websites = valid_websites
    write_jail_mounts_config(user, user_config)

# F-08 (CLOS-5946) DiD: unregister LVE for each rejected domain so
    # workers stop associating requests with the stale isolation entry.
    # LVE unregister is domain-keyed (no filesystem touch), safe even
    # for a rejected/symlinked docroot.
    #
    # Post-review Bugbot MED on !211: do NOT call
    # jail_utils.remove_website_token_directory(user, rejected_docroot)
    # or reload_processes_with_docroots(filter=rejected_docroots) here.
    # The rejected docroot value is *why* revalidation refused the
    # domain (attacker-planted symlink under the tenant home); feeding
    # it back into filesystem-touching helpers gives that untrusted
    # string a second bite at the sink. The stale mount and token dir
    # will be cleaned up on the next legitimate disable_website_
    # isolation or user-teardown pass, where the operator (or the
    # regenerate path with a now-clean docroot) has a trusted value
    # in hand. Log an advisory so operators can intervene manually.
    if rejected_domains:
        for domain, dr in rejected_domains:
            try:
                _unregister_domain_lve(user, domain)
            except (subprocess.CalledProcessError, OSError):
                logging.exception(
                    "Failed to unregister domain LVE for %s, skipping.", domain)
            logging.warning(
                "Website isolation rejected for user %s domain %s; "
                "on-disk token and worker reload skipped for the "
                "untrusted docroot. Run disable_website_isolation with "
                "a trusted docroot value if manual cleanup is required.",
                user, domain,
            )

document_roots = []
    for domain in user_config.enabled_websites:
        document_root = _get_docroot_or_none(domain)
        if document_root is None:
            logging.warning(
                "Unable to find document root for domain %s, "
                "please contact CloudLinux support if the issue persists.",
                domain,
            )
            continue

document_roots.append(document_root)
        try:
            # recreate tokens and storage e.g. when username changes
            jail_utils.create_website_token_directory(user, document_root)
            jail_utils.create_overlay_storage_directory(user, document_root)
        except Exception as e:
            logging.error("Unable to recreate token/storage for domain=%s, Error=%s", domain, e)
            continue

# CLOS-4642: reconcile dedicated LiteSpeed pools to the current isolated
    # docroots -- adds missing includes and sweeps stale ones for removed,
    # unresolvable, or deleted vhosts. Runs after tokens exist so a reload never
    # precedes a token. No-op off standalone LiteSpeed.
    try:
        litespeed.reconcile_dedicated_php_handlers(user, document_roots)
    except Exception:
        logging.exception(
            "Failed to reconcile LiteSpeed dedicated PHP handlers for %s", user)

# F-48 / CLOS-5435: defense-in-depth. If every enabled_websites entry
    # failed docroot resolution (e.g. the panel-side domain was just deleted
    # but is still listed in the CageFS user config), document_roots is
    # empty. Do NOT tail-call reload_processes_with_docroots with an empty
    # filter here -- there is nothing to reload, and the empty-filter path
    # is treated as "reload all isolated processes for this user", not
    # "reload every process this user owns".
    if not document_roots:
        # Post-review Bugbot LOW on !211: if the F-08 filter dropped
        # every isolated domain and no user has isolation left, stop
        # the docroot-monitor service — mirrors the same tail in
        # disable_website_isolation. Without this cagefs-docroot-monitor
        # can keep running with nothing to watch.
        if rejected_domains and not users_with_enabled_domain_isolation():
            stop_monitoring_service()
        return

reload_processes_with_docroots(user, filter_by_docroots=document_roots)

def disable_website_isolation(user: str, domain: str | None = None):
    if not user_exists(user):
        logging.warning(
            "User %s not found, cannot disable website isolation", user)
        return
    user_config = config.load_user_config(user)
    reload_docroots = None
    domains_to_unregister = []

if domain is None:
        domains_to_unregister = list(user_config.enabled_websites)
        reload_docroots = [
            _get_docroot_or_none(website) for website in user_config.enabled_websites
        ]
        user_config.enabled_websites = []
    elif domain in user_config.enabled_websites:
        domains_to_unregister = [domain]
        reload_docroots = [_get_docroot_or_none(domain)]
        user_config.enabled_websites.remove(domain)

config.save_user_config(user, user_config)
    write_jail_mounts_config(user, user_config)
    if reload_docroots:
        # CLOS-4642: reconcile dedicated LiteSpeed pools to the docroots that are
        # STILL isolated, BEFORE reloading workers (so respawned workers do not
        # re-enter a stale pool). Reconcile is robust to full teardown, docroots
        # shared by several domains, and docroots that no longer resolve.
        # No-op off standalone LiteSpeed.
        try:
            litespeed.reconcile_dedicated_php_handlers(
                user,
                [_get_docroot_or_none(d) for d in user_config.enabled_websites],
            )
        except Exception:
            logging.exception(
                "Failed to reconcile LiteSpeed dedicated PHP handlers for %s", user)
        reload_processes_with_docroots(user, filter_by_docroots=reload_docroots)
        for document_root in reload_docroots:
            if document_root is None:
                continue
            jail_utils.remove_website_token_directory(user, document_root)

for d in domains_to_unregister:
        try:
            _unregister_domain_lve(user, d)
        except (subprocess.CalledProcessError, OSError):
            logging.exception(
                "Failed to unregister domain LVE for %s, skipping.", d)

# get actual docroots for all users with website isolation enabled
    users_with_isolation = users_with_enabled_domain_isolation()
    if not users_with_isolation:
        stop_monitoring_service()

CANCEL