接口認(rèn)證安全類實(shí)例

1、 16 附 錄 A （資料性） 接口認(rèn)證安全類實(shí)例 A.1 基于簽名驗(yàn)證的接口認(rèn)證安全類實(shí)例 A.1.1 接口描述 基于簽名驗(yàn)證的接口認(rèn)證，在 HTTP 協(xié)議的請(qǐng)求頭中包含身份 ID、請(qǐng)求時(shí)間戳以及 HMAC 數(shù)據(jù)， 由響應(yīng)方進(jìn)行信息驗(yàn)證，從而實(shí)現(xiàn)接口認(rèn)證的過(guò)程。 請(qǐng)求方法：GET/POST。 請(qǐng)求 URL：見(jiàn)《市級(jí)融媒體中心接口規(guī)范》中的附錄 A。 A.1.2 請(qǐng)求參數(shù) 請(qǐng)求頭： Content-Type: applicatio

2、n/json X-Extend-ID: 7aa640627a5fb2650e2718df7113863a（示例值） X-Extend-Timestamp: 1654516621644（示例值） X-Extend-Signature: 04b29480233f4def5c875875b6bdc3b1（示例值） 請(qǐng)求體： { ?? } 請(qǐng)求頭參數(shù)說(shuō)明： ——X-Extend-ID 為市級(jí)融媒體中心與通信方商議的 ID； ——X-Extend

3、-Timstamp 為本次請(qǐng)求的時(shí)間戳； ——X-Extend-Signature 為本次請(qǐng)求的 HMAC 數(shù)據(jù)。 簽名生成方法如下： X-Extend-Signature = HMAC-X(Key, ID + “:“ + RequestMethod + “:“ + RequestPath + “:“ + Timestamp + “:“+HASH(RequestBody)) 其中： ——Key 為市級(jí)融媒體中心與通信方商議的密鑰； ——

4、RequestMethod 為本次請(qǐng)求采用的方法，GET 或 POST； ——RequestPath 為本次請(qǐng)求資源路徑 URL； ——HASH(RequestBody)為請(qǐng)求體的雜湊值，如果為 GET 請(qǐng)求，此值為空； ——HMAC-X 為基于 HMAC 的密鑰摘要生成算法，如 HMAC-SM3 等。 A.1.3 響應(yīng)參數(shù) 響應(yīng)頭：Content-Type: application/json 消息體包含：結(jié)果狀態(tài)、結(jié)果描述、data

5、、支撐技術(shù)能力開(kāi)放接口的任務(wù)狀態(tài)值（在支撐技術(shù)能力開(kāi)放接口中才包含，其他接口不包含該值）；data 值、支撐技術(shù)能力開(kāi)放接口的任務(wù)狀態(tài)值見(jiàn)《市級(jí)融媒體中心接口規(guī)范》中的附錄 A。 支撐技術(shù)能力開(kāi)放接口“成功”返回消息體樣例如下： 18 A.2.2.1 接口描述 請(qǐng)求方從響應(yīng)方處獲取訪問(wèn)令牌。 請(qǐng)求方法：POST。 請(qǐng)求URL：http(s)://{域名}/{服務(wù)名}/{版本}/[{可選值}]/oauth/token?grant_typ

6、e=password&appid=&secret= URL 參數(shù)說(shuō)明： ——grant_type 值固定為 password； ——appid 值為市級(jí)融媒體中心與通信方商議的 ID； ——secret 值為市級(jí)融媒體中心與通信方商議的密鑰。 A.2.2.2 請(qǐng)求參數(shù) 請(qǐng)求頭： Content-Type: application/x-www-form-urlencoded 請(qǐng)求消息體為空。 A.2.2.3 響應(yīng)參數(shù)

7、響應(yīng)頭：Content-Type: application/x-www-form-urlencoded 消息體包含：結(jié)果狀態(tài)、結(jié)果描述。 “成功”返回消息體樣例如下： { “code“: 0, “message“: “成功“, “data“: { “access_token“:“7e186b71b666aadcd3c344bc2b7e7007“,（示例值） “refresh_token“:“d5b8db762504c5ba2a4ea

8、410aa6a2edd“,（示例值） “expires_in“:“7200“（示例值） } } 消息體參數(shù)說(shuō)明： ——access_token 為獲取到的調(diào)用實(shí)際接口的訪問(wèn)令牌； ——refresh_token 為更新訪問(wèn)令牌的令牌； ——expires_in 為訪問(wèn)令牌的有效時(shí)長(zhǎng)，單位為秒。 “失敗”返回消息體樣例如下： { “code“: -1, “message“: “獲取訪問(wèn)令牌失?。篒D無(wú)效“或“獲取訪問(wèn)令牌失敗：密碼無(wú)效