概要
Apigeeのプロキシ環境は、コピー&ペーストによって膨らんでいきます。同じ認証、ロギング、エラー処理のポリシーが、個別に保守される数百のバンドルに存在するようになると、たった1つのセキュリティ変更が、数百件のプルリクエストを伴うプロジェクトになってしまいます。
課題
トークン検証に必須の変更を、すべてのプロキシに1つずつ適用しなければならず、チームはそれが一貫して適用されたかどうかを確認できませんでした。エラーレスポンスはプロキシごとに異なっていたため、クライアント側のチームは、どのAPIを呼び出すかによって障害の扱い方を変えていました。Shared Flowの戦略はなく、命名やバージョニングの規約もありませんでした。
環境
複数のプロダクトチームがプロキシを所有するApigee X。金融サービスのセキュリティ要件のもとで、社内サービスとパートナー向けAPIの前段に配置されていました。
アプローチ
AceMQはプロキシバンドルをソースコードとして分析し、ほぼ同一のポリシーブロックをクラスタリングすることで、重複の規模を定量化し、Shared Flowとして切り出すべき自然な境界を特定しました。成果物は、目標とするShared Flowのアーキテクチャと、変更凍結なしで段階的に実行できるリファクタリングの手順です。
ソリューション
- すべてのプロキシバンドルを静的に分析し、重複しているポリシーのロジックをクラスタリングして重複の規模を定量化
- 認証、ロギング、エラー処理、CORSを対象とするShared Flowのアーキテクチャを定義
- 環境全体でエラーレスポンスの形式とフォールト処理を標準化
- プロキシの命名、バージョニング、デプロイの規約を、レビュー用のチェックリストとともに策定
- 変更凍結なしでプロキシがShared Flowを採用できるよう、段階的なリファクタリングの順序を設計
- どのポリシー判断をShared Flowに置き、どれを正当にプロキシごとに残すべきかを定義
結果
セキュリティに関わるポリシー変更は、プロキシごとに対応して回る作業から、Shared Flowを1か所更新するだけの作業になりました。また、クライアント側のチームは、API全体で一貫したエラーのセマンティクスを得られるようになりました。