HTTPS原生調用介紹

風險識別API服務也支持HTTPS原生調用，原生方式需要用戶自行封裝加解簽、拼裝請求（URL、Body、header、parameters）。

1. 基本信息

服務請求地址：https://saf.cn-shanghai.aliyuncs.com

協議：HTTPS

HttpMethod: POST

2. 簽名方式

風險識別服務會對每個訪問的請求進行身份驗證，因此，需要在請求中包含簽名（Signature）信息。風險識別服務通過使用Access Key ID和Access Key Secret進行對稱加密的方法來驗證請求的發送者身份。Access Key ID和Access Key Secret由阿里云官方頒發給訪問者（可以通過阿里云官方網站申請和管理），其中Access Key ID用于標識訪問者身份；Access Key Secret是用于加密簽名字符串和服務器端驗證簽名字符串的密鑰，必須嚴格保密，只有阿里云和用戶知道。

用戶在訪問時，按照下面的方法對請求進行簽名處理：

1. 使用請求參數構造規范化的請求字符串（Canonicalized Query String）

   a. 按照參數名稱的字典順序對請求中所有的請求參數（包括文檔中描述的“公共請求參數”和給定了的請求接口的自定義參數，但不能包括"公共請求參數"中提到的Signature參數本身）進行排序。

   b. 對相關請求參數的名稱和值進行編碼。名稱和值要使用UTF-8字符集進行URL編碼，URL編碼的編碼規則是：

    i.對于字符A-Z、a-z、0-9以及字符"-"、"_"、"."、"~"不編碼；
    ii. 對于其它字符編碼成"%XY"的格式，其中XY是字符對應ASCII碼的16進制表示。比如英文的雙引號（"）對應的編碼就是%22
    iii.對于擴展的UTF-8字符，編碼成"%XY%ZA…"的格式；
    iv. 需要說明的是英文空格（ ）要被編碼是%20，而不是加號（+）。
        

   注： 一般支持URL編碼的庫（比如Java中的java.net.URLEncoder）都是按照"application/x-www-form-urlencoded"的MIME類型的規則進行編碼的。實現時可以直接使用這類方式進行編碼，把編碼后的字符串中加號（+）替換成%20、星號（*）替換成%2A、%7E替換回波浪號（~），即可得到上述規則描述的編碼字符串。

   c. 對編碼后的參數名稱和值使用英文等號（=）進行連接。

   d. 再把英文等號連接得到字符串按參數名稱的字典順序依次使用&符號連接，即得到規范化請求字符串。

2. 使用上一步（步驟1）構造的規范化字符串按照下面的規則構造用于計算簽名的字符串：

    StringToSign=
    HTTPMethod + "&" +
    percentEncode（"/"） + "&" +
    percentEncode（CanonicalizedQueryString）
        

   其中HTTPMethod是提交請求用的HTTP方法，比如POST。

   percentEncode（"/"）是按照1.b中描述的URL編碼規則對字符"/"進行編碼得到的值，即"%2F"。

   percentEncode（CanonicalQueryString）是對第1步中構造的規范化請求字符串按1.b中描述的URL編碼規則編碼后得到的字符串。

3. 按照RFC2104的定義，使用上面的用于簽名的字符串計算簽名HMAC值。注意：計算簽名時使用的Key就是用戶持有的Access Key Secret并加上一個"&"字符（ASCII:38），使用的哈希算法是SHA1。

4. 按照Base64編碼規則把上面的HMAC值編碼成字符串，即得到簽名值（Signature）。

5. 將得到的簽名值作為Signature參數添加到請求參數中，即完成對請求簽名的過程。

（注意：得到的簽名值在作為最后的請求參數值提交給風險識別服務器時，要和其他參數一樣，按照RFC3986的規則進行URL編碼。）