创建主密钥
功能说明
用户管理主密钥,提供的创建接口,通过此接口可以创建主密钥并导出主秘钥,主密钥用于加密工作密钥。
URL
POST https://ip:port/AIVAULT/v1/createMK
请求Header
参数名 |
类型 |
说明 |
DomainID |
uint |
密钥作用域ID,可以表示应用或者模型的域。取值范围为[1, 500]。 |
- 该请求Header中的参数由用户自行填写。
- DomainID用于区分不同的应用或者模型,最多支持500个域。
请求参数
参数名 |
必选 |
类型 |
说明 |
MKName |
必选 |
string |
主密钥名称,同一domain下名称必须唯一不可重复,长度为[1, 128],仅支持数字、字母、下划线和“-”字符 |
MKUsage |
必选 |
string |
主密钥的用途,长度为[1, 128],仅支持数字、字母、空格下划线和“-”字符,不支持全空格。 |
MKRemarks |
可选 |
string |
备注信息。长度为[0, 256],仅支持数字、字母、空格下划线和“-”字符。 |
Password |
必选 |
string |
用户持有的口令,口令长度40≤Password≤64,且需要包含数字、大写字母、小写字母、特殊字符(至少两种),且不能与MKName或反转MKName相同 |
请求示例
https://ip:port/AIVAULT/v1/createMK { "MKName":"test", "MKUsage":"test create", "MKRemarks":"test create", "Password" :"******" }
响应说明
一级参数名 |
类型 |
说明 |
status |
string |
错误码(失败返回) |
msg |
string |
错误信息(失败返回) |
data |
string |
返回报文列表(失败返回) |
MKFile |
File |
主秘钥文件,成功返回json文件 |
响应示例
{ "Version": "V1", "CipherMasterKey": "******" }
错误码见错误码说明。
状态码见状态码说明。
父主题: API参考