modifyPassword：修改设备密码

已弃用： 新接入请使用 修改设备密码（device.password.set）。本页仅供存量 HTTP 对接查阅。

功能说明

修改设备密码。

说明：本接口以设备是否具备密码管理能力为准（历史上以 TCM 为主；现网亦支持其它型号，如 prosegur 等）。

请求地址

https://openapi-[DataCenter].easy4ip.com/openapi/modifyPassword

请求格式

POST JSON 请求体见 请求约定；签名见 签名。

请求参数

password 加密算法说明 计算公式：Base64(AES256_CBC(sourcePassword, Key[], IV[])) 加密规则如下：

1. 采用 CBC 分组加密，算法为 AES/CBC/PKCS5Padding；
2. sourcePassword 为设备明文密码；
3. Key[] 为密钥（key）的二进制数组；
4. key = LowerCase(MD5(UpperCase(Base64(KDF(deviceId, MD5(appSecret))))))，KDF 算法为 PBKDF2WithHmacSHA256，迭代 1200 次，导出密钥长度 256 位；
5. IV[] 为初始化向量二进制数组，取值为 MD5(appSecret)（Java 自带 MessageDigest 的 MD5 算法）。

设备新密码规则要求：

1. 密码须至少包含数字、大写字母、小写字母、特殊字符中的两类，长度 8～32 位；特殊字符指除 '、"、;、:、&、空格以外的任意可见字符；
2. 密码不能包含中文字符。

oldPasswordV2 / newPasswordV2 加密（V2）

与 v2 能力接口 device.password.set 使用同一算法：

设备密码字段加密（v2 OpenAPI）

适用字段：device.password.verify 的 passwordV2；device.password.set 的 oldPasswordV2、newPasswordV2。三者同一套算法（与绑定页 encryptCodeV2 同族，字段名不同）。

不使用 appSecret 参与 v2 密钥派生。

新密码明文（仅 newPasswordV2 加密前）：长度 8～32；数字、大写字母、小写字母、特殊字符中至少两类；特殊字符为除 '、"、;、:、&、空格外的可见字符；不得含中文。

验密成功后改密：可将本次请求的 passwordV2 整段密文原样填入 oldPasswordV2（同一 appId、deviceId、同一明文）。

请求示例

{
 "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af",
 "system":{
 "ver":"1.0",
 "appId":"lcdxxxxxxxxx",
 "sign": "xjhCQBoJ9hRDsCjyDcHjtDNzRZ3ZJezcawsfWeiaoxU=",
 "time":1599031074,
 "nonce":"8ec8a7bd1d1c95420de20d92422d457d"
 },
 "params":{
 "token":"At_00006acr3456d12312d3grf60147de7ec",
 "deviceId":"TESTQWERXXXX",
 "oldPassword":"jdueu37ajusdii3873jsc8",
 "newPassword":"ewurosd739fdjf102kg823"
 }
}

返回 data 字段

无返回数据

响应示例

{
 "result":{
 "msg":"操作成功.",
 "code":"0"
 },
 "id":"d5c287b4-5b2f-4f03-baf5-8032c5c354af"
}

错误码

本接口可能返回下列码；完整分组见 错误码 与 能力错误码。

网关与鉴权（SN / TK / OP）

更多见 错误码 · OP/SN/TK。

子账号（SUB）

更多见 错误码 · SUB。

设备访问与通道（DV10xx）

更多见 错误码 · DV。

设备密码（DV10xx）

相关参考

• 开发规范
• 公共约定
• 修改设备密码
• 本模块索引