開放API接口驗證機制設計與應用

背景

最近,公司由于業務繁忙人手不夠,將部分業務外包給第三方公司做。在開發的過程中,遇到了外部調用內部敏感接口場景。為了保證接口的安全,基于微信公眾號消息驗證機制,實現了一套安全驗證流程。

微信公眾號消息驗證流程

當開發者向微信提交信息(含 token 配置)后,微信服務器會發送攜帶參數的GET請求到開發者的服務器,攜帶的驗證信息如下:

參數 描述
signature 加密簽名
timestamp 時間戳
nonce 隨機數
echostr 隨機字符串

開發者將通過檢驗 signature對請求進行驗證。驗證流程如下:
1)將token、timestamp、nonce三個參數進行字典序排序
2)將三個參數字符串拼接成一個字符串進行sha1加密
3)開發者獲得加密后的字符串可與signature對比,若相同,則驗證成功。

總結一下微信驗證的原理,通過比對開發者生成的簽名與微信發送的簽名,來驗證請求是否合法。
微信與開發者共同維護一個 token(作為秘鑰,不發生傳遞),使用相同的簽名機制,得到相同的簽名。

驗證機制設計

簽名流程

前提:接口提供方與接入方,協商維護一個token??梢钥醋鲭p方維護的密鑰。

  1. 請求方攜帶參數請求接口,參數包括 signature、timestamp、nonce、業務參數。

例如,傳送的參數如下:

signature: 8bbf7cde111af0c0655f578c5a84185e8f533880
timestamp: 1535253509
nonce: TyPoTPVYmp
user_id: 1
  1. 將參數和 token 以字母升序(A-Z)排序,除去 signature

特別注意:

  • 參數名 以字母升序排序
  • signature 不參與排序
const token = 'youthcity';
const { signature, timestamp, nonce, user_id } = ctx.request.query;
const unordered_params = {
  timestamp,
  nonce,
  user_id,
  token,
};

const ordered_params = {};
Object.keys(unordered_params).sort().forEach((key) => {
  ordered_params[key] = unordered_params[key];
});
  1. 再以 'key=value'+ '&' + 'key=value'連接所有參數得到字符串。
let sign_str = Object.keys(ordered_params)
  .map((key) => `${key}=${ordered_params[key]}`)
  .join('&');
  1. sign_str 進行 sha1 加密
const expected_signature = crypto.createHash('sha1').update(sign_str).digest('hex');

服務端攔截規則設計

對于開放接口,主要面臨3個安全問題:

  1. 請求身份是否可信任
  2. 請求的參數是否被篡改
  3. 請求是否唯一(防止重放攻擊

將針對這三個問題,進行攔截設計。

1)驗證請求參數是否包含 signaturetimestamp、nonce、業務參數。若參數缺少或類型不合法,則返回錯誤碼。

2)判斷服務端接受請求時間與請求參數中的timestamp的時間差是否在合理的范圍內(建議為正負 5min)。若時間差超過合理值,則請求過期,視為無效請求。(即使請求URL中的 timestamp被篡改,signature會對其合法性進行校驗)

3)判斷請求是否已被使用。根據 nonce,判斷緩存中是否存在 KEY,若存在,則請求已被使用,返回錯誤碼。若不存在,則以 nonce為KEY,寫入緩存,并設置過期時間為 10min。

主要目的是為了防止重放攻擊。避免請求參數被泄露,被其他方盜用攻擊。

4)根據請求參數生成簽名。對比簽名是否相同。若相同,則進入業務邏輯,否則,進行攔截。

小結

通過 時間戳(timestamp)和隨機數(nonce)我們可以防御大多數的請求重放攻擊。隨機數(nonce)可以防御短期的重放攻擊,若隨機數過期,則黑客可以繞過隨機數的防御。這時,可以利用時間戳(timestamp)的長期防御,攔截請求。

優化與改進

  1. 對于安全等級較高的接口,我們還可以利用IP白名單機制,進行防御。

總結

在簽名驗證設計中,我們將時間戳和隨機數作為驗證的一部分。主要目的是防止請求鏈接盜用。關于時間戳的有效范圍,需要根據實際業務場景和接入方服務情況進行調整。時間范圍太小,可能會導致接入方請求失敗。時間范圍太長,請求唯一性的保證就越弱。

此外,安全驗證只能驗證接入方是否合法。不能保證 token泄密或者受信任方濫用接口的情況。因此,需要在業務層面,根據具體情況進行二次防御設計。例如,記錄調用歷史,或限制每日調用頻次限制。

參考資料

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,786評論 6 534
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,656評論 3 419
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事?!?“怎么了?”我有些...
    開封第一講書人閱讀 176,697評論 0 379
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,098評論 1 314
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,855評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,254評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,322評論 3 442
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,473評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,014評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,833評論 3 355
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,016評論 1 371
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,568評論 5 362
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,273評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,680評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,946評論 1 288
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,730評論 3 393
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,006評論 2 374

推薦閱讀更多精彩內容