插件窝 干货文章 Fedify,一个 ActivityPub 服务器框架,已达到 v0

Fedify,一个 ActivityPub 服务器框架,已达到 v0

fedify 签名 收件箱 活动 60    来源:    2024-10-20

activitypub 框架 fedify 终于发布了第一个稳定版本 1.0.0!

什么是 fedify?

fedify 是一个 typescript 库,可以轻松创建基于 activitypub 协议的联合服务器应用程序。 activitypub 是一种开放标准协议,允许社交网络服务相互通信,使用户能够在名为 fediverse 的去中心化社交网络中跨各种服务进行交互。

使用 fedify,开发人员可以通过高级 api 轻松构建联合服务器应用程序,而无需自行实现 activitypub 协议的复杂细节。 fedify 提供了许多开箱即用的 activitypub 实现所需的功能,包括 activitypub 对象的类型安全接口、webfinger、http 签名、链接数据签名和对象完整性证明。

此外,fedify 还包括与流行的 fediverse 软件(如 mastodon 或 meta 的 threads)的互操作性的特殊处理,允许开发人员创建可以轻松与现有 fediverse 生态系统集成的应用程序。此外,它还支持与各种web框架集成,并提供cli工具,使开发和调试过程更加方便。

主要变化

弃用术语 handle

从此版本开始,fedify 中的术语 handle 将仅用于指代 fediverse 句柄(例如,@hongminhee@fosstodon.org)。参与者的内部唯一 id(例如 b379dbdc-3b4f-4ef4-88c2-fc25632d1c22)被称为 标识符,webfinger 名称(例如 hongminhee)被称为 用户名.

api 中的术语 handle 将保留一段时间以实现向后兼容性,但将记录弃用警告,并计划在将来删除它。

更多详细信息,请参阅相关文档。

关联数据签名

链接数据签名是一个过时的标准,但它仍然被 mastodon 等主要联邦实现所依赖。

除了 http 签名和对象完整性证明之外,fedify 现在还支持此版本中的链接数据签名,从而支持 fediverse 中使用的所有类型的签名方法。这使得 fedify 成为具有最佳互操作性的 activitypub 实现。

但是,fedify 用户不需要执行任何特殊操作即可使用链接数据签名。如果传入活动具有链接数据签名,它会自动验证签名,并且所有传出活动都将具有三种格式的签名:http 签名、链接数据签名和对象完整性证明。

更多详细信息,请参阅相关文档。

活动转发

从此版本开始,您可以使用 inboxcontext.forwardactivity() 方法将收件箱中收到的活动转发给其他参与者。

乍一看,您可能认为可以使用 context.sendactivity() 方法重新发送收件箱中收到的活动。但是,如果您这样做,则在将活动传递到收件箱之前,原始签名会被删除,并且在发送活动时,会附加转发参与者的签名,从而导致转发活动的接收方不信任它。

另一方面,当使用 inboxcontext.forwardactivity() 方法时,活动将在保留原始签名的情况下转发,从而避免了此问题。 (当然,原始活动本身必须使用链接数据签名或对象完整性证明进行签名。)

更多详细信息,请参阅相关文档。

在 fedify 收件箱终止时发送删除(应用程序)

从此版本开始,fedify 收件箱将向终止时遇到的所有对等服务器发送删除(应用程序)活动。这通常是删除帐户时发送的活动,这将有助于防止与临时参与者相关的残留数据保留在其他服务器上。

postgresql 驱动程序

@fedify/postgres 包实现了 kvstore 和 messagequeue 接口的 postgresql 驱动程序,已与此版本一起发布。

postgresql 驱动程序是一个可以在生产中充分使用的后端,特别推荐给已经使用 postgresql 的项目。

此外,fedify init 命令中还添加了选择 postgresql 驱动程序的选项。

庆祝 fedify 1.0.0

随着 1.0.0 版本的发布,fedify 现在将尽可能保持 api 向后兼容性。 (当然,从长远来看,可能会出现破坏向后兼容性的 2.0.0。)这对于那些因为目前还没有稳定版本而一直犹豫是否使用 fedify 的人来说应该是个好消息!

fedify 1.0.0 现已在 jsr 和 npm 上提供:

deno add jsr:@fedify/fedify
npm  add     @fedify/fedify

所以,希望以后有更多的服务支持activitypub,我就结束这篇文章了!