sambauch/osso

Osso镜像说明

镜像概述

Osso是一个开源微服务，旨在为应用添加基于SAML的单点登录（SSO）功能。通过部署Osso到自有基础设施，可使用其管理UI或React组件配置客户的SAML需求，并通过OAuth客户端库（如omniauth-osso或passport-osso）实现用户登录集成。

核心功能

1. SAML转OAuth简化集成：Osso提供OAuth服务器、管理UI及Ruby/NodeJS客户端库，将复杂的SAML处理抽象为熟悉的OAuth流程，让团队无需关注SAML细节。
2. 灵活的SAML配置方式：支持通过Osso管理UI快速配置客户的SAML提供商，或通过React库（osso-react）让客户在你的应用中自行完成配置。
3. 全面文档支持：为客户生成PDF配置文档，同时提供团队集成和管理Osso实例的详细指南。

使用场景

• 企业应用需要支持客户的SAML SSO需求时。
• 希望将SAML集成复杂度转移到Osso，专注核心业务开发的场景。
• 需要让客户自行配置SAML的自助服务场景。

配置说明

部署

可通过Docker快速部署Osso实例：

bash
docker run -d \
  -p 3000:3000 \
  -e JWT_HMAC_SECRET=your_secure_secret \
  -e DATABASE_URL=postgres://username:password@host:port/database \
  sambauch/osso

（注：需替换环境变量为实际值，如JWT密钥和数据库连接信息）

Admin UI认证

Osso使用JWT进行管理员认证。需生成包含{scope: 'admin', email: 'your_email@company.com'}的JWT，并用JWT_HMAC_SECRET签名，通过token查询参数访问Osso Admin UI。

OAuth集成

用户登录时，将其引导至Osso的OAuth授权流程（需包含***域名），Osso会路由至对应的SAML提供商，完成认证后返回至你的应用完成OAuth流程。可使用omniauth-osso（Ruby）或passport-osso（NodeJS）简化集成。

更多信息

详细文档可访问ossoapp.com，包括部署指南、JWT认证、OAuth消费等内容。 ===FULL_DESC===