Apache PLC4X 安全策略与威胁模型:漏洞报告流程、信任边界与 OT 协议安全边界解析
Apache PLC4X 安全策略与威胁模型:漏洞报告流程、信任边界与 OT 协议安全边界解析
Apache PLC4X 是一个面向工业 PLC 协议的多语言客户端库(Java / Go / C / Python),其安全策略的核心在于两条主线:一是遵循 ASF 流程的私密漏洞报告机制,二是以 THREAT-MODEL.md 为权威的威胁模型——它界定了哪些安全问题属于项目责任、哪些属于协议本身或集成方责任。读完本文,你将掌握 PLC4X 的漏洞报告路径、信任边界与攻防模型、OPC UA 默认安全配置(secure-by-default)的落地细节,以及作为集成方需要承担的 12 项安全职责与常见误用模式。
一、漏洞报告:遵循 ASF 安全流程,私密上报
报告入口与原则
PLC4X 的安全漏洞必须私下报告给 Apache 安全团队,邮箱为 security@apache.org,遵循 ASF 的官方安全流程(参见 security.adoc)。两条硬性要求:
- 不要通过公开的 GitHub Issue 或 Pull Request 提交安全漏洞——漏洞细节在修复前不应公开;
- PLC4X 不针对单个漏洞发布二进制补丁,修复方式是通过升级到已修复该漏洞的 Apache PLC4X 版本获取。
报告提交后,Apache 安全团队会依据威胁模型进行分流(triage)。需要注意的是,分流依据的是报告所针对的版本当时生效的威胁模型,而不是当前 HEAD 上的模型——威胁模型文档明确说明:"A vulnerability report against PLC4X release N is triaged against the model as it stood at N, not at HEAD."
报告会得到什么处置
每个报告只会收到以下处置结果之一(详见 THREAT-MODEL.md 的 §13 分流处置表):
| 处置 | 含义 | 依据 |
|---|---|---|
VALID |
违反 §8 安全属性(如线解析器内存安全 P4、OPC UA 安全通道 P1/P2/P7、KNX XXE 绕过 P6) | §8、§6、§7 |
VALID-HARDENING |
未违反 §8 属性,但可加固(如 OPC UA 运行 security-policy=NONE 时发出运行时警告) |
§11 |
OUT-OF-MODEL: trusted-input |
需要攻击者控制模型标记为可信的输入(连接 URL、认证对象、写入值、tag 地址、配置文件、端点选择) | §6、§3 第 12–13 条 |
OUT-OF-MODEL: adversary-not-in-scope |
需要模型排除的对手(嵌入应用本身、侧信道观察者、量子对手、OT 网络边界) | §7 |
OUT-OF-MODEL: unsupported-component |
落在 plc4c/、plc4py/、plc4net/、tools/、code-generation/、plc4j/utils/、模拟驱动、plc4x-extras 或支持表中无绿色对勾的驱动 |
§3 第 2、6、11 条 |
OUT-OF-MODEL: non-default-build |
仅在 §5a 中维护者判定为开发/测试用途的配置下出现(如显式 security-policy=NONE、tls.verify=false) |
§5a |
BY-DESIGN: protocol-disclaimed |
协议本身不提供的属性(一切"Modbus / S7 / BACnet 无认证"报告) | §9、§3 第 1 条、§11a |
BY-DESIGN: property-disclaimed |
库明确不提供的 §9 属性(内置 TLS 隧道、终端用户认证、API 层 DoS 防护) | §9 |
KNOWN-NON-FINDING |
命中 §11a 的重复误报清单 | §11a |
MODEL-GAP |
无法归入以上任何一类,触发 §12 模型修订 | §12 |
二、威胁模型全景:核心文档与项目定位
THREAT-MODEL.md 是 PLC4X 安全策略的主体,是一份由 ASF 安全团队起草、等待 PMC 评审的草案,当前状态为"draft",针对默认分支 develop 编写(首次起草基于 HEAD 32b4f0c,后于 2026-09-03 对照 SPI3 迁移、OPC UA secure-by-default 与解析器加固系列重新核验)。全文 51 条 (documented)、4 条 (maintainer)、45 条 (inferred),每个 (inferred) 标注都对应 §14 中一条待维护者确认的问题。
项目定位:客户端库,不是网络服务
- PLC4X 是进程内库(in-process library),嵌入到宿主应用(SCADA 网关、MES、历史数据库、工业 IoT 桥等)中使用,通过 URL 打开连接,例如
s7://10.0.0.5:102?remote-rack=0&remote-slot=1、modbus-tcp://10.0.0.5:502、opcua:tcp://10.0.0.5:12686?discovery=true&security-policy=Basic256Sha256; - PLC4X 只发起出站连接,主仓库中没有监听套接字。
plc4j/transports/下的传输层全部是客户端实现(tcp、udp、serial、raw-socket、pcap-replay、socketcan、can、virtualcan),没有任何 listener 传输(plc4j/transports/); - PLC4X 没有"终端用户"概念,会话即 PLC 连接。认证/授权、用户输入清洗等全部是嵌入应用的责任;
- 模型范围仅限主
apache/plc4x仓库(驱动层、SPI、传输层、代码生成运行时、四个语言绑定)。OPC-UA Server、PLC4X Server 及 Calcite/Camel/Kafka-Connect/Karaf/NiFi 集成发布在独立的plc4x-extras仓库,不在本模型范围内。仓库内的plc4j/tools/(连接缓存plc4j-tools-connection-cache、OPMplc4j-tools-opm、事件泵plc4j-tools-event-pump)属于本仓库,在范围内。
组件族清单
§2 组件族表将主仓库划分为十几个威胁画像各异的组件族,判断一个发现是否在模型内,就看它是否落在标记为"yes"的行上:
- Java 公共 API(
plc4j/api):纯分发,不出进程 —— 在模型内; - Java SPI/运行时(
plc4j/spi):编排层 —— 在模型内; - 各协议驱动(
plc4j/drivers/*):通过注册的传输层联网 —— 仅在协议支持表打绿色对勾的驱动在模型内; - 传输层(
plc4j/transports/*):TCP 为每个连接一个虚拟线程上的阻塞SocketChannel,TLS 为SSLSocket,另有 serial、libpcap 等 —— 在模型内; - OPC UA 安全子系统(
plc4j/drivers/opcua/.../security/、context/SecureChannel):证书验证器、安全策略协商、安全通道编解码 —— 在模型内且被单独区分; - 代码生成运行时(
plc4j/.../readwrite/、plc4go/protocols/、plc4c/generated-sources/):由远端 PLC 字节驱动 —— 与使用它的驱动同信任级别,在模型内; - Go / C / Python 绑定:与核心相同,但 C 与 Python 在 README 中声明"not ready for usage";
- .NET 绑定(
plc4net/):README 声明"not ready for usage - abandoned" —— 不在模型内; - PLC4X 代理驱动(
plc4j/drivers/plc4x):客户端侧在模型内,服务端在plc4x-extras不在模型内; - 模拟/模拟驱动(
plc4j/drivers/{simulated,mock}):无网络面,仅代码质量意义,非安全面; - 客户端工具(
plc4j/tools/):持有实时连接、凭据和连接字符串 —— 在模型内; - 审计日志(
plc4j/utils/audit-log/):向宿主文件系统写线缆流量痕迹 —— 在模型内(未配置路径时关闭); - 订阅仿真(
plc4j/utils/subscription-emulation):与所包装驱动同信任级别 —— 在模型内; - 代码生成工具(
code-generation/)、tools/、images/、media/、website/、Dockerfile等:构建期或文档/基础设施 —— 不在模型内。
三、范围之外:12 条显式非目标
威胁模型的 §3 给出了 12 条"明确不做"的边界,理解这些边界对集成方至关重要:
- 不为 OT 协议本身充当防守者:Modbus、S7(PUT/GET)、BACnet/IP、IEC-60870-5-104、Profinet、CANopen、KNXnet/IP、C-Bus、DF1、AB-Ethernet、ADS/AMS(未配置凭据流时)、EtherNet/IP、UMAS 作为协议标准不认证对端、不保护完整性、不加密。这是协议设计,不是库的选择。"线缆载荷是无认证明文"这类报告描述的是协议而非库 →
BY-DESIGN: protocol-disclaimed; - 不是任何受支持协议的服务器/应答方:服务/网关功能在独立的
plc4x-extras仓库 →OUT-OF-MODEL: unsupported-component; - 不对抗嵌入应用本身:嵌入应用提供的 URL、认证、tag 字符串、写入值都是被授权的 →
OUT-OF-MODEL: trusted-input; - 不为嵌入应用的终端用户提供防守:终端用户认证/授权是嵌入应用的责任 →
OUT-OF-MODEL: trusted-input; - 不是 tag 地址字符串的沙箱:解析器对畸形字符串提供的是"正确性边界"而非"安全边界" → 语法校验类报告为
OUT-OF-MODEL: trusted-input,解析器内存破坏/DoS 类为VALID; - 仓库中不属受支持产品的代码:
plc4c/、plc4py/README 标注"not ready for usage",plc4net/标注"abandoned" →OUT-OF-MODEL: unsupported-component; - PLC 设备固件、设备所在网络及设备控制的物理过程:设备侧漏洞属于 PLC 厂商上游;写入的物理后果(线圈打开泄压阀、设定值变更废掉一批料)属于集成方工艺设计 →
OUT-OF-MODEL: adversary-not-in-scope/trusted-input; - OT 网络分段、加固与入侵检测:假设嵌入应用部署在与 PLC 网络可达的位置,是否防火墙、气隙、IDS 监控是部署姿态 →
OUT-OF-MODEL: adversary-not-in-scope; - TLS / VPN / IPSec 隧道:PLC4X 对明文协议没有内置 TLS 或隧道层,"Modbus-TCP 应跑在 TLS 上"是集成方部署选择 →
BY-DESIGN: property-disclaimed; - 供应链/构建/发布卫生(Maven action 固定、签名、Jenkins 配置、依赖新鲜度、可复现构建)——不在模型内;
- 协议支持表中未标为完全支持的驱动:只有带绿色对勾的驱动/绑定组合在模型内。截至 2026-09-03,PLC4J 排除 BACnet/IP、CAN(raw)、C-Bus、ctrlX、DF1、Open-Protocol、Profinet;PLC4Go 额外排除 AB-Ethernet、CANopen、Firmata、OPC-UA、Open-Protocol、PLC4X 代理协议、Profinet。PLC4J 中这类驱动还带
maven.deploy.skip,不会发布到 Maven Central。注意:Go 的 OPC UA 驱动标为部分支持因此不在模型内,而 Java 的 OPC UA 驱动全量在模型内,包括所有 §8 属性; - 错误的/损坏的/恶意的配置文件:
.knxprojETS 项目、BACnet EDE 文件、Profinet GSDML 目录、密钥库/信任库、server-certificate-file、pcap-file、事件泵作业配置,都从可信调用方(B1)而非线缆(B2)到达 →OUT-OF-MODEL: trusted-input,按普通健壮性 bug 处理。但两个例外是VALID:ETS 解析器中 XXE/外部 DTD/外部 schema 已禁用(绕过它即VALID),以及单条.knxproj条目膨胀无上限(VALID)。
四、信任边界与数据流:B1 / B2 / B3 / B4
PLC4X 有两条主要信任边界加一条 OPC UA 可选加密边界。一个发现只有在能干净地映射到其中一条时才算在模型内。
| 边界 | 转换 | 认证 | 授权 | 备注 |
|---|---|---|---|---|
| B1 | 嵌入应用 → PLC4X API 面 | 构造上可信 | API 调用者可信 | URL 字符串、PlcAuthentication、tag 地址字符串、写入值 |
| B2 | PLC4X 驱动 → 远端 PLC(线缆) | 无——协议设计如此 | 线缆上无;嵌入应用自行强制 | OT 网络边界是唯一安全控制;返回驱动的线缆字节是进入解析器的不可信输入 |
| B2-OPCUA | OPC UA 驱动 → OPC UA 服务器(加密策略) | 服务器证书按信任库校验(tls.trust-store);客户端证书可选;用户名/密码或令牌走加密通道 |
服务器侧 ACL | 高安全策略下双向证书认证 + 加密 |
| B2-OPCUA-PERMISSIVE | OPC UA 驱动 + tls.verify=false |
服务器证书不校验,安装 PermissiveCertificateVerifier 并记录警告 |
n/a | 不再是默认;默认 tls.verify=true 且无信任锚时安装 RejectingCertificateVerifier,连接失败关闭 |
| B2-ADS | ADS 驱动 → Beckhoff TwinCAT(带凭据的 AMS 路由) | 提供 PlcUsernamePasswordAuthentication 时用用户名/密码建立 AMS 路由 |
TwinCAT 侧 | 凭据转发给设备;ADS 载荷本身是无认证明文 |
| B3 | PLC4X 传输层 → 宿主 OS/NIC/串口/libpcap | OS 级 | OS 级 | raw-socket 传输在 Linux 需要 CAP_NET_RAW |
| B4 | 代码生成运行时 → 操作系统(构建期) | n/a——仅开发者运行 | n/a | 构建期,不在部署产物中 |
可达性前提(§4)
每个组件族内的发现必须满足特定的可达性条件才在模型内:
- 逐协议驱动、生成的
readwrite/解析代码、OPC UA 安全子系统:可从远端 PLC(或 OT 网络上攻击者)经配置的传输层返回的字节到达。解析器/解码器不得破坏宿主内存、不得无限循环、不得无界分配、不得因对抗性输入导致进程崩溃——"这是本文档中最重要的可达性边界,现实中绝大多数 PLC4X 侧漏洞将是线缆解析器 bug"; - 公共 API / SPI:从嵌入应用的调用到达;
- tag 地址解析器(各驱动
*TagHandler、parseTagAddress):从嵌入应用传入的 tag 地址字符串到达。导致内存破坏或挂起的解析器 bug 仍为VALID-HARDENING(若嵌入应用确实传入用户可控字符串则为VALID); - 传输层:从 OS 经套接字/串口/libpcap 捕获文件交付的字节到达,畸形组帧的内存安全在模型内;
- OPC UA 安全子系统:从证书链、安全令牌、签名握手消息到达。此处的发现权重高于明文协议驱动的等价发现——OPC UA 驱动是仓库中唯一"承诺"加密属性的地方。
五、环境假设:从 JVM 到文件系统
运行时与并发(§5)
- OS:Linux 为主(Ubuntu / RHEL 系),Windows / macOS 支持 Java;ARM 与 x86 均支持。Java 21 最低,测试至 Java 24(README.md);
- 进程模型:进程内库。PLC4X 以 JAR(或 Go module、Python wheel)加载进嵌入应用,通过 Java SPI 机制注册驱动,无自有的常驻守护进程;
- 网络:按所选驱动需要出站 TCP / UDP / raw-socket / SocketCAN / serial。端口按协议:502/Modbus-TCP、102/S7、47808/BACnet、44818+2222/EtherNet-IP、4840+动态/OPC UA、2404/IEC-60870-104、3671/KNXnet/IP 等。OT 网络假定由集成方作为被防守的边界运营;
- 并发(SPI3 之后):Netty 已移除。Java 传输层是纯 JDK 套接字——TCP 为每个连接一个虚拟线程上的阻塞
SocketChannelI/O(无 NIO selector、无就绪事件循环),TLS 为SSLSocket,运行时类路径上不再有io.netty制品(参见 plc4j/transports/tcp/)。read/write/subscribe/browse调用仍返回CompletableFuture;等待每连接许可的请求被排队而非挂起提交线程; - 密码学(仅 OPC UA):JVM 自带的 JCE provider(OpenJDK / Oracle / IBM)提供 AES、RSA、RSASSA-PSS、HMAC-SHA1/256、X.509 解析;
- 文件系统(OPC UA):从操作员配置的路径加载 keystore 与 truststore;
- 文件系统(KNX):
.knxprojETS 文件以 XML 解析,显式禁用 XXE / 外部 DTD / 外部 schema。见 EtsParser.java(ACCESS_EXTERNAL_DTD/ACCESS_EXTERNAL_SCHEMA置空、disallow-doctype-decl与FEATURE_SECURE_PROCESSING开启)。自 2026-08-24 起解析器还限制单个 zip 条目可膨胀的大小,并清理解包内容; - 文件系统(审计日志):设置
audit-log-file连接字符串参数后,驱动将请求/响应痕迹写入宿主上的滚动文件(plc4j/utils/audit-log/)。未设置路径则关闭。启用时文件包含载荷字节与连接元数据,§5a 的脱敏规则适用于呈现内容,但痕迹本身是静态的工厂数据,权限与生命周期由集成方负责。
PLC4X 对宿主"不做"的事(负面声明)
- 不安装信号处理器(除 Netty/JVM 代其安装的);
- 不在运行时派生子进程;
- 不打开监听套接字——所有套接字均为出站;
- 只读取一个改变安全相关边界的环境变量:
PLC4X_MAX_NESTING_DEPTH,用于调整四种绑定中解析消息类型嵌套的 1024 层上限(实现见 plc4j/spi/、plc4go/spi/utils/、plc4py/、plc4c/spi/)。非正数会保留默认值并告警; - 不在运行时变更进程级全局状态(分配器、locale、
System.setSecurityManager等); raw-socket传输确实需要CAP_NET_RAW(Linux)/ Administrator(Windows)/ 等价 root 权限——这是一个特权传输,选择它的嵌入应用承担宿主机级代价。
六、安全相关配置旋钮与 OPC UA 默认值(§5a)
PLC4X 暴露的是逐驱动的配置旋钮而非单一全局开关。以下是默认值会实质改变安全包络的关键旋钮:
| 旋钮 | 默认 | 维护者立场 | 效果 |
|---|---|---|---|
OPC UA security-policy |
Basic256Sha256 |
加固默认——NONE 现在需显式选择 |
NONE 意味着通道既不签名也不加密、服务器完全未认证,使 B2-OPCUA 塌缩为 B2。请求它是刻意行为,没有任何东西会降级到它 |
OPC UA message-security |
SIGN_ENCRYPT |
加固默认 | 非 NONE 时强制签名加加密;改 SIGN(签名明文)或 NONE 会削弱通道 |
OPC UA tls.trust-store |
未设置 | 失败关闭——无信任锚时连接被拒绝而非被接受 | 验证器选择顺序:tls.verify=false → PermissiveCertificateVerifier(告警);tls.trust-store 已设 → TrustStoreCertificateVerifier(链校验);server-certificate-file 已设 → PinnedCertificateVerifier(精确证书);否则 → RejectingCertificateVerifier,握手无信任锚即失败 |
OPC UA tls.verify |
true |
加固默认——校验开启,仅可退出 | 关闭则安装宽松验证器并记录告警。取代了旧 insecure-certificate-verification,语义相反:旧配置 insecure-certificate-verification=true 现在必须设 tls.verify=false |
OPC UA tls.keystore / tls.keystore-password / tls.keystore-type |
未设置;tls.keystore-type 为 pkcs12;generated-key-size 为 2048 |
稳定客户端身份需操作员提供 | 未设置时驱动生成自签名应用实例证书:自 2026-08-14 起 SHA-256 签名、带正 16 字节序列号、标记为端实体并带 OPC UA Part 6 密钥用途与主题密钥标识符。但每次启动都会重新生成,无法满足要求已知客户端身份的服务器 |
OPC UA discovery |
true |
默认开启;发现阶段仍以 NONE 策略进行(OPC UA 规范如此) |
自 2026-08-24 起驱动拒绝继续进入比所配置 security-policy 更弱的通道,发现期间学到的证书绝不作为自身信任锚 |
OPC UA username / password |
未设置;allow-insecure-credentials 为 false |
操作员提供;驱动拒绝将密码放到不受保护的通道上 | 作为 OPC UA UserIdentityToken 转发,用服务器用户令牌策略命名的算法加密;allow-insecure-credentials=true 则照发并告警 |
| OPC UA 各类超时 | 1h / 5s / 2min / 60s / 30s | 合理默认 | DoS/超时调优面,非安全边界 |
| OPC UA browse 上限 | 65536 / 1000000 / 64 | 默认有界;0 禁用 |
限制敌意/损坏服务器一次 browse 的内存与时间成本 |
TLS 传输 tls.verify / tls.ignore-common-name / tls.trust-store |
true / false / 未设置 |
自 2026-08-24 加固 | 传输层现检查服务器证书是否签发给所连接的主机;ignore-common-name=true 恢复旧行为并告警 |
ADS PlcUsernamePasswordAuthentication |
未设置(无 AMS 路由建立) | 操作员提供 | 提供时驱动用 HTTP 式凭据对 TwinCAT 系统做 AMS 路由注册;PLC4X 不在线缆上保护这些凭据 |
KNX .knxproj 解析器 |
XXE / 外部 DTD / 外部 schema 已禁用 | 加固——安全默认的典型 | ".knxproj 解析存在 XXE"类报告为 KNOWN-NON-FINDING |
OPC UA 默认值落定(2026-08-24——默认即安全)
更早的文档版本曾将 OPC UA 驱动的默认值描述为"开发/实验级":security-policy=NONE、无证书校验、发现阶段会静默继续到不受保护的通道。这些描述在当时是准确的,但已不再是代码的现状。§14 Q14/Q15 裁定以默认即安全(secure-by-default)方向解决并已实现:
security-policy默认Basic256Sha256且message-security=SIGN_ENCRYPT,除非显式要求NONE,通道即签名且加密;tls.verify默认true,无信任锚时驱动安装RejectingCertificateVerifier——连接失败关闭而非信任任意到达的证书。PermissiveCertificateVerifier仅在tls.verify=false时可达,且会记录指明风险的警告;- 驱动拒绝接受比所配置更弱的通道——未认证的发现阶段不能再把不受保护的会话交还给要求受保护会话的连接;
- 端点必须同时匹配所请求的安全策略与消息安全模式,且选择最强匹配端点而非最弱——服务器在受保护端点旁发布全开放端点时,现在会走受保护端点;
- 用户名与密码不会被放到既不签名也不加密的通道上,除非
allow-insecure-credentials=true。
这一落定在 OpcuaConfiguration.java 中可见:security-policy 的默认值注解为 @StringDefaultValue("Basic256Sha256"),message-security 为 @StringDefaultValue("SIGN_ENCRYPT");验证器选择逻辑实现在 OpcuaDriverContext.java 的 buildCertificateVerifier 中,默认字段即 new RejectingCertificateVerifier()。
对 §13 的后果:报告"OPC UA 驱动接受攻击者出示的证书"是 VALID(描述对已发布默认值的回归);而"OPC UA 驱动默认未加密/未认证"现在是 KNOWN-NON-FINDING(描述代码已离开的状态)。请核对报告针对的发布版本。
七、输入信任假设(§6)
公共 API 逐入口点信任表
| 入口点 | 参数 | 攻击者可控? | 调用方必须强制 |
|---|---|---|---|
PlcDriverManager.getConnection(url, [auth]) |
url |
否——可信调用方字符串 | 只让格式良好的 URL 到达此方法;不要让终端用户构造 URL |
PlcDriverManager.getConnection(url, auth) |
auth(PlcAuthentication) |
否——可信调用方对象 | auth 中的凭据转发给协议(明文,除非在 OPC UA 安全通道内) |
connection.parseTagAddress(addr) |
addr |
条件性——默认可信;若嵌入应用从终端用户获取 tag 字符串,则嵌入应用负责 | tag 地址语法校验;不传未审的不可信字符串 |
readRequestBuilder.addTagAddress(name, addr) |
addr |
条件性——同上 | 同上 |
writeRequestBuilder.addTagAddress(name, addr, value) |
value |
否——可信调用方值 | 对哪些 tag 可被写入做应用级授权 |
subscriptionRequestBuilder.add*(addr, ...) |
addr |
条件性——同上 | 同上 |
线缆字节信任表
| 表面 | 攻击者可控? | 驱动必须强制 |
|---|---|---|
| 明文 OT 协议响应(Modbus、S7、BACnet/IP、IEC-60870-104、Profinet、CANopen、KNXnet/IP、C-Bus、DF1、AB-Ethernet、ADS 载荷、EtherNet/IP、UMAS) | 是——OT 网络上任何可达者都可伪造 | 畸形输入上的内存安全、有界分配、无无限循环、无无界递归——但不含真实性、完整性或载荷语义保证 |
| 安全通道内的 OPC UA 线缆帧 | 是——但由协商策略签名/加密(策略 ≠ NONE 时) |
同上,外加:协商策略下签名与 MAC 校验正确、解密正确、分块重组正确 |
发现阶段的 OPC UA 帧(security-policy=NONE) |
是 | 畸形响应的内存安全;发现握手本身不被认证 |
| OPC UA 服务器证书(握手期间出示) | 是 | tls.trust-store → 按 JCE 规则做 X.509 链校验;server-certificate-file → 出示证书必须等于所钉证书;两者皆无且 tls.verify=true(默认)→ 拒绝;tls.verify=false → 无校验 |
| 串行线路帧 | 串行通道可被攻击者触达时是 | 畸形组帧的内存安全 |
| libpcap 捕获/重放帧 | 否——操作员经 B1 提供 | pcap-replay 是开发/测试工具 |
ETS .knxproj XML |
否——操作员经 B1 提供 | XXE / 外部 DTD / 外部 schema 保持禁用,逐条目膨胀上界保持强制,绕过任一项即 VALID |
| BACnet EDE 文件 | 否——操作员经 B1 提供 | 解析器健壮性按普通正确性处理;有界文件导致无界分配仍为 VALID |
尺寸/形态/速率
- 驱动对流式处理单个请求/响应帧。2026 年 8 月加固系列加入了明确边界:四种绑定中所有生成解析器的1024 层类型嵌套上限(
PLC4X_MAX_NESTING_DEPTH可调整)、OPC UA browse 上限、模拟驱动每个 tag 16 MiB 预算、tag 地址可命名的元素数上限、传输层等待帧长度前的合理性检查、raw-socket 捕获队列上界。无法推进的解析器现在会报告而非循环; - API 侧无逐调用限流或背压——若嵌入应用热循环调用
read,驱动会发出传输层允许的尽可能多的请求(§14 Q19 待确认,维护者已确认无 API 级限流)。
八、对手模型(§7)
行动者清单
| 行动者 | 在范围内? | 被授予的能力 |
|---|---|---|
| 可触达 PLC 的网络对端(OT 网络) | 是——B2 的主要对手 | 可读、改、丢、重放或注入明文协议的帧。配置了信任库的 OPC UA 对端受密码学原语约束;tls.verify=false 时可 MITM;默认 tls.verify=true 时无信任锚的连接失败关闭 |
| 驱动与 OPC UA 发现端点之间的网络对端 | 是 | 发现握手按规范未加密;对端可替换通告的端点 URL、证书或受支持策略集合 |
| 真实 PLC 固件发出的畸形但可解析响应作者(有缺陷或被攻陷的固件) | 是——线缆解析器健壮性必须成立 | 使驱动解析对抗性字节;对内存安全、挂起、无界分配在模型内 |
畸形 .knxproj 或 BACnet EDE 文件作者 |
是(针对解析器健壮性) | 使离线文件解析器崩溃、挂起或逃出预期沙箱(XXE 已按 §5a 阻断) |
| 嵌入应用本身 | 范围外——§3 第 3 条 | 构造上可信 |
| 嵌入应用的终端用户 | 范围外——§3 第 4 条 | PLC4X 没有终端用户概念 |
| PLC 设备操作员 | 范围外 | 驱动对话的设备就是该设备 |
| tag 地址字符串作者 | 条件性在范围内——§3 第 5 条 | 嵌入应用决定是否暴露此表面 |
| 侧信道观察者(缓存时序、分支预测、OPC UA 密码运算网络时序) | 范围外 | 标准 JCE 侧信道姿态;无 PLC4X 级常数时间保证 |
| 量子对手 | 范围外 | OPC UA 安全策略使用经典 RSA / AES / SHA |
已认证但拜占庭的对端
PLC4X 是客户端库,内部没有可拜占庭的"集群成员"。最接近的类比是固件被攻陷、但在协议提供的认证下发送精心构造响应的 PLC 设备。对明文协议这与线上任何攻击者无异;对 OPC UA 即"被攻陷但证书正确"的服务器——即使通道密码学上健全,驱动仍信任服务器的数据声明。需要被攻陷 PLC 产生错误测量值的发现是 OUT-OF-MODEL: trusted-input;需要被攻陷 PLC 通过畸形线缆字节使驱动崩溃或损坏的发现,对内存安全在模型内。
九、项目提供的安全属性(§8)
P1 — OPC UA 安全通道机密性与完整性(配置后)
- 条件:
security-policy为Basic128Rsa15、Basic256、Basic256Sha256、Aes128_Sha256_RsaOaep或Aes256_Sha256_RsaPss之一(策略枚举见 SecurityPolicy.java),且message-security为SIGN或SIGN_ENCRYPT(默认SIGN_ENCRYPT),且配置了信任锚(tls.trust-store或server-certificate-file); - 违反症状:路径攻击者可解密(无配置密钥)或修改而不被检测的线缆字节;
- 严重性:安全关键,
VALID。
P2 — OPC UA 服务器证书认证(配置信任库时)
- 条件:配置信任锚。
tls.verify为默认且两者皆未设置时,驱动拒绝所有服务器证书——失败模式是拒绝连接而非未验证连接; - 违反症状:驱动与出示无法链到信任库根证书的服务器完成握手并继续交换应用层消息;
- 严重性:安全关键,
VALID。
P3 — Java 公共 API 与 SPI 在格式正确的嵌入应用调用上的内存安全
- 违反症状:按文档正确调用却出现
NullPointerException/IllegalStateException(Java 有 GC 不会 JVM 崩溃);Go 绑定从无unsafe的调用点 panic;plc4c原生崩溃; - 严重性:非驱动代码仅正确性;可经 B2 到达的驱动路径为安全关键。
P4 — 线缆解析器在对抗性线缆字节上的内存安全、有界分配、有界循环/递归
- 条件:解析器经 B2 从远端 PLC 或 OT 网络上攻击者可达;
- 违反症状:Java——有界输入膨胀导致堆耗尽、构造输入导致解析器挂起、嵌套线缆结构导致无界递归
StackOverflowError;Go——goroutine 挂起、无界分配;C——堆/栈损坏、越界读写、释放后使用; - 严重性:安全关键(OT 网络是 §7 主要对手),
VALID; - 现状:仍是扫描目标最可达的 §8 属性,但已非未经验证的抱负:四种绑定中所有生成解析器拒绝超过 1024 层类型嵌套;Java 与 Go 测试套件解析测试套件每条消息的每个截断,所以提前中断的消息是报告出的解析失败而非挂起/越界读/半构建对象;无进展的手工数组会终止;通告的可选字段必须实际存在;解析器逃逸的未检查异常被包含在接收路径中而非终结拥有通道的线程。
P5 — tag 地址解析器对调用方提供的地址字符串的正确性与有界资源使用
- 违反症状:解析器对语法畸形地址崩溃/挂起/无界分配;跨驱动干扰(驱动 A 的地址字符串导致驱动 B 可观察状态变化);
- 严重性:默认
VALID-HARDENING(地址字符串按 §6 可信);解析器可从无界用户输入字符串到达 且 嵌入应用文档化用法包含该情形时VALID。
P6 — KNX .knxproj 解析器中 XXE / 外部 DTD / 外部 schema 已禁用
- 违反症状:
EtsParser中 XML 处理器解析外部实体/外部 DTD/外部 schema,允许从.knxproj造成文件泄露/SSRF; - 严重性:安全关键,
VALID; - 实现见 EtsParser.java。此外解析器限制单个 zip 条目可膨胀的大小,并清理解包内容。
P7 — OPC UA 安全通道实现遵循 OPC UA 规范的安全策略 URI
- 违反症状:规范合规的服务器拒绝驱动握手;驱动以比 URI 更弱的策略完成握手;驱动选择不在策略算法集内的算法;
- 严重性:安全关键,
VALID。文档声明与 Eclipse Milo 与 OPC Foundation .NET 的兼容性,对这两类参考服务器的属性破坏即 §8 P7 违反。
十、项目不提供的安全属性(§9)——集成方最需要读的一节
通用声明
- Modbus、S7、BACnet/IP、IEC-60870-5-104、Profinet、CANopen、KNXnet/IP、C-Bus、DF1、AB-Ethernet、EtherNet/IP、UMAS、ADS/AMS 线缆流量无真实性、完整性或机密性。PLC4X 按协议标准实现,协议本身没有这些属性;
- 无内置传输层隧道。不透明地把明文协议包进 TLS / VPN / IPSec / Wireguard。集成方想要加密的 Modbus 必须自己把它放进隧道;
- 明文协议无重放防护。驱动在 t 发送的请求可被攻击者在 t+δ 重放;PLC4X 不自行添加 nonce/序列检查;
- 不认证嵌入应用的终端用户;
- 不授权嵌入应用可读写哪些 tag——嵌入应用拥有该决定。目标协议有自己的权限系统时,PLC4X 代理它(把检查推迟给目标 PLC 并把权限错误转发回客户端),但自身不提供权限系统;
- 不防御畸形
.knxprojZIP slip、BACnet EDE 畸形文件健壮性或操作员提供路径中的路径遍历。文件路径是调用方提供的;XML XXE 是唯一显式加固的攻击类; - API 面无 DoS 防护。嵌入应用被信任以合理速率调用 API;
- 无静态数据加密。PLC4X 运行时自身不向磁盘持久化任何东西(审计日志特性把调试数据写入文件系统,用于临时调试而非长期运行,无加密;生产启用是操作员选择);
- 无认证秘密的常数时间比较;
- 不防御 OPC UA 密码运算的侧信道观察;
- 不防御固件被攻陷的 PLC 发送规范合规但语义错误的数据——垃圾进垃圾出。
假朋友属性(单独点名)
- "OPC UA 已加密"——自 2026-08-24 起默认成立,但仅在命名信任锚后成立。驱动默认
security-policy=Basic256Sha256、message-security=SIGN_ENCRYPT、tls.verify=true。但无法为操作员提供的是信任锚:未配置则连接被拒绝而非以未验证状态完成。残留的假朋友是旧问题的镜像——security-policy=NONE与tls.verify=false仍可表达、仍有文档,携带任一项的配置都不具备这些属性; - OPC UA 发现按规范未加密。发现按
security-policy=NONE进行,路径攻击者可改写通告的端点、证书与策略。这不是 PLC4X bug,是 OPC UA; - Modbus / S7 PUT-GET / EtherNet-IP / ADS 等跑在 TCP 端口上不等于安全。传输级加密缺失,协议级加密缺失,协议规范认证要么缺失(Modbus)要么弱(S7 PUT/GET)要么设备特定(ADS/AMS 路由);
simulated://、mock://驱动是开发工具不是沙箱;pcap-replay传输是开发/回归测试工具,不面向生产;plc4c/、plc4py/、plc4net/被 README 标注 "not ready for usage";- ADS / OPC UA 上的
PlcUsernamePasswordAuthentication按协议要求在线上携带凭据——它是包着两个字符串的类型化包装器,转发给协议的认证步骤,不是 PLC4X 级安全原语。是否加密取决于其余配置; PlcCertificateAuthentication包装内存中的 KeyStore 做基于证书的认证;周围 TLS/OPC UA 通道的安全属性仍然适用。
针对此类项目且 PLC4X 不防御的已知攻击类
- 明文 OT 协议上的 MITM——§3 第 1 条,模型外;
- OT 命令重放(重放录制的"开阀"帧)——§3 第 1 条,模型外;
- 伪造 Modbus 主站 / S7 PG / BACnet 主站——§3 第 1 条,模型外;
.knxprojZIP 中的压缩/解压炸弹——解压步骤的 ZIP slip 待确认(§14 Q18);.knxproj中的 XML 十亿笑——已被FEATURE_SECURE_PROCESSING缓解 →KNOWN-NON-FINDING;- OPC UA 发现通道 MITM——§9 假朋友第 2 条,模型外;
tls.trust-store未设置(默认)时 OPC UA 服务器证书替换——已由 2026-08-24 的失败关闭默认解决;- 无界 tag 列表
read/subscribe请求的 DoS——§9 "API 面无 DoS 防护",模型外; - 针对攻击者控制或被攻陷 PLC 构造响应时的逐协议线缆解析器内存损坏——这在模型内(§8 P4),是真实发现最可能的类别。
十一、集成方责任清单(§10)——生产部署必读
在生产中部署 PLC4X 的嵌入应用/集成方必须:
- 对每个明文协议把 OT 网络当作安全边界。在 OT VLAN 上、防火墙后、无不可信网络出口、理想情况下有监控地运行 Modbus、S7、BACnet/IP、IEC-60870-104、Profinet、CANopen、KNXnet/IP、C-Bus、DF1、AB-Ethernet、EtherNet/IP、UMAS 与 ADS/AMS 载荷流量。PLC4X 按设计不为这些协议提供传输安全(§9);
- 明文协议必须穿越敌意路径时,部署外部隧道(站点到站点 VPN、IPSec、stunnel/TLS 包装代理,或仅在点到点蜂窝调制解调器通道内运行明文协议)。PLC4X 不捆绑此类隧道;
- 生产环境的 OPC UA:命名信任锚。通道默认已签名加密,但驱动无法知道该信任哪台服务器:配置持有预期服务器证书或其签发 CA 的
tls.trust-store,或用server-certificate-file精确钉住一张证书。两者皆无则连接被拒绝——这是预期行为而非缺陷。不要为了绕过而用tls.verify=false,那是开发/实验逃生门,会完全禁用检查; - 服务器认证其客户端的 OPC UA:预置客户端密钥对并经由
tls.keystore/tls.keystore-password加载(配合tls.keystore-type,以及服务器要求 4096 位密钥时的generated-key-size)。未配置密钥库时驱动生成的自签名证书现在格式上足以让服务器接受,但每次启动重新生成,无法满足要求稳定客户端身份的服务器。服务器要 X509 用户身份而非用户名密码时,用PlcCertificateAuthentication提供; - 发现路径敌意的 OPC UA:禁用
discovery并显式配置endpoint-host、endpoint-port。发现握手按 OPC UA 规范未认证; - tag 地址字符串来自终端用户时,先审查再传给 PLC4X。PLC4X 不对攻击者提供的 tag 地址字符串提供安全边界(§3 第 5 条);
- 在嵌入应用内授权哪个终端用户可读/写哪些 tag。PLC4X 没有终端用户身份;
- 需要抵抗异常调用者的 DoS 时,在嵌入应用侧限制请求速率/队列深度。PLC4X 无 API 级节流(§14 Q19,维护者已确认);
- 以所选传输要求的最小宿主权限运行嵌入进程。多数传输仅需非特权用户;
raw-socket需要CAP_NET_RAW(或 Administrator)——把它授予嵌入进程本身,而不是以root运行; - 把
simulated://、mock://、pcap-replay驱动当作开发/测试夹具而非生产端点; 10a. 设置了audit-log-file时,保护其写出的文件。审计日志把请求与响应痕迹——工厂数据,以及载荷携带的一切——写入宿主上的滚动文件。只给嵌入进程可读的路径和保留策略。未配置即关闭(plc4j/utils/audit-log/README.md); - 在 README 的 "not ready for usage" 行移除前,不要在生产部署
plc4c/、plc4py/、plc4net/制品; - 对 PLC 固件的信任程度不超过集成方对该设备的独立信任。PLC 返回值是设备侧可信输入(§3 第 7 条)——但畸形线缆字节的固件仍在解析器健壮性(§8 P4)的模型内。
十二、已知误用模式与重复误报
误用模式(§11)
- 把嵌入应用进程直接暴露给不可信网络,并指望 OT 协议"认证"成立——明文协议没有认证,OT 网络边界(§10 第 1 条)是唯一控制;
- 生产环境请求
security-policy=NONE——不再是默认但仍可表达,携带它的配置有不签名不加密的通道; - 为让连接起来而动用
tls.verify=false——失败关闭默认诱发的形态;正确做法是命名tls.trust-store或server-certificate-file; - 在需要它的设备之外继续携带 TLS 传输的
ignore-common-name=true——接受为任何其他主机签发的证书; - 把
discovery=true当作安全边界的一部分——发现按 OPC UA 规范走NONE; - 在生产代码路径用
simulated:///mock://——它们是开发工具; - 把终端用户提供的 tag 地址字符串直接传给
parseTagAddress——解析器 bug 变成用户可达 bug; - 生产部署
plc4c/或plc4py/制品——README 已标注; - 在没有底层 TLS / OPC UA 安全通道时依赖
PlcCertificateAuthentication——KeyStore 存在、凭据在那,但线上是否真的加密取决于周围配置; - 生产 JVM 里带
--add-exports jdk.compiler/...运行——那些标志是给构建用的(README.md),运行时授予它们会不必要地暴露 JDK 内部; - 把嵌入应用捆绑进 OT 网段的单一主机并假设"在防火墙后所以没问题"——PLC4X 不校验自己的出站流量完整性,被攻陷的带 PLC4X 的主机可向任何可达 PLC 写任意值。
重复误报清单(§11a)——自动化扫描最高杠杆的输入
协议设计性非发现:"Modbus 线上无认证"、"Modbus 明文传输"、"S7 PUT/GET 命令不认证主站"、"BACnet/IP 无认证/完整性/机密性"(BACnet/SC 是不同协议,不在 PLC4X 中)、"IEC-60870-5-104 明文无认证"(IEC-62351 是安全覆盖层,不在 PLC4X 中)、"Profinet IO 帧无认证"、"CANopen/SocketCAN 帧无认证"、"KNXnet/IP/KNX Tunnelling 无认证"(KNX Secure 未实现)、"C-Bus / DF1 / AB-Ethernet / EtherNet/IP(经典 CIP) / UMAS / ADS/AMS 载荷 / Open-Protocol 全部无认证明文"、"Firmata 是串口协议无认证"——全部 → BY-DESIGN: protocol-disclaimed。
驱动默认性非发现:"OPC UA 驱动接受任意服务器证书"——对任何默认都不再成立,描述旧行为对当前代码的报告是 KNOWN-NON-FINDING,证明当前代码在默认下仍接受攻击者证书的报告是 VALID;"OPC UA 驱动默认未加密 / security-policy=NONE"——已过时,KNOWN-NON-FINDING;"未配置信任库时 OPC UA 连接失败"——按设计工作,失败关闭正是要点,不是推荐 tls.verify=false 的理由;"OPC UA 驱动明文做发现"——规范如此;"OPC UA 驱动自动生成自签名客户端证书"——文档化行为,是"跑通即可"的便利且每次启动重新生成,生产应预置显式证书。
代码库非发现:"KNX 解析器存在 XXE / 外部 DTD / 外部 schema 处理"——已禁用;"plc4j/utils/test-utils/、tests/、testdata/、simulated://、mock:// 驱动中的硬编码密码/令牌"——测试基础设施;"plc4c/ / plc4py/ / plc4net/ 中的密码学发现"——README 标注未就绪;"驱动 X 处理畸形帧不当 / 泄漏套接字",其中支持表未给该绑定绿色对勾——声明为部分支持,PLC4J 中不发布到 Maven Central;"code-generation/ mspec 编译器有 X"——仅构建期;"Dockerfile / docker-compose.yaml / Jenkinsfile 有 X"——仓库基础设施;"OPC-UA Server / PLC4X Server / Calcite / Camel / Kafka-Connect / NiFi 适配器有 X"——在 plc4x-extras;"内嵌 Eclipse Milo / Netty 有 CVE-Y"——两者都不再是依赖:OPC UA 驱动自 0.9.0 起原生,Netty 随 SPI3 传输层离开,运行时类路径无 io.netty 制品(2026-09-03 核验);"依赖 X(Jackson、commons-*、Bouncy Castle 等)有 CVE-Y"——上报上游,PLC4X 通过依赖版本升级获取修复。
操作员输入非发现:"损坏/截断/手工编辑的 .knxproj 使 KNX 驱动抛异常"——文件来自操作员经 B1;例外保持:从该文件解析出的实体,或无界膨胀的条目,是 VALID(§8 P6);"畸形 EDE 文件 / GSDML 目录 / pcap 捕获 / 密钥库使驱动失败或产生错误 tag"——同形态同答案;"我把驱动指向我控制的服务器,它信了服务器的话"——错误值、伪造 browse 树、声称不具有类型的控制器:操作员选择了端点,OUT-OF-MODEL: trusted-input;这些字节对解析器做了什么则不同,保持 VALID(§8 P4),拒绝本应拒绝的证书的 OPC UA 通道也是(§8 P1、P2);"驱动把配置的凭据发给连接字符串命名的任何主机"——那正是功能。
集成方部署非发现:"PLC4X 以 root 运行"——PLC4X 不要求 root,是嵌入应用选的 UID;"PLC4X 可从互联网触达"——PLC4X 不绑定监听套接字,"可触达"意味着嵌入应用可触达;"PLC4X 写控制物理泄压阀的 Modbus 线圈"——集成方授权了 API 调用,物理后果在集成方侧。
十三、模型修订条件与处置机制
何时修订模型(§12)
以下任一情况落地即应修订本文档:
- 新协议驱动获得内置传输安全层(如 Modbus-Security、带安全的 OPC UA Pub-Sub、KNX Secure、BACnet/SC);
- 新传输获得监听套接字能力(会把 PLC4X 从纯客户端变为客户端/服务器);
- 任何 §5a 旋钮的默认值变化——尤其是 OPC UA
security-policy、tls.trust-store、message-security; plc4c/、plc4py/、plc4net/的 "not ready for usage" README 标记被移除;- 支持表中驱动格子变为/离开绿色对勾(PLC4J 的 POM 中
maven.deploy.skip需同步); - 与
plc4x-extras的边界移动(连接缓存、OPM、事件泵已在plc4j/tools/,曾发生过一次文档未跟随); plc4j/下出现或消失模块族;- 传输栈形态变化(SPI3 中从 Netty 移向虚拟线程阻塞 I/O,使 §5 并发文本失效);
- 驱动开始把 §3 第 12 条的某个操作员文件当作不可信输入(如从设备或网络共享获取
.knxproj)——该文件从 B1 跨入 B2,豁免不再适用; - 无法干净归入某个 §13 处置的漏洞报告——这是模型有缺口的证据。
附录:现有安全策略制品回映射
仓库当前的 security.adoc 是仅流程页面,写明"没有已报告的漏洞"、指向 ASF 安全团队页,无威胁模型内容;THREAT-MODEL.md 的附录把这些制品逐一回映射到对应章节:
- README.md 的 "plc4c/、plc4py/ not ready for usage; plc4net/ abandoned" → §3 第 6 条、§5a;
- OpcuaDriverContext.java 的
buildCertificateVerifier(verify → trust-store → pinned → reject)→ §4 B2-OPCUA、§5a、§9 假朋友第 1 条、§11a; - OpcuaConfiguration.java 的
@ConfigurationParameter集合(含tls.verify=true、security-policy=Basic256Sha256、message-security=SIGN_ENCRYPT、generated-key-size=2048、discovery=true、allow-insecure-credentials=false、各类-ms超时、browse-max-*、subscription-queue-size=1)→ §5a、§6、§10; - EtsParser.java(XXE/DTD/schema 禁用、
FEATURE_SECURE_PROCESSING)→ §5、§8 P6、§11a; - 四个证书验证器类(
Permissive/TrustStore/Pinned/Rejecting)→ §4 B2-OPCUA、§5a、§8 P2; - SecurityPolicy.java 的策略枚举 → §5a、§8 P1/P7、§11a、§14 Q25;
plc4j/api/.../authentication/的PlcAuthentication、PlcUsernamePasswordAuthentication、PlcCertificateAuthentication→ §6、§9 假朋友;plc4j/api/.../PlcConnection.java、PlcDriverManager.java→ §2、§4 B1、§6;- plc4j/transports/ 的客户端专属传输清单(无监听套接字;SPI3 后 TCP 为虚拟线程上的阻塞
SocketChannel,非 Netty)→ §2、§3 第 2 条、§10 第 9 条; - TlsTransportConfiguration.java(
verify=true、ignore-common-name=false、trust-store 等)→ §5a、§10 第 3 条、§11。
结语:三条行动主线
对 PLC4X 的安全使用,可以归结为三条主线:报告走 SECURITY.md 与 security.adoc 的私密通道;理解以 THREAT-MODEL.md 为权威,分清"协议缺陷、库缺陷、集成方责任"三类边界;部署则落实 §10 的集成方职责——尤其为 OPC UA 命名信任锚、把明文协议关在 OT 网络边界内、审查 tag 地址字符串来源,并信任官方默认的 secure-by-default 配置而不主动降级。