hsldevcom/jore4-auth

jore4-auth 镜像文档

镜像概述

jore4-auth 是由 HSLdevcom 开发的认证服务镜像，专为 Jore4 项目设计，负责处理用户身份验证、授权管理及访问控制，是 Jore4 生态系统中确保服务安全访问的核心组件。

核心功能与特性

• 用户认证：支持用户登录、注销流程，验证用户身份合法性
• 授权管理：基于角色的访问控制（RBAC），管理用户权限与操作范围
• 集成兼容性：与 Jore4 项目其他服务（如 jore4-ui、jore4-api）无缝集成
• 安全协议支持：可能包含 OAuth2/OIDC 等标准认证协议支持（具体取决于项目实现）
• 访问控制：确保只有授权用户/服务能访问受保护资源

使用场景

• Jore4 系统用户登录与身份验证
• Jore4 内部微服务间的安全通信认证
• 第三方应用集成 Jore4 系统的授权流程
• 管理员对用户权限的集中管理与审计

使用方法与配置说明

前提条件

• Docker 19.03+ 环境
• 与 Jore4 其他服务的网络连通性
• 必要的配置参数（如数据库连接信息、密钥等）

快速启动（Docker Run）

bash
docker run -d \
  --name jore4-auth \
  -p 8080:8080 \
  -e SPRING_PROFILES_ACTIVE=prod \
  -e DB_HOST=postgres-host \
  -e DB_PORT=5432 \
  -e DB_USER=auth-db-user \
  -e DB_PASSWORD=auth-db-pass \
  -e JWT_SECRET=your-secure-jwt-secret \
  hsldevcom/jore4-auth:latest

Docker Compose 配置示例

yaml
version: '3.8'
services:
  jore4-auth:
    image: hsldevcom/jore4-auth:latest
    container_name: jore4-auth
    ports:
      - "8080:8080"
    environment:
      # 基础配置
      - SPRING_PROFILES_ACTIVE=prod
      - SERVER_PORT=8080
      # 数据库配置
      - DB_HOST=jore4-postgres
      - DB_PORT=5432
      - DB_NAME=jore4_auth
      - DB_USER=auth_user
      - DB_PASSWORD=${DB_PASSWORD}  # 建议通过环境变量注入敏感信息
      # 安全配置
      - JWT_SECRET=${JWT_SECRET}
      - JWT_EXPIRATION=86400000  # JWT令牌有效期（毫秒）
      # 日志配置
      - LOG_LEVEL_ROOT=INFO
      - LOG_LEVEL_COM_HSL=DEBUG
    depends_on:
      - jore4-postgres
    restart: unless-stopped

  jore4-postgres:
    image: postgres:14-alpine
    container_name: jore4-auth-db
    environment:
      - POSTGRES_DB=jore4_auth
      - POSTGRES_USER=auth_user
      - POSTGRES_PASSWORD=${DB_PASSWORD}
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

核心环境变量说明

访问服务

服务启动后，可通过 http://<容器IP>:8080 访问，核心端点可能包括：

• /auth/login：用户登录接口
• /auth/logout：用户注销接口
• /auth/token：令牌获取/刷新接口
• /auth/authorize：授权验证接口（具体端点以项目实际实现为准）

注意事项

• 敏感信息管理：生产环境中，JWT_SECRET、DB_PASSWORD 等敏感信息需通过安全方式注入（如 Docker Secrets、环境变量文件），避免明文配置
• 配置文件：如需自定义配置，可通过挂载配置文件（如 application-prod.yml）覆盖默认配置，挂载路径通常为 /app/config/
• 版本兼容性：使用时需确保与 Jore4 其他服务版本匹配，具体版本兼容性信息可参考项目 https://github.com/HSLdevcom/jore4-auth 的 release 说明
• 日志与监控：建议配置日志输出至标准输出，便于容器日志收集；可通过暴露健康检查端点（如 /actuator/health）实现服务监控

参考资料

• 官方代码仓库：https://github.com/HSLdevcom/jore4-auth
• Jore4 项目文档：请参考 HSLdevcom 提供的 Jore4 整体项目文档