【待评审】新增LDAP测试连通性北向接口

背景

支持在 LDAP 配置阶段确认配置是否可用,需要新增 Web Rest 测试连通性接口。

关联ISSUE

暂无。

整体方案

新增 Web Rest 接口 POST /UI/Rest/AccessMgnt/LDAP/:controllerid/TestConnection,请求体只包含终端 UserName、Password 和二次鉴权字段 ReauthKey。

  • UserName:用于表示测试 LDAP 认证所使用的终端用户名;
  • Password:用于表示该终端用户的登录密码;
  • ReauthKey:用于表示二次鉴权字段

评审点

新增 Web Rest 接口 POST /UI/Rest/AccessMgnt/LDAP/:controllerid/TestConnection。

详细描述

评审点1:新增 Web Rest 接口 POST /UI/Rest/AccessMgnt/LDAP/:controllerid/TestConnection

URI:/UI/Rest/AccessMgnt/LDAP/:controllerid/TestConnection

操作类型:POST

变化类型:新增接口

应用场景:LDAP 配置页面“测试连通性”,测试已保存的域控制器配置是否可用

操作权限:UserMgmt

项 内容
请求体 UserName、Password、ReauthKey
成功响应 HTTP 200,空对象 {}
失败响应 {"error":[{"code":"...","message":"..."}]};新增错误码 HTTP 400,复用错误码 HTTP 401

路径参数:

参数名 类型 必填 取值约束 描述
controllerid integer 是 1~6(MAX_LDAP_COUNT) 已保存的 LDAP 域控制器 ID

请求体字段:

参数名 类型 必填 示例/取值约束 描述
UserName string 是 长度 1~255,示例:zhangsan 待测试的 LDAP 用户名
Password string 是 敏感字段,RSA 加密传输;空密码由 iam 校验并返回 LdapInvalidCredentials 待测试的 LDAP 用户密码;映射到 MDB 方法时为 U8[]
ReauthKey string 条件必填 长度 1~128,敏感字段,RSA 加密传输;isNoPwd 模式不发送 当前管理员登录密码的 base64 值,用于二次鉴权

请求示例:

POST /UI/Rest/AccessMgnt/LDAP/1/TestConnection
Content-Type: application/json
Encrypted-Properties: ["Password","ReauthKey"]

成功响应:

{
  "UserName": "zhangsan",
  "Password": "<rsa-encrypted>",
  "ReauthKey": "<rsa-encrypted>"
}

失败响应

{
  "error": [
    {
      "code": "LdapServerUnreachable",
      "message": "Failed to connect to the LDAP server."
    }
  ]
}

是否准备好AI预审

是

评审结论