WebHook 管理和部署系統

天府雲創發表於2018-06-12

一、概述

Webhook是一個API概念,並且變得越來越流行。我們能用事件描述的事物越多,webhook的作用範圍也就越大。Webhook作為一個輕量的事件處理應用,正變得越來越有用。

準確的說webhoo是一種web回撥或者http的push API,是向APP或者其他應用提供實時資訊的一種方式。Webhook在資料產生時立即傳送資料,也就是你能實時收到資料。這一種不同於典型的API,需要用了實時性需要足夠快的輪詢。這無論是對生產還是對消費者都是高效的,唯一的缺點是初始建立困難。

Webhook有時也被稱為反向API,因為他提供了API規則,你需要設計要使用的API。Webhook將向你的應用發起http請求,典型的是post請求,應用程式由請求驅動。

二、使用webhook

消費一個webhook是為webhook準備一個URL,用於webhook傳送請求。這些通常由後臺頁面和或者API完成。這就意味你的應用要設定一個通過公網可以訪問的URL。

多數webhook以兩種資料格式釋出資料:JSON或者XML,這需要解釋。另一種資料格式是application/x-www-form-urlencoded or multipart/form-data。這兩種方式都很容易解析,並且多數的Web應用架構都可以做這部分工作。

三、Webhook除錯

除錯webhook有時很複雜,因為webhook原則來說是非同步的。你首先要解發他,然後等待,接著檢查是否有響應。這是枯燥並且相當低效。幸運的是還有其他方法:

1、明白webhook能提供什麼,使用如RequestBin之類的工具收集webhook的請求;

2、用cURL或者Postman來模擬請求;

3、用ngrok這樣的工具測試你的程式碼;

4、用Runscope工具來檢視整個流程。

四、webhook安全

因為webhook傳送資料到應用上公開的URL,這就給其他人找到這個URL並且傳送錯誤資料的機會。你可採用技術手段,防止這樣的事情發生。最簡單的方法是採用https(TLS connection)。除了使用https外,還可以採用以下的方法進一步提高安全性:

1、首先增加Token,這個大多數webhook都支援;

2、增加認證;

3、資料簽名。

五、重要的問題

當作為webhook的消費者時有兩件事需要銘記於心:

1、webhook通過請求傳送資料到你的應用後,就不再關注這些資料。也就是說如果你的應用存在問題,資料會丟失。許多webhook會處理迴應,如果程式出現錯誤會重傳資料。如果你的應用處理這個請求並且依然返回一個錯誤,你的應用就會收到重複資料。

2、webhook會發出大量的請求,這樣會造成你的應用阻塞。確保你的應用能處理這些請求。

英文翻譯,原文地址:https://sendgrid.com/blog/webhook-vs-api-whats-difference/

SmartWebHook v0.2 釋出了。SmartWebHook是一個基於 Golang 開發的用於迅速搭建並使用 WebHook 進行自動化部署和運維繫統,支援:Github / GitLab / GitOsc / Gogs。介面和開發思路參考於 git-webhook ,在原作者的基礎上解耦了WebHook和Server之間關係,實現了多對多關係。因與伺服器通訊使用的是SSH方式,請注意保管伺服器賬號和密碼。同時支援 C/S 模式,配合客戶端可以實現不用SSH也可以遠端執行命令。

當使用 C/S 模式時,server 的賬號和密碼是伺服器端跟 Client 第一次通訊時的認證資訊,伺服器端將通過 http://remote url/token 地址換取連線 WebSocket 的金鑰,該金鑰會作為 x-smarthook-token 請求頭髮送到客戶端進行認證連線。

更新內容:

  • 修復 在Nginx代理 HTTS 模式下回撥地址生成錯誤的BUG #2

  • 修復 未登入是訪問個人中心錯誤的BUG

  • 新增 日誌頁面自動更新功能。

  • 新增 配置監聽指定IP的功能

  •  

介面預覽


快速搭建Hexo部落格+webhook自動部署+全站HTTPS | https://www.gaoshilei.com/2017/10/30/hexo-init/

GitHub - NetEaseGame/git-webhook: 使用 Python Flask + SQLAchemy + Celery + Redis + React 開發的用於迅速搭建並使用 WebHook 進行自動化部署和運維,支援 Github / GitLab / Gogs / GitOsc。 

https://github.com/NetEaseGame/git-webhook

Minho/go-git-webhook: Golang 實現的自動化部署和運維工具,支援:Github / GitLab / GitOsc。 https://gitee.com/longfei6671/go-git-webhook

相關文章