基于 Golang + React 的企业级单点登录与身份提供商（IdP）平台。完整实现 OAuth 2.0 授权码流程 + OpenID Connect 1.0，提供功能完备的管理后台、应用门户和状态监控页。

• 🔐 标准协议：完整支持 OAuth 2.0 授权码模式 + OIDC 1.0（Discovery / JWKS / UserInfo / Revoke / EndSession）
• 🛡️ 安全设计：RSA-RS256 签名、PKCE 支持、Refresh Token 轮换、bcrypt 密码哈希、CSRF/CORS 防护
• 🎛️ 统一登录入口：所有用户共用 /oauth/login，登录后按 is_staff 自动路由到门户或管理后台
• 🧑‍💼 完备的管理后台：用户 / 部门 / 角色 / 应用 / 访问控制 / 配置 / 日志 / 状态监控
• 📊 应用状态监控：每 30 秒自动健康探测，90 天可用性条带 + 24h/7d/30d/90d 多窗口指标
• 🚀 零依赖开发：内置 SQLite + 内存 Store，无需 Postgres/Redis 即可本地启动
• 🐳 生产部署：Docker Compose 一键部署完整栈

落地页	应用门户

概览页	公开状态页

.
├── sso-server/             # Go 后端
│   ├── cmd/server/         # main 入口
│   ├── internal/
│   │   ├── config/         # Viper 配置
│   │   ├── model/          # GORM 数据模型
│   │   ├── repository/     # 仓储层 + Seed 初始数据
│   │   ├── service/        # 业务服务
│   │   ├── handler/        # HTTP Handler（OAuth/Auth/User/App/...)
│   │   ├── middleware/     # JWT / CORS / 安全响应头
│   │   ├── oauth/          # 密钥管理 / Token / 授权码 / Store
│   │   ├── session/        # 服务端 Session（SSO Cookie）
│   │   ├── monitor/        # 状态监控调度器
│   │   └── router/         # 路由注册
│   ├── pkg/                # 通用工具（response / password / utils）
│   └── configs/config.yaml
├── sso-admin/              # React 前端
│   └── src/
│       ├── pages/
│       │   ├── login/      # 统一登录页（左品牌 + 右表单）
│       │   ├── consent/    # 授权同意页
│       │   ├── portal/     # 应用门户（普通用户）
│       │   ├── status/     # 公开状态监控页
│       │   └── admin/      # 管理后台子页面
│       ├── layouts/AdminLayout.tsx
│       ├── components/AuthGuard.tsx
│       ├── api/ store/ router/
│       └── styles/
├── deployments/            # Docker / Nginx
├── docker-compose.yml
├── Makefile
└── sso-design-v2.md        # 设计文档

make install

make dev-backend

后端将在 http://localhost:8080 启动，并完成：

• 自动建表（GORM AutoMigrate）
• 自动 RSA-2048 密钥生成（写入 ./keys/）
• 初始化默认账号、内置角色、示例应用与监控配置

make dev-frontend

前端在 http://localhost:5173 启动，已配置代理。

第三方应用接入：

1. 在管理后台 应用中心 创建应用，获取 client_id 与 client_secret
2. 引导用户跳转到：

GET http://localhost:8080/oauth/authorize?
    response_type=code
    &client_id=YOUR_CLIENT_ID
    &redirect_uri=https://your.app/callback
    &scope=openid profile email
    &state=RANDOM
    &nonce=RANDOM
    &code_challenge=...   # PKCE 可选
    &code_challenge_method=S256

3. 用户登录授权后回调到 redirect_uri?code=...&state=...
4. 应用后端用授权码换 Token：

POST /oauth/token
Authorization: Basic base64(client_id:client_secret)

grant_type=authorization_code
&code=...
&redirect_uri=https://your.app/callback
&code_verifier=...   # PKCE 时必填

返回：

{
  "access_token": "...",
  "refresh_token": "...",
  "id_token": "...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "openid profile email"
}

5. 用 Access Token 调 UserInfo：

GET /oauth/userinfo
Authorization: Bearer <access_token>

cp .env.example .env
# 修改 .env 中的密码与 SSO_ISSUER
make docker-build
make docker-up

完整栈监听 80 端口：

• Nginx 反代 /oauth/*, /api/*, /.well-known/* → backend
• 其他路径 → 前端 SPA

如需生成离线安装包（含 Docker 镜像），详见 release/PACKAGING.md。

快速打包：

# 1. 查看当前版本
cat release/VERSION

# 2. 执行打包（自动构建、打包、清理）
bash release/package-offline.sh

# 3. 生成的安装包
ls -lh oneauth-v*.tar.gz

打包后生成 oneauth-vX.X.X.tar.gz，解压后执行 install.sh 即可部署。

• auth/login, auth/refresh, auth/profile, auth/logout, auth/change-password
• users（CRUD + reset-password + lock + roles）
• departments/tree, departments
• roles, roles/:id/permissions, permissions/tree
• apps（CRUD + rotate-secret + toggle-status）
• dashboard/stats, dashboard/login-trends, dashboard/app-distribution
• logs/login, logs/operation, logs/access
• configs, dictionaries
• access/ip
• monitor/apps, monitor/apps/:cid/config, monitor/apps/:cid/probe, monitor/apps/:cid/maintenance

• overview - 整体状态 + 应用卡片列表（含 90 天时间线）
• apps/:cid/timeline - 指定应用 90 天聚合
• apps/:cid/windows - 多窗口可用性

配置文件 sso-server/configs/config.yaml，支持环境变量覆盖（前缀 SSO_）。

关键开关：

• app.driver: sqlite 或 postgres
• redis.enabled: false 启用内存模式
• monitor.enabled: true 启动状态探测
• monitor.interval_seconds: 探测周期（默认 30s）

MIT License © 2026 zjl111