创建预共享密钥

功能说明

此接口可用于用户创建预共享密钥,预共享密钥创建后绑定MK立即返回给用户,后续无法再次从AIVAULT获取到该密钥。返回给用户的预共享密钥已使用口令进行加密处理。

URL

POST https://ip:port/AIVAULT/v1/createPSK

请求Header

表1 请求Header

参数名

类型

说明

DomainID

uint

密钥作用域ID,可以表示一个组织、一个应用或者一个模型的域。取值范围为[1, 500]。

  1. 该请求Header中的参数由用户自行填写。
  2. DomainID用于区分不同的应用或者模型,最多支持500个域。

请求参数

表2 请求参数

参数名

是否必选

类型

说明

PSKName

必选

string

预共享密钥名称,同一DomainID名称必须唯一不可重复,长度为[1, 128],仅支持数字、字母、下划线和“-”字符

MKName

必选

string

主密钥名称,同一domain下名称必须唯一不可重复,长度为[1, 128],仅支持数字、字母、下划线和“-”字符

PSKRemarks

可选

string

备注信息,长度为[0, 256],仅支持数字、字母、空格下划线和“-”字符。

Password

必选

string

用户持有的口令,口令长度大于等于40位,小于等于64位,且需要包含数字、大写字母、小写字母、特殊字符中至少2种,且不能与PSKName或反转PSKName相同

请求示例

https://ip:port/AIVAULT/v1/createPSK
{
    "PSKName":"test",
    "MKName":"test",
    "PSKRemarks":"test",
    "Password":"******"
}

响应说明

表3 响应说明

一级参数名

二级参数名

类型

说明

status

\

string

错误码

msg

\

string

错误信息

data

\

object

返回报文列表

\

PSK

string

预共享密钥密文

响应示例

{
    "status":"00000000",
    "msg":"ok",
    "data":{
          "PSK":    "******"
}

错误码见错误码说明

状态码见状态码说明