adeptiainc/adeptia-connect-license

许可证管理仓库镜像

概述

许可证管理仓库镜像是一个用于集中化管理软件许可证的Docker化解决方案，提供许可证全生命周期管理功能，包括创建、存储、分发、验证及过期监控，帮助企业和开发团队高效管控软件授权资源，降低合规风险。

核心功能和特性

• 许可证存储：支持多种格式（JSON、XML、文本）许可证文件的加密存储，确保数据安全性
• 分发控制：基于角色和权限的许可证分发机制，支持按团队、项目或用户维度分配
• 验证接口：提供RESTful API用于第三方应用集成许可证验证，支持在线/离线两种验证模式
• 生命周期管理：自动跟踪许可证有效期，提供到期预警（邮件/API通知）和过期吊销功能
• 版本追踪：记录许可证变更历史，支持版本回溯和变更审计
• 权限管理：基于RBAC（基于角色的访问控制）模型，细化操作权限粒度

使用场景和适用范围

• 企业软件授权管理：统一管控商业软件、开发工具及内部系统的许可证资源
• 多团队协作：支持跨部门、跨团队的许可证共享与分配，避免资源闲置和重复采购
• 开源项目商业化：为开源项目的商业授权版本提供客户许可证管理平台
• 软件供应商工具：作为B2B软件供应商的客户许可证交付与管理系统

使用方法和配置说明

快速启动

通过以下命令快速部署许可证管理仓库：

bash
docker run -d \
  --name license-repo \
  -p 8080:8080 \
  -v /host/license-data:/app/data \
  -e SPRING_DATASOURCE_URL=jdbc:mysql://mysql-host:3306/license_db \
  -e SPRING_DATASOURCE_USERNAME=admin \
  -e SPRING_DATASOURCE_PASSWORD=SecurePass123! \
  -e JWT_SECRET=your-jwt-signing-key \
  docker.xuanyuan.run/license-repo:latest

环境变量配置

持久化配置

为确保数据持久化，需挂载数据卷存储许可证文件和配置：

bash
# 创建本地数据目录
mkdir -p /host/license-data/{files,config,logs}

# 带持久化的启动命令
docker run -d \
  --name license-repo \
  -p 8080:8080 \
  -v /host/license-data/files:/app/data/files \
  -v /host/license-data/config:/app/config \
  -v /host/license-data/logs:/app/logs \
  -e SPRING_DATASOURCE_URL=jdbc:mysql://mysql-host:3306/license_db \
  -e SPRING_DATASOURCE_USERNAME=admin \
  -e SPRING_DATASOURCE_PASSWORD=SecurePass123! \
  -e JWT_SECRET=your-permanent-jwt-key \
  -e NOTIFICATION_EMAIL=admin@example.com,team@example.com \
  docker.xuanyuan.run/license-repo:latest

集成与使用

部署完成后，通过访问 http://<容器IP>:8080 进入Web管理界面，或通过API进行操作：

• 获取API文档：http://<容器IP>:8080/swagger-ui.html
• 创建许可证示例（curl）：

bash
curl -X POST "http://<容器IP>:8080/api/v1/licenses" \
  -H "Authorization: Bearer <jwt-token>" \
  -H "Content-Type: application/json" \
  -d '{"name":"IntelliJ IDEA","type":"COMMERCIAL","expireDate":"2024-12-31","assignedTo":"dev-team","content":"<base64-encoded-license-file>"}'