sourcepole/qwc-db-auth

QWC DB认证服务

镜像概述

QWC DB认证服务是QWC (QGIS Web Client) 生态系统的核心组件，提供基于数据库的用户认证与授权管理功能。该服务负责验证用户身份、管理用户角色与权限，并与QWC其他服务（如地图服务、数据服务）集成，确保QWC系统的安全访问控制。

核心功能与特性

• 数据库驱动的用户管理：用户信息（用户名、密码哈希、角色等）存储于关系型数据库，支持动态用户配置
• 身份验证机制：提供用户名/密码验证，支持安全的密码哈希存储（如bcrypt加密）
• 授权控制：基于角色的访问控制（RBAC），可定义用户角色及对应权限范围
• QWC生态集成：与QWC系列服务无缝对接，提供标准化认证接口
• 配置灵活性：通过环境变量或配置文件自定义数据库连接、服务端口、日志级别等参数

使用场景与适用范围

• 部署QGIS Web Client的WebGIS系统，需集中式用户认证管理
• 中小型GIS项目，需要轻量级数据库认证解决方案
• 与PostgreSQL等关系型数据库集成的用户权限管理场景
• QWC生态服务集群中的统一身份认证节点

使用方法与配置说明

前提条件

• 已部署关系型数据库（推荐PostgreSQL）用于存储用户数据
• Docker Engine 18.09+ 或 Docker Compose环境

Docker运行示例

bash
docker run -d \
  --name qwc-db-auth \
  -p 5017:5017 \
  -e DB_HOST=postgres \
  -e DB_PORT=5432 \
  -e DB_NAME=qwc_auth \
  -e DB_USER=qwc_auth_user \
  -e DB_PASSWORD=secure_password \
  -e SERVICE_PORT=5017 \
  -e LOG_LEVEL=INFO \
  docker.xuanyuan.run/qwc-db-auth:latest

Docker Compose配置示例

yaml
version: '3'

services:
  qwc-db-auth:
    image: docker.xuanyuan.run/qwc-db-auth:latest
    container_name: qwc-db-auth
    ports:
      - "5017:5017"
    environment:
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_NAME=qwc_auth
      - DB_USER=qwc_auth_user
      - DB_PASSWORD=secure_password
      - SERVICE_PORT=5017
      - LOG_LEVEL=INFO
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: docker.xuanyuan.run/postgres:13
    container_name: qwc-auth-db
    environment:
      - POSTGRES_DB=qwc_auth
      - POSTGRES_USER=qwc_auth_user
      - POSTGRES_PASSWORD=secure_password
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

配置参数说明

集成与扩展

该服务通过REST API提供认证服务，用户认证成功后返回会话令牌，供QWC其他服务验证权限。详细API文档及扩展配置请参考https://github.com/qwc-services/qwc-db-auth%E3%80%82

注意事项

• 数据库密码需使用强密码，建议通过环境变量或安全配置管理工具注入
• 首次部署需初始化数据库表结构，可参考GitHub仓库中的迁移脚本
• 生产环境建议配置HTTPS以保障认证信息传输安全

注：具体功能与配置以https://github.com/qwc-services/qwc-db-auth%E6%9C%80%E6%96%B0%E6%96%87%E6%A1%A3%E4%B8%BA%E5%87%86%E3%80%82