-
Notifications
You must be signed in to change notification settings - Fork 0
Roadmap
明确划清边界有助于正确使用。以下为有意不做、安全拒绝或需显式开启的能力,以及未来改进方向。
HTTP/1.1
- 入站 request parser / server role
-
obs-fold折行(安全拒绝而非规范化) - 调用方手写
Transfer-Encoding/TE(安全拒绝,framing 由库生成)
HTTP/2
- server push(客户端
ENABLE_PUSH=0,收到PUSH_PROMISE安全拒绝)
WebSocket(注:分片发送 wknet::websocket::SendContinuation 与显式接收分片 ReceiveOptions.DeliverFragments=true 已支持)
- 握手 redirect / 401 / 407 跟随(当前安全拒绝为
STATUS_NOT_SUPPORTED;未来若做必须显式 opt-in)
TLS
- 在线撤销抓取(OCSP/CRL 网络拉取)——内核态刻意省略,支持静态撤销条目
其它
- HTTP/3 / QUIC
- TLS 1.2 RSA key exchange / CBC / SHA-1 签名(需
TlsPolicy+CompatibilityExplicit) - TLS 1.2 真重协商(服务器
HelloRequest或低层客户端主动发起;需CompatibilityExplicit+EnableTls12Renegotiation,次数由MaxTls12Renegotiations限制) - Post-handshake client auth
- 强制撤销检查
- TLS 1.3 0-RTT
-
Expect: 100-continue(SendFlagExpectContinue+ExpectContinueTimeoutMs) - HTTP/1.1 pipeline(session
EnableHttp11Pipeline=true,默认仅GET/HEAD/OPTIONS,深度和方法 mask 可配置) - 高层 h2c prior knowledge / Upgrade(
SendOptions.Http2CleartextMode) - HTTP/2 后台 PING 保活(session
Http2KeepAlive.Enabled=true,默认关闭) - HTTP/2 per-request priority(
SendOptions.Http2Priority) - WebSocket permessage-deflate(
ConnectConfig.PerMessageDeflate.Enable=true,默认关闭)
- 继续扩展协议安全边界上的有界账本,例如更细的超时、取消、帧/控制信令与恶意输入防护;普通 buffered response 默认不设置低位库级总量硬顶。
- 继续减少热路径重复分配,优先复用 Workspace / lookaside / 连接生命周期常驻缓冲。
- 保持明文 HTTP over proxy 的 absolute-form 路径与 HTTPS CONNECT 隧道路径分离,继续审计代理鉴权 opaque 透传边界。
这些是对当前公开行为的描述,便于评估适用性;不代表内部审计细节。能力现状见 能力账本。
Explicit boundaries help correct usage. The following are intentionally out of scope, security-rejected, or explicit opt-in, plus ongoing improvement directions.
Non-goals / security rejections. HTTP/1.1: inbound request parser/server role, obs-fold normalization (rejected), caller-supplied Transfer-Encoding/TE (rejected because the library owns framing). TRACE is available only with explicit SendFlagAllowTrace. HTTP/2: server push (ENABLE_PUSH=0; PUSH_PROMISE is rejected). WebSocket (fragment send + explicit ReceiveOptions.DeliverFragments receive-fragment delivery are supported): handshake redirect/401/407 following (currently rejected with STATUS_NOT_SUPPORTED; any future support must be explicit opt-in). TLS: online OCSP/CRL fetch (omitted in kernel; static/provider-returned evidence supported). Other: HTTP/3 / QUIC.
Off by default, explicitly enable. TLS compatibility features, post-handshake client auth, required revocation checks, TLS 1.3 0-RTT, Expect: 100-continue, HTTP/1.1 pipelining, h2c, HTTP/2 PING keepalive, per-request priority (SendOptions.Http2Priority), and WebSocket permessage-deflate.
Future directions. Continue tightening protocol-safety ledgers such as timeouts, cancellation, frame/control-signal and malicious-input bounds while leaving normal buffered responses unlimited by default; reduce repeated allocations on hot paths via Workspace/lookaside/connection-resident buffers; keep plaintext HTTP over proxy absolute-form separate from HTTPS CONNECT tunneling and continue auditing opaque proxy-auth forwarding.
This describes current public behavior for fit assessment; see Capability Matrix for the current state.
-
开始使用 / Get Started
-
概念与行为 / Concepts
-
协议指南 / Protocols
-
API 参考 / API Reference
-
贡献与项目 / Contribute