背景
支持在 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预审
是