APIゲートウェイ
API Gateway
APIゲートウェイとは?
- すべてのリクエストが通る「正門」
- 認証・ルーティング・制限を一か所で
- マイクロサービスの前段
APIゲートウェイを前段に置くと、クライアントが覚えるべきアドレスは1つにまとまります。モバイルアプリが注文・在庫・精算サービスのドメインをそれぞれ持っておく必要がなくなり、内部でサービスを分割したりサーバーを移したりしても、アプリを新たにデプロイしてストア審査を待つ手間がなくなります。変わるのは呼び出し回数ではなく、変更が外部へ漏れ出す範囲です。内部構造と外部に約束したインターフェースを分けておく仕組みとして理解するほうが正確です。
似て見えるものとの境界を引いておくと設計が楽になります。ロードバランサーは同じサービスの複数台にトラフィックを均等に振り分けることに集中し、サービスメッシュはサービス同士がやり取りする内部通信を扱い、ゲートウェイは外部から入ってくる南北(north-south)トラフィックを担います。設定値もかなり具体的です。提携先キーは毎分60回、内部管理ツールは毎分600回のように発行キーごとに上限を分け、レスポンスのタイムアウトは通常3〜10秒に設定し、もう1段挟むことで生じる遅延は数ミリ秒から数十ミリ秒程度です。クライアントの種類ごとにレスポンスの形を組み替える必要があるなら、それはゲートウェイではなくBFF(Backend For Frontend)の役割です。
現場で最も食い違いやすいのは、ゲートウェイに業務ロジックが積み上がっていくことです。割引計算や会員等級による分岐を「ここで一度に処理したほうが楽だ」と入れ始めると、どのチームがデプロイしても全サービスが止まる新たな単一障害点に変わります。冗長化を後回しにしたまま、ゲートウェイ1台が落ちて無傷のサービス10個が丸ごと使えなくなる事故も珍しくありません。認証を正門で済ませたから内部は無防備でもよいという考えも同じく危険です。内部網が破られた瞬間に全サービスが開いてしまうため、内部サービスにも最低限のトークン検証は残しておく必要があります。
マイクロサービス・アーキテクチャの普及とともに、複数サービスの前段に置く単一の入口パターンとして定着しました。
架空の事例で見てみましょう。役職員320名規模のオンライン食品流通A社は、自社アプリとウェブ、提携モール6か所がそれぞれ内部サービス11本を直接呼び出す構造でした。認証コードがクライアントごとに少しずつ違ったため、トークン有効期限のポリシーを1行変えるのに2週間かかり、提携モール1か所の在庫照会の殺到で注文サービスまで12分間止まったこともありました。
- プラットフォームチームのリーダーが3週間分の呼び出しログを抽出してみたところ、全リクエストの41%が在庫照会で、そのうち半分が提携モール1か所から来ていました。「そもそも食い止める場所がないのが問題だ」という発言が会議で出ました。
- マネージド型ゲートウェイを「正門」として立ち上げ、提携モールのAPIから移行しました。バックエンド担当の課長は、既存ドメインを3か月間開けたままトラフィックを10%→50%→100%と段階的に移す方式を選びました。
- トークン検証をゲートウェイ一か所に集約し、提携先キーごとの上限を毎分60回に設定しました。超過分は429で返しつつ、再試行の間隔をレスポンスヘッダーに入れて提携先の開発者に案内しました。
- 「等級別の割引計算もゲートウェイでやろう」という提案が出ましたが、CTOが業務ロジックは各サービスに置くという原則で却下しました。ゲートウェイは認証・ルーティング・制限・ロギングの4つだけを担うよう釘を刺しました。
- 可用性ゾーン2か所にゲートウェイを二重化し、5秒間隔のヘルスチェックと障害時の自動切り替えを組み込みました。インフラ担当者が1台を強制的に落とす訓練を四半期ごとに行うことにしました。
- 6か月後のトークン方針変更作業は2週間から半日に短縮され、提携モール発の障害は同期間に4件から0件になりました。平均応答遅延は9ms増えましたが、障害で取りこぼしていた注文がなくなり、現場も納得しました。
パク・スンテ
チョン・イリョン