系统概述

浙通信息用户管理中台是一套面向企业的统一身份认证与用户管理系统，提供用户全生命周期管理、角色权限控制、安全策略配置、LDAP/RADIUS 集成及全面的日志审计能力。

统一响应格式

所有 API 接口返回统一的 JSON 格式：

{
  "code": 200,
  "message": "操作成功",
  "data": {
    // 业务数据
  }
}

认证说明

系统支持两种认证方式：Session Cookie 认证（Web 前端）和 API Token 认证（第三方集成 / RESTful API v1）。

curl -X GET https://your-domain/api/v1/users \
  -H "Authorization: Bearer your_api_token_here"

通用请求头

密码策略

系统密码策略可通过 /api/security/password-policy 接口进行配置，支持多维度密码复杂度要求和安全锁定机制。

错误码说明

API 接口使用标准 HTTP 状态码，响应体中的 code 字段与 HTTP 状态码一致。

LDAP 服务端

系统内置 LDAP 服务端，可为外部应用提供统一的 LDAP 身份认证服务。支持 SM3 密码哈希算法，可与用户管理中台数据同步。

LDAP 服务端管理接口

LDAP 服务端的配置查询、更新、状态监控及启停控制可通过以下接口管理：

• GET /api/security/ldap-server/config — 获取服务端配置
• PUT /api/security/ldap-server/config — 更新服务端配置
• GET /api/security/ldap-server/status — 获取运行状态
• POST /api/security/ldap-server/control — 启动 / 停止服务

LDAP 客户端配置

系统同时支持作为 LDAP 客户端连接外部 LDAP 服务器，可通过 /api/security/ldap 系列接口配置外部 LDAP 连接参数并同步用户。

# 外部应用通过 LDAP 认证示例
ldapsearch -H ldap://your-domain:1389 \
  -D "uid=testuser,dc=ztinfo,dc=com" \
  -W \
  -b "dc=ztinfo,dc=com" \
  "(uid=testuser)"

数据库表结构

系统使用 SQLite 数据库，共包含 22 张数据表，涵盖用户、部门、角色、权限、安全配置、日志及系统设置等。

API 接口

系统共提供 89 个 API 接口，按功能分为 19 个分类。所有接口均以 /api 为前缀。支持在下方搜索框中按关键词过滤接口。