接口認證安全類實例

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

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

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

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

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

6、e=password&appid=&secret= URL 參數(shù)說明： ——grant_type 值固定為 password； ——appid 值為市級融媒體中心與通信方商議的 ID； ——secret 值為市級融媒體中心與通信方商議的密鑰。 A.2.2.2 請求參數(shù) 請求頭： Content-Type: application/x-www-form-urlencoded 請求消息體為空。 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ù)說明： ——access_token 為獲取到的調(diào)用實際接口的訪問令牌； ——refresh_token 為更新訪問令牌的令牌； ——expires_in 為訪問令牌的有效時長，單位為秒。 “失敗”返回消息體樣例如下： { “code“: -1, “message“: “獲取訪問令牌失敗：ID無效“或“獲取訪問令牌失敗：密碼無效