mathematicalthinking/mt-sso

VMT & Encompass 单点登录应用 Docker 镜像文档

镜像概述

本Docker镜像包含为VMT和Encompass系统设计的单点登录（SSO）应用，旨在提供统一的身份验证机制，简化用户在多个系统间的登录流程，同时增强整体系统的访问安全性与管理效率。通过集中式身份验证，用户可使用一组凭据访问VMT和Encompass系统，减少重复登录操作并降低身份管理复杂度。

核心功能与特性

• 单点登录（SSO）：支持用户通过一次身份验证访问VMT和Encompass系统，无需重复登录
• 统一身份验证：集成标准身份验证协议（如SAML 2.0、OAuth 2.0），兼容企业现有身份提供商
• 系统集成：预配置与VMT及Encompass系统的接口适配，支持快速对接
• 安全访问控制：基于角色的访问控制（RBAC），可配置细粒度权限策略
• 会话管理：支持会话创建、销毁、超时控制及异常检测
• 日志审计：记录用户登录、访问行为等审计日志，便于安全审计与问题排查

使用场景与适用范围

适用场景

• 企业环境中同时部署VMT和Encompass系统，需统一用户身份管理
• 需要简化用户操作流程，减少因多次登录导致的效率损耗
• 需增强系统安全性，通过集中身份验证降低凭证泄露风险
• 要求符合企业级安全合规标准（如GDPR、ISO 27001）的身份管理方案

适用范围

• 部署VMT和Encompass系统的企业IT环境
• 需跨系统统一身份验证的中小型至大型组织
• 对系统访问安全性和用户体验有较高要求的场景

使用方法与配置说明

前置条件

• Docker Engine 20.10+ 或 Docker Desktop
• 已部署VMT和Encompass系统，并获取其API访问地址及认证凭证
• 可用的数据库服务（如PostgreSQL、MySQL）用于存储用户会话及配置数据

Docker Run 命令示例

bash
docker run -d \
  --name vmt-encompass-sso \
  -p 8080:8080 \
  -e SPRING_DATASOURCE_URL=jdbc:postgresql://db-host:5432/sso_db \
  -e SPRING_DATASOURCE_USERNAME=sso_user \
  -e SPRING_DATASOURCE_PASSWORD=secure_password \
  -e SSO_SECRET_KEY=your-256-bit-secret-key \
  -e VMT_API_URL=https://vmt.example.com/api \
  -e ENCOMPASS_API_URL=https://encompass.example.com/api \
  -v /path/to/sso/config:/app/config \
  -v /path/to/sso/logs:/app/logs \
  docker.xuanyuan.run/vmt-encompass-sso:latest

Docker Compose 配置示例

yaml
version: '3.8'
services:
  sso-app:
    image: docker.xuanyuan.run/vmt-encompass-sso:latest
    container_name: vmt-encompass-sso
    restart: always
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=prod
      - SPRING_DATASOURCE_URL=jdbc:postgresql://db:5432/sso_db
      - SPRING_DATASOURCE_USERNAME=sso_user
      - SPRING_DATASOURCE_PASSWORD=secure_password
      - SSO_SECRET_KEY=your-256-bit-secret-key
      - SSO_SESSION_TIMEOUT=3600
      - VMT_API_URL=https://vmt.example.com/api
      - ENCOMPASS_API_URL=https://encompass.example.com/api
      - LOG_LEVEL=INFO
    volumes:
      - ./config:/app/config
      - ./logs:/app/logs
    depends_on:
      - db

  db:
    image: docker.xuanyuan.run/postgres:14
    container_name: sso-db
    restart: always
    environment:
      - POSTGRES_DB=sso_db
      - POSTGRES_USER=sso_user
      - POSTGRES_PASSWORD=secure_password
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

环境变量配置说明

数据持久化

为确保配置文件、日志及数据库数据持久化，建议挂载以下目录：

• /app/config: 存放应用配置文件（如自定义认证规则、权限策略）
• /app/logs: 存储应用运行日志
• 数据库数据卷（如示例中postgres-data）: 存储用户会话、身份数据等核心信息

注意事项

• 生产环境中需使用强密钥（SSO_SECRET_KEY）并定期轮换
• 建议通过HTTPS暴露服务端口，可配合Nginx等反向代理实现SSL终止
• 首次启动需初始化数据库表结构，可通过执行容器内/app/bin/init-db.sh脚本完成
• 与VMT/Encompass系统集成前，需确保API接口权限配置正确并测试连通性