概覽
Apigee 的 proxy 環境是靠複製貼上長大的。一旦相同的驗證、日誌與錯誤處理政策存在於數百個各自維護的套件中,一項簡單的安全性變更就會變成需要數百個 pull request 的大工程。
挑戰
一項必要的權杖驗證變更必須逐一套用到每個 proxy,團隊卻無法確認是否已一致套用。各 proxy 的錯誤回應不盡相同,因此用戶端團隊必須依所呼叫的 API 以不同方式處理失敗。團隊既沒有 shared flow 策略,也沒有命名或版本控管慣例。
環境
Apigee X,proxy 由多個產品團隊各自負責,作為內部服務與對合作夥伴開放之 API 的前端,並須符合金融服務業的安全要求。
做法
AceMQ 將 proxy 套件當作原始碼分析,把近乎相同的政策區塊分群,以量化重複程度並找出自然的 shared flow 邊界。最終產出目標 shared flow 架構,以及一套可以漸進執行、無須凍結變更的重構順序。
解決方案
- 靜態分析所有 proxy 套件,將重複的政策邏輯分群並量化重複程度
- 定義涵蓋驗證、日誌、錯誤處理與 CORS 的 shared flow 架構
- 在整個環境中統一錯誤回應格式與故障處理方式
- 建立 proxy 命名、版本控管與部署慣例,並附上審查檢查清單
- 規劃漸進式重構順序,讓 proxy 無須凍結變更即可導入 shared flow
- 界定哪些政策決策應放在 shared flow 中,哪些理應保留在個別 proxy
成效
與安全性相關的政策變更,從逐一修改每個 proxy 的大規模作業,變成只需更新單一 shared flow;用戶端團隊也在整個 API 介面上獲得一致的錯誤語意。