Hanko 2.0发布：新一代身份验证解决方案的重大升级

Hanko是一个开源的现代身份验证解决方案，专注于提供安全、灵活的用户认证体验。它支持多种认证方式，包括密码、社交登录、企业SSO以及最前沿的Passkey无密码认证技术。Hanko的设计理念是让开发者能够轻松集成强大的身份验证功能，同时保持对用户体验的完全控制。

今天，我们很高兴地宣布Hanko 2.0的正式发布。这个版本带来了全新的JavaScript SDK，改进了会话管理，并增加了多项新功能，使Hanko成为构建现代Web应用身份验证系统的更强大工具。

全新JavaScript SDK架构

Hanko 2.0最显著的改进是彻底重构的JavaScript SDK，这个新SDK专为与Hanko Flow API协同工作而设计。Flow API是1.0版本引入的核心功能，它提供了一种声明式的方法来定义认证流程。

新SDK引入了几个关键概念：

1. 状态管理：新的State类负责处理认证流程中的各种状态。它提供了onBeforeStateChange和onAfterStateChange事件钩子，允许开发者在状态转换前后执行自定义逻辑。

2. 动作执行：Action类提供了类型安全的方式来执行认证流程中的各种操作，如用户登录、注册等。

3. 自动流程推进：SDK现在能够自动处理流程中的状态转换，大大简化了开发者的工作。

4. 状态持久化：通过localStorage自动保存流程状态，确保用户在刷新页面或短暂离开后能够回到之前的认证状态。

以下是一个典型的使用示例：

const hanko = new Hanko(/* 配置参数 */);
const state = await hanko.createState("login");

await state.actions.continue_with_login_identifier.run({
  username: "user",
});

hanko.onBeforeStateChange(({state}) => {
  console.log(`即将执行的动作: ${state.invokedAction.name}`);
});

hanko.onAfterStateChange(({state}) => {
  console.log(`已完成动作: ${state.previousAction.name}`);

  if (state.name == "login_init") {
    state.passkeyAutofillActivation();
  }
});

改进的会话管理

Hanko 2.0简化了会话管理API，将相关功能直接集成到顶层Hanko实例中。开发者现在可以直接调用以下方法：

• getUser()：获取当前用户信息
• validateSession()：验证会话有效性
• getSessionToken()：获取会话令牌
• logout()：注销当前会话

这种设计使得会话管理更加直观和一致，减少了开发者需要了解的API表面面积。

自定义会话声明

企业级应用常常需要在会话令牌中包含额外的业务信息。Hanko 2.0引入了自定义会话声明功能，通过配置session.jwt_template.claims，开发者可以定义任意复杂的声明结构。

这些声明不仅会包含在JWT令牌中，还会出现在会话验证端点的响应中。声明值支持使用Go文本模板，提供了极大的灵活性。

灵活的会话存储选项

安全性和用户体验往往需要权衡。Hanko 2.0通过新增的sessionTokenLocation配置项，让开发者能够根据应用需求选择会话令牌的存储方式：

1. cookie（默认）：会话跨标签页和浏览器会话持久化，提供无缝的用户体验。
2. sessionStorage：会话仅在当前标签页有效，关闭标签页后自动注销，适合高安全性要求的应用。

这个功能特别适合金融、医疗等对安全性要求极高的应用场景。

向后兼容性

Hanko 2.0的后端与1.5.2版本保持兼容，这意味着你可以选择性地升级前端SDK而不必立即更新后端。然而，我们建议完整升级到2.0版本以获得最佳体验和所有新功能。

总结

Hanko 2.0代表了身份验证技术的一次重要进步。全新的JavaScript SDK提供了更强大、更灵活的API，使开发者能够轻松构建定制化的认证流程。自定义会话声明和灵活的会话存储选项则为企业级应用提供了更多可能性。

无论你是正在构建一个全新的应用，还是希望升级现有的身份验证系统，Hanko 2.0都值得考虑。它的开源性质意味着你可以完全控制代码，同时从活跃的社区中获益。

随着无密码认证技术的普及，Hanko的Passkey支持和现代化架构使其成为面向未来的身份验证解决方案。2.0版本的发布标志着这个项目迈入了一个新的成熟阶段。