gruppeadler/sso

sso.gruppe-adler.de 镜像说明

镜像概述

本镜像为Gruppe Adler的单点登录（SSO）服务，提供集中式用户与组管理功能。用户无法直接管理组和用户的权限，但其他服务（如博客）可通过该服务验证用户身份（包括特定用户或组的成员身份），支持直接通过Steam登录。

核心功能

1. 单点登录认证：支持通过Steam账号登录
2. 集中管理：统一存储用户与组信息
3. JWT令牌：使用RSA密钥对生成/验证JWT，确保认证安全
4. 头像管理：支持用户头像上传与存储
5. GraphQL API：提供GraphQL接口用于数据查询与操作

使用场景

• 多服务统一身份验证场景（如博客、社区平台）
• 需要Steam账号登录的应用集成
• 需集中管理用户身份的系统

配置说明

部署准备

镜像已发布至Docker Hub，部署需注意：

• 容器需开放80/443端口
• 需挂载两个卷：
  • /usr/src/app/data：存储SQLite数据库与用户头像
  • /usr/src/app/config：存储配置文件与RSA密钥对

配置文件结构

配置目录需包含以下文件：

├── config.json
└── keys 
      ├── private.key
      └── public.key

config.json模板

json
{
    "jwt": {
        "issuer": "sso.gruppe-adler.de",
        "audience": "sso.gruppe-adler.de",
        "expiresIn": "356d"
    },
    "cookie": {
        "name": "gruppe-adler-sso-token",
        "domain": ".gruppe-adler.de"
    },
    "steam": {
        "realm": "https://sso.gruppe-adler.de",
        "returnUrl": "https://sso.gruppe-adler.de/openid/return/steam",
        "apiKey": "你的Steam API密钥"
    }
}

RSA密钥对生成

可通过工具（如[***]

部署示例

Docker Run命令

bash
docker run -d \
  -p 80:80 \
  -v ./sso-data:/usr/src/app/data \
  -v ./sso-config:/usr/src/app/config \
  gruppeadler/sso

认证方式

• HTTP Header：Authorization: Bearer <JWT令牌>
• Cookie：使用配置文件中指定名称的Cookie传递JWT令牌

API说明

• GraphQL接口：/api/v1/graphql（可通过GraphiQL界面调试）
• 头像上传：PUT /api/v1/upload/avatar/:id（需认证，文件大小限制1MB）
• 头像访问：/avatars/<头像文件名>