获取托管密码
<p class="shortdesc"></p>
<section class="section" id="UNDERCUSTODY__section_z1b_cfj_mlb"><h2 class="doc-tairway">获取托管密码:GetKeychainPassword</h2>
<p class="p"><strong class="ph b">描述</strong></p>
<p class="p">查询托管密码,返回的值是经过AES_128对称加密的密文,使用时需要进行对称解密。</p>
<p class="p"><strong class="ph b">请求参数</strong></p>
<table class="table" id="UNDERCUSTODY__table_lnj_cfj_mlb"><caption></caption><colgroup><col><col><col><col></colgroup><thead class="thead">
<tr class="row">
<th class="entry" id="UNDERCUSTODY__table_lnj_cfj_mlb__entry__1">
<p class="p">名称</p>
</th>
<th class="entry" id="UNDERCUSTODY__table_lnj_cfj_mlb__entry__2">
<p class="p">类型</p>
</th>
<th class="entry" id="UNDERCUSTODY__table_lnj_cfj_mlb__entry__3">
<p class="p">是否必须</p>
</th>
<th class="entry" id="UNDERCUSTODY__table_lnj_cfj_mlb__entry__4">
<p class="p">描述</p>
</th>
</tr>
</thead><tbody class="tbody">
<tr class="row">
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__1 ">
<p class="p">requestTime</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__2 ">
<p class="p">String</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__3 ">
<p class="p">是</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__4 ">
<p class="p">请求时间,格式为:yyyyMMddhhmmssSSS</p>
</td>
</tr>
<tr class="row">
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__1 ">
<p class="p">appId</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__2 ">
<p class="p">String</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__3 ">
<p class="p">是</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__4 ">
<p class="p">应用的唯一识别码,由系统分配</p>
</td>
</tr>
<tr class="row">
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__1 ">
<p class="p">keychainAccount</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__2 ">
<p class="p">String</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__3 ">
<p class="p">否</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__4 ">
<p class="p">托管的账号名称(如数据库的账号名称)</p>
</td>
</tr>
<tr class="row">
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__1 ">
<p class="p">reason</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__2 ">
<p class="p">String</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__3 ">
<p class="p">否</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__4 ">
<p class="p">获取原因</p>
</td>
</tr>
<tr class="row">
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__1 ">
<p class="p">encryptVersion</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__2 ">
<p class="p">String</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__3 ">
<p class="p">否</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__4 ">
<p class="p">加密版本(获取到的密码的加密方式)</p>
<p class="p">可选字段,用于区分加解密模式,兼容AES的ECB和CBC两种模式</p>
<p class="p">传参,encryptVersion="2.0",为AES的CBC加密模式</p>
<p class="p">不传参,则默认为AES的ECB加密方式</p>
<p class="p">目前仅支持上面两种方式,否则会报参数错误</p>
</td>
</tr>
<tr class="row">
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__1 ">
<p class="p">sign</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__2 ">
<p class="p">String</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__3 ">
<p class="p">是</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_lnj_cfj_mlb__entry__4 ">
<p class="p">签名值,见签名算法</p>
</td>
</tr>
</tbody></table>
<p class="p"><strong class="ph b">返回参数</strong></p>
<table class="table" id="UNDERCUSTODY__table_mnj_cfj_mlb"><caption></caption><colgroup><col><col><col></colgroup><thead class="thead">
<tr class="row">
<th class="entry" id="UNDERCUSTODY__table_mnj_cfj_mlb__entry__1">
<p class="p">名称</p>
</th>
<th class="entry" id="UNDERCUSTODY__table_mnj_cfj_mlb__entry__2">
<p class="p">类型</p>
</th>
<th class="entry" id="UNDERCUSTODY__table_mnj_cfj_mlb__entry__3">
<p class="p">描述</p>
</th>
</tr>
</thead><tbody class="tbody">
<tr class="row">
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__1 ">
<p class="p">code</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__2 ">
<p class="p">String</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__3 ">
<p class="p">返回码,成功返回"SUCCESS"</p>
</td>
</tr>
<tr class="row">
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__1 ">
<p class="p">responseTime</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__2 ">
<p class="p">String</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__3 ">
<p class="p">响应时间,格式为:yyyyMMddhhmmssSSS</p>
</td>
</tr>
<tr class="row">
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__1 ">
<p class="p">appId</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__2 ">
<p class="p">String</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__3 ">
<p class="p">应用的唯一识别码,由系统分配</p>
</td>
</tr>
<tr class="row">
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__1 ">
<p class="p">keychainAccount</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__2 ">
<p class="p">String</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__3 ">
<p class="p">托管的账号名称(如数据库的账号名称)</p>
</td>
</tr>
<tr class="row">
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__1 ">
<p class="p">region</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__2 ">
<p class="p">String</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__3 ">
<p class="p">托管的区域</p>
</td>
</tr>
<tr class="row">
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__1 ">
<p class="p">reason</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__2 ">
<p class="p">String</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__3 ">
<p class="p">获取原因,返回请求中的输入</p>
</td>
</tr>
<tr class="row">
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__1 ">
<p class="p">keychainPassword</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__2 ">
<p class="p">String</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__3 ">
<p class="p">获取到的托管密码密文,加密方式见加密算法</p>
</td>
</tr>
<tr class="row">
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__1 ">
<p class="p">sign</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__2 ">
<p class="p">String</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__3 ">
<p class="p">见签名算法</p>
</td>
</tr>
<tr class="row">
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__1 ">
<p class="p">requestId</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__2 ">
<p class="p">String</p>
</td>
<td class="entry" headers="UNDERCUSTODY__table_mnj_cfj_mlb__entry__3 ">
<p class="p">当前请求Id</p>
</td>
</tr>
</tbody></table>
<p class="p"><strong class="ph b">请求示例</strong></p>
<pre class="pre codeblock"><code>https://kms-cn-shanghai.yun.pingan.com/?action=GetKeychainPassword
&reason=<get password reason>
&sign=<sign>
&requestTime=<requestTime>
&appId=<app id>
&keychainAccount=<keychainAccount>
&<公共请求参数></code></pre>
<p class="p"><strong class="ph b">返回示例</strong></p>
<pre class="pre codeblock"><code>{
"code": "SUCCESS",
"reason": "your get password reason",
"responseTime": "20181204162959982",
"appId": "your appId",
"sign": "sign value",
"keychainAccount": "keychainAccount",
"keychainPassword": "password"
"requestId": "7d5e94eb-75b6-45fc-a974-30d21296f48b",
}</code></pre>
</section>
提交成功!非常感谢您的反馈,我们会继续努力做到更好!