網路出口允許清單守衛

能連到任意主機的無人值守自動化是一種資料外洩風險。EgressPolicy 讓操作者釘選無頭 HTTP 用戶端可連線的主機。它會被每一次 http_request() 呼叫(因而也包含 AC_http 與所有以其為基礎的功能)所諮詢,因此鎖定出口即可一次涵蓋整個框架。

此策略支援**允許(allow)**清單(預設拒絕 —— 僅符合的主機可通過)與/或**拒絕 (deny)**清單(即使其他情況允許也封鎖)。樣式為對 URL 主機名稱進行不分大小寫的 fnmatch 萬用比對,例如 *.example.com 或 localhost。模組層級的策略以 allow-all 模式啟動,因此在操作者鎖定前**不會改變任何行為**。純標準函式庫,不匯入 PySide6。

無頭 API

from je_auto_control import set_egress_policy, EgressBlocked, http_request

set_egress_policy(allow=["*.internal.corp", "api.example.com"])

http_request("https://api.example.com/v1")     # 通過
try:
    http_request("https://evil.test/")          # 連線前即拋出
except EgressBlocked:
    ...

set_egress_policy(None, None)                    # 回到 allow-all

模式:allow=None 為 allow-all;``allow=[]`` 拒絕一切;單獨給 deny=[...] 僅封鎖那些主機。allow / deny 皆可接受清單或單一逗號分隔字串。 get_egress_policy().is_allowed(url) 可在不拋出例外的情況下檢查 URL; EgressPolicy(allow=..., deny=...) 則建立獨立的策略物件。

執行器指令

指令	效果
`AC_egress_allow`	將 HTTP 用戶端鎖定到 `allow` / `deny` 清單。
`AC_egress_check`	回報 URL 的 ``{allowed}``(不拋出例外)。
`AC_egress_reset`	將策略清回 allow-all。

相同操作亦提供為 MCP 工具(ac_egress_allow / ac_egress_check / ac_egress_reset),以及 Script Builder 中 Tools 分類下的指令。