storageless密钥配置指南对称HMAC与非对称EdDSA签名方案如何选择【免费下载链接】storageless:mailbox_with_mail: storage-less PSR-7 session support项目地址: https://gitcode.com/gh_mirrors/st/storagelessstoragelesspsr7-sessions/storageless是一个基于 PSR-7 的无存储会话库它不写服务器文件、不用 Redis、不碰$_SESSION而是把会话数据打包成带签名的 JWT 直接放进 Cookie由浏览器替你存。正因为如此storageless密钥配置就成了上线前最重要的一步——密钥决定了会话是否会被伪造。本文用通俗的语言讲清楚对称 HMAC 与非对称 EdDSA 两种签名方案的区别、配置步骤和选型建议帮你一次选对。为什么 storageless 需要配置密钥先搞懂签名原理传统 PHP 会话把数据存在服务器端客户端只拿一个随机 ID而 storageless 反其道而行会话数据本身就在 Cookie 里。既然数据在用户手里就必须防止用户篡改。它的做法是服务端用密钥对 JWT 签名浏览器每次请求带回 Cookie服务端验签通过才信任里面的数据。这个过程完全依赖lcobucci/jwt中配置签名算法 密钥即可。默认情况下Cookie 名为__Secure-slsession自带Secure、HttpOnly、SameSiteLax、path/四项安全属性你基本不用动它。方案一对称 HMAC 签名——最快的 storageless密钥配置方法什么是对称签名HMAC 使用同一个密钥完成签名和验证类似一把钥匙开一把锁你用钥匙锁上箱子对方用同一把钥匙开箱验证。适用场景单台服务器或可信内网部署想以最小成本快速接入所有节点都能安全保管密钥最快配置方法只需 5 行use Lcobucci\JWT\Configuration as JwtConfig; use Lcobucci\JWT\Signer; use Lcobucci\JWT\Signer\Key\InMemory; use PSR7Sessions\Storageless\Http\SessionMiddleware; use PSR7Sessions\Storageless\Http\Configuration as StoragelessConfig; $sessionMiddleware new SessionMiddleware( new StoragelessConfig( JwtConfig::forSymmetricSigner( new Signer\Hmac\Sha256(), InMemory::base64Encoded(你的随机密钥至少32字节), ) ) );其中InMemory::base64Encoded()传入的就是你的签名密钥。完整用法可参考官方文档 docs/configuration.md 和可运行的 examples/index.php 示例。优缺点速览✅ 配置最简单只有一份密钥✅ 验签性能好❌ 密钥必须所有节点共享一旦泄露攻击者能随意伪造会话方案二非对称 EdDSA 签名——多服务器安全配置首选什么是不对称签名非对称签名使用一对密钥私钥负责签名写入会话公钥负责验证读取会话。公钥可以随便分发甚至公开都没关系。适用场景多台服务器横向扩展想要读写分离只有持有私钥的节点能签发会话对外提供会话校验服务只需下发公钥配置步骤先准备密钥对EdDSA 需要 PHP 的ext-sodium扩展项目依赖中已声明openssl genpkey -algorithm ED25519 -out private_key.pem openssl pkey -in private_key.pem -pubout -out public_key.pem项目测试用的密钥对就放在 test/keys/ 目录含private_key.pem和public_key.pem仅供测试生产环境务必自己生成。然后配置use Lcobucci\JWT\Configuration as JwtConfig; use Lcobucci\JWT\Signer; use Lcobucci\JWT\Signer\Key\InMemory; use PSR7Sessions\Storageless\Http\SessionMiddleware; use PSR7Sessions\Storageless\Http\Configuration as StoragelessConfig; $sessionMiddleware new SessionMiddleware( new StoragelessConfig( JwtConfig::forAsymmetricSigner( new Signer\Eddsa(), InMemory::file(private_key.pem), // 私钥用于签发会话 InMemory::file(public_key.pem), // 公钥用于验证会话 ) ) );优缺点速览✅ 私钥只在少数节点保存公钥可自由分发✅ 支持只读节点只拿公钥的服务器无法伪造会话❌ 配置稍复杂需要管理密钥对和分发流程对称 HMAC 与非对称 EdDSA快速对比与选型建议对比维度对称 HMAC (Sha256)非对称 EdDSA密钥数量1 个签名验证共用2 个私钥签名 / 公钥验证密钥分发难度所有节点共享一份只需分发公钥配置复杂度⭐ 低⭐⭐ 中推荐场景单机、可信内网多服务器、读写分离泄露后果密钥泄露 会话全可伪造仅私钥泄露才危险性能较快略慢现代 CPU 无感知选型口诀单机图省事用 HMAC多机重安全用 EdDSA只要你的服务将来要扩容直接上 EdDSA 最省心——毕竟换算法要重新配置并作废所有旧会话。密钥生成与安全注意事项无论选哪种方案都请遵守这几条用 CSPRNG 生成高熵密钥不要手打字符串。对称密钥可这样生成php -r echo base64_encode(random_bytes(32));生产密钥绝不入库到 Git更不要用 test/keys/ 里的测试密钥。定期轮换密钥。注意更换密钥会立即让所有旧会话验签失败相当于全体下线请安排在低峰期。关于签名验证的关键逻辑可查看 src/Storageless/Http/SessionMiddleware.php 中对SignedWith约束的使用。常见问题速答Q本地开发没有 HTTPSCookie 发不出去怎么办A默认__Secure-slsession只在 HTTPS 下工作。本地可用withCookie()方法把 Cookie 改成普通名称并关闭Secure标志具体示例见官方文档 docs/configuration.md 的Local development一节但生产环境务必保持默认安全配置。Q会话能存多少数据ACookie 有 4KB 上限加上 JWT 的 base64 编码和签名开销建议会话数据JSON 编码后控制在512 字节以内。更多边界说明见 docs/limitations.md。Q能不能单独踢掉某个用户的会话Astorageless 天然不支持单会话作废唯一的一键失效方式是更换全局密钥。这也提醒我们它适合存放用户 ID、CSRF Token 等非敏感信息不要放密码、手机号等私密数据。总结storageless密钥配置其实只有两个选择对称 HMAC 求简单非对称 EdDSA 求安全。中小项目、单机部署直接 HMAC 一把梭涉及多服务器、需要权限隔离的场景果断上 EdDSA。无论选哪个只要记住密钥要随机、要保密、要轮换你的无存储会话就能安全稳定地跑起来。【免费下载链接】storageless:mailbox_with_mail: storage-less PSR-7 session support项目地址: https://gitcode.com/gh_mirrors/st/storageless创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考