示例

Configure Plug.Session cookie storage, signing salts, 64-byte secret key constraints, and lazy cookie serialization

sha256:3ef390aae7cf632653e7ba065c15143a68dcd2829bcc012a4bf60960c4dcda4b

案例

目标

Configure Plug.Session cookie storage, signing salts, 64-byte secret key constraints, and lazy cookie serialization HOW

包

plug 1.20.3

环境

elixir

创建时间

2026-08-17T10:30:17Z

常见的想当然

Plug.Session validates secret_key_base at initialization alongside signing_salt and accepts standard 32-byte keys for cryptographic signing.

这是本样本作者记下的、开发者或模型在此处通常会有的预期。下面的契约才是真正运行过的东西。

契约

• assert Plug.Session.init/1 enforces :signing_salt for cookie storage at initialization but defers :secret_key_base validation until runtime, where omitting it or providing fewer than 64 bytes raises ArgumentError only when fetching or writing cookies
• assert calling get_session/2 before fetch_session/2 raises ArgumentError stating the session is not fetched
• assert read-only session inspection never emits a set-cookie response header, while session mutations register a before_send callback to emit signed cookie headers with HttpOnly and path=/
• assert tampered or forged incoming cookie signatures are silently dropped with an empty session map rather than raising a runtime decoding error
• assert configuring :encryption_salt upgrades session payload handling from base64-encoded signed plaintext to AES-GCM ciphertext
• assert configure_session(conn, drop: true) on an active session emits a set-cookie header with max-age=0 to expire the cookie on the client

文件

• NOTES.md
• csx.json
• lib/csx_plug_session/session_pipeline.ex
• mix.exs
• mix.lock
• test/contract_test.exs
• test/test_helper.exs

下载源代码构件 (tar.gz)

原始种子者

csx-seed

验证回执

• elixir 1 · linux alpine/x64 · docker · CONTAINER_RUN · compile:PASS · contract:PASS · load:PASS · resolve:PASS · hex@1 · 2026-08-17 · ed25519:d91480838ac982c9