samlify

samlify 是一个专为 Node.js 环境设计的高性能 SAML2 认证框架。它致力于简化企业级单点登录（SSO）和身份认证流程，支持 Service Provider (SP) 和 Identity Provider (IdP) 双重角色。适用于需要集成企业级 SSO、实现跨系统身份验证的 Web 应用。通过提供灵活的配置和完善的协议支持，帮助开发者快速构建安全、合规的身份认证网关，大幅提升系统安全性与开发效率。

# samlify ## 框架简介与定位 samlify 是一个用于 Node.js 的纯 JavaScript SAML2 库。它的定位是提供一个轻量级、高度可定制的 SAML 协议实现，既支持作为 Service Provider (SP) 接入第三方 IdP，也支持作为 Identity Provider (IdP) 为其他应用提供认证服务。 ## 核心特性 1. **双角色支持**：全面支持 Service Provider (SP) 和 Identity Provider (IdP) 模式，满足不同架构需求。 2. **灵活的协议绑定**：支持 HTTP-Redirect、HTTP-POST 等多种 SAML 绑定方式，兼容各类企业级 IdP（如 Okta, Azure AD 等）。 3. **XML 签名与加密**：内置对 XML 签名验证和加密/解密的支持，确保身份断言（Assertion）的安全性和完整性。 4. **高度可定制**：允许开发者自定义解析逻辑、模板和上下文，轻松应对非标准或特定企业的 SAML 实现。 5. **无框架绑定**：作为纯 Node.js 库，不依赖于特定的 Web 框架，可无缝集成到 Express、Koa 或 Serverless 环境中。 ## 适用场景 - **企业级 SSO 集成**：将内部 Web 应用接入企业现有的身份提供商。 - **构建统一认证中心**：使用 Node.js 搭建自定义的 Identity Provider，为多个子系统提供统一登录。 - **跨域身份验证**：在微服务架构或跨组织系统中实现安全的身份传递与验证。 ## 快速入门步骤 ### 1. 安装 ```bash npm install samlify ``` ### 2. 最小示例思路 (SP 模式) - **初始化 SP**：引入 `samlify`，配置 `entryPoint` (IdP 登录地址) 和 `issuer`。 - **配置 IdP**：引入 IdP 的元数据 (Metadata) 或手动配置证书。 - **发起登录**：创建登录请求并重定向用户到 IdP 的登录页面。 - **处理回调**：配置 ACS (Assertion Consumer Service) 路由，接收 IdP 返回的 SAML Response。 - **解析断言**：使用 `parseLoginResponse` 解析响应，提取用户信息并完成本地会话创建。 ## 生态与社区说明 samlify 托管在 GitHub 上，拥有活跃的开源社区，定期更新以修复安全漏洞和兼容性问题。官方提供了丰富的示例代码和详细的 API 文档。作为 npm 上成熟的 SAML 库，它被众多开源项目和企业级应用采用，生态稳定可靠。