返回资讯中心
外部精选
软件工程
#开发者实时流

easyssf 推出多语言 SSF 接收器,可实时响应身份提供商安全事件

来源标题:Shared Signals Framework Receiver Framework

开源项目 easyssf 为 Java、.NET、Go、Rust 和 Python 应用提供 OpenID Shared Signals Framework 接收器,使应用能在身份提供商撤销会话、更改凭证或发出风险信号时及时响应。该接收器验证 CAEP、RISC 和 SCIM 事件,拒绝受影响访问令牌并终止相关会话,其余事件交给开发者代码处理。

Hacker News 最新mooreds2026/11/11 · 6 天前30 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

easyssf 为你的 Java、.NET、Go、Rust 或 Python 应用添加了一个 OpenID Shared Signals Framework(SSF)接收器,使应用能够在身份提供商撤销会话、更改凭证或发出风险信号时做出反应。该接收器会验证传入的安全事件——包括关于会话和凭证的 CAEP 事件、关于账户的 RISC 事件,以及关于用户变更的 SCIM 事件——拒绝受影响的访问令牌、结束受影响的会话,并将其余一切交给你的代码处理。源码见 GitHub。

Transmitter(身份提供商)→ easyssf(验证 · 去重 → 分发)→ API 令牌、Web 应用会话、你的代码处理器。

为什么需要 SSF 接收器?

你的身份提供商知道用户何时在所有设备上登出、丢失设备、更改密码或触发风险规则。但你的应用不知道:它的会话和访问令牌会一直有效,直到过期。Shared Signals 接收器填补了这一空白。

你可以缩短令牌有效期、在每次请求时轮询令牌自省,或者自己编写安全事件令牌的验证、重放防护和流管理逻辑。OpenID 后通道登出仅覆盖登出场景,而且一旦登出请求在传输中丢失,它就永远丢失了:没有重试机制,也没有可轮询的东西。它同样不涉及凭证、风险或用户预配方面的信息。

该接收器会验证事件并对其采取行动:开箱即用地在你的框架的安全层中拒绝被撤销的令牌并结束会话。对于它无法单独处理的事件,它会交给你的处理器。一个库,一种行为,覆盖 JVM、.NET、Go、Rust 和 Python。从你所用框架的集成指南开始。

shared-signals.dev playground 和 caep.dev 运行着公共 Transmitter,因此你无需身份提供商即可从浏览器向自己发送 CAEP 事件。示例应用附带 Keycloak 配置,可完成完整的往返流程。

Transmitter(通常是你的身份提供商)将安全事件令牌(SET)投递到你的应用,方式可以是推送到某个端点,也可以是让应用主动轮询。easyssf 会验证每个令牌、跳过重复项,并将事件路由到相应的集成进行处理。

Transmitter(身份提供商,例如 Keycloak)使用其 JWK Set 对 SET 进行签名。

你的应用(Spring Boot、Quarkus 或任何其他 JVM 应用;easyssf-receiver 是其内部的一个库):

  • easyssf 接收器:验证 SET(RFC 8417)、跳过重复项(jti)、分发到事件处理器、流管理、指标,状态存于内存或数据库中。
  • 资源服务器:拒绝已被撤销的访问令牌。
  • OIDC 客户端:结束相关会话。
  • 你的处理器:步进认证、审计以及其他任何逻辑。

推送(RFC 8935)或定期轮询(RFC 8936),SET、SET。

推送或轮询:RFC 8935 · RFC 8936

你可以在任意路由上设置推送端点,由独立的无状态过滤器链保护;也可以使用轮询器从 Transmitter 获取并确认 SET,如果需要还支持长轮询。确认状态在重启后依然保留,多个实例可以共享同一个流。

签名基于 Transmitter 的 JWK Set 进行验证,该 JWK Set 从其 .well-known/ssf-configuration 发现,同时校验 typ、iss、aud、jti、iat 和 events。Transmitter 及其发布的每个端点都必须使用 HTTPS。

CAEP 的 session-revoked 事件使应用拒绝该会话的访问令牌,或拒绝该用户在事件之前签发的所有令牌:Spring Boot starter 中已内置,使用 quarkus-oidc 则只需几行代码。

session-revoked 和 credential-change 事件会按会话 ID、主体或邮箱使匹配的本地会话失效。

SCIM 服务提供商的预配变更——用户被创建、修补、停用或删除——会以带有 scim 主体的 SET 形式到达。SsfScimEventHandler 会按操作将其交给对应的方法处理,停用操作会结束该用户的会话。

让应用在启动时于 Transmitter 处创建或更新其流、验证该流,并通过 SsfStreamClient 使用完整的流管理 API。多个 Transmitter(例如多个 Keycloak realm)各自按名称配置;SET 的签发者会选择用于验证它的那个 Transmitter。

有数据库时将状态存入数据库,附带 schema 的迁移脚本、Micrometer 指标、用于 Actuator 或 SmallRye Health 的健康指示器、带退避的重试机制,并且即使 Transmitter 宕机应用也能启动。处理语义为至少一次;每个 SET 都携带一个幂等键,用于你的处理器产生的副作用。

接收器如何处理事件。前三个是示例应用,分别面向 Spring Boot、Quarkus、.NET、Go 和 Rust,第一个还面向 Python,附带可供运行的 Keycloak 配置;其余则是你自己的处理器。

session-revoked:使用旧令牌发起请求。

描述:OAuth2 资源服务器信任访问令牌直到其过期。通过 CAEP 的 session-revoked 事件,API 得知会话已结束,并从下一次请求开始拒绝该会话的令牌,或拒绝该用户在事件之前签发的所有令牌。Spring Boot starter 中已内置;在 Quarkus 中基于 quarkus-oidc 只需几行代码。

示例:Spring Boot · Quarkus · .NET · Go · Rust · Python

session-revoked、credential-change:下一次请求。

描述:OpenID Connect 依赖方在登录后维护自己的会话。当身份提供商结束会话或用户更改凭证时,session-revoked 和 credential-change 事件让应用能够按会话 ID、主体或邮箱找到本地会话并结束它,从而使下一次请求重新走登录流程。

示例:Spring Boot · Quarkus · .NET · Go · Rust

prov:create · patch、deactivate · delete:创建、更新、停用用户。

描述:SCIM 服务提供商以 SCIM Events(RFC 9967)的形式报告其用户的变更,而非被动轮询。应用通过每个操作对应的处理器将其镜像到自己的目录中,停用或……

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →