Kongを使用してAPIの管理を効率化しよう

えがわ

2024.08.13

業務を効率化したい えがわ です。
みなさん！API、管理してますか？
最近のソフトウェア開発において、APIの重要性はますます高まっています。

特にマイクロサービスやクラウドネイティブアプリケーションの普及により、APIの数と複雑さは急速に増加しています。
APIの管理に辟易してきているあなた！ピッタリのサービスがあります！
 Kongとは？Kong社が提供するAPIマネジメントプラットフォームです。

APIゲートウェイの機能だけでなく、APIの管理に特化した機能を網羅的に備えています。
 高性能API ゲートウェイ低レイテンシーで高スループットなAPI処理
 プラグイン拡張性豊富な組み込みプラグイン（認証、セキュリティ、トラフィック制御など）
 セキュリティ機能OAuth 2.0、JWT、LDAP等の多様な認証方式をサポート
レート制限、IPレストリクションなどの保護機能
 トラフィック制御負荷分散
サーキットブレーカー
ヘルスチェック
 サービスディスカバリ動的なサービス登録と検出
複数のサービスディスカバリ方式をサポート
 管理ダッシュボードAPIとプラグインの設定管理
トラフィックの可視化と分析
 RESTful 管理 APIプログラマティックな設定と管理
自動化とCI/CDパイプラインとの統合が容易
 マルチプラットフォーム対応オンプレミス、クラウド、コンテナ環境での動作
Kubernetes との統合
 サービスメッシュ機能サイドカープロキシとしての機能
マイクロサービス間通信の最適化
 デベロッパーポータルAPIドキュメントの自動生成と公開
API利用のセルフサービス管理
 やってみる前にKongはコントロールプレーンとデータプレーンの2つの主要コンポーネントから構成されています。

コントロールプレーンのSaaSとしてKong Konnect、データプレーンのSaaSとしてCloud Gatewayを提供しています。
今回の実装では、Kong Konnectをコントロールプレーンとして使用し、連携するデータプレーンは自身で構築します。

これにより、KongのAPI管理機能を活用しつつ、クラウドとオンプレミスのハイブリッドな構成が可能です。
 やってみる今回はKongの根幹でもある、APIゲートウェイとプラグインを試していきます。

コントロールプレーンはKong Konnect、データプレーンはローカルにデプロイ、APIはオウム返しをしてくれるAPI(httpbin)を使用します。
 コントロールプレーンの設定Kong Konnectの画面からNew Control Planeを押下し、Kong Gatewayを選択します。
コントロールプレーンの名前を入力し、データプレーンの起動方法を選択します。

今回はSelf-Managed Hybrid Instancesを選択します。
 データプレーンを起動今回はローカル環境にデータプレンを起動します。
バージョンとプラットフォームを選択すると、起動用のスクリプトが作成可能になります。
Generate certificateを押下し、スクリプトを作成します。
表示されたスクリプトを実行することでデータプレーンを起動することができます。

起動するとData Plane Node has been foundとなります。
 サービスを作成サービスは、Kongがリクエストを転送する先のバックエンドシステム（例えば、APIやウェブアプリケーション）を指します。

Kongがどこにリクエストを送るかを教えるための設定です。
Gateway ServiceのNew Gateway Serviceからサービスを作成することができます。
Upstream URLにバックエンドシステムを指定します。

オウム返ししてくれるサービス「httpbin」を指定します。
 ルートを追加ルートは、特定のURLパターンやHTTPメソッドに基づいてリクエストを適切なサービスに振り分ける役割です。
作成するには名前とPathを設定します。
 接続確認ルートの追加が完了したので、確認してみます。
データプレーンにリクエストを実行してみます。
想定通りのレスポンスが返ってきました。
 プラグインについてプラグインは、リクエストやレスポンスの処理をカスタマイズするための追加機能です。

認証、ログ、レート制限、キャッシングなどの機能を簡単に追加できます。

プラグインは、特定のサービスやルート、あるいは全体に対して適用することができます。
現状はPC -> Kong -> httpbinとKongはプロキシサーバーの役割にしかなっていません。

Kongのプラグインを追加することで、付加機能を簡単に実装することができます。
 Rate Limitを追加今回はRate Limitを追加していきます。
ルート画面のプラグインタブでNew Pluginを押下します。
Rate Limitingを選択します。
今回はMinuteに3を入力し、同一のユーザーは1分間に3回のみ受け付けるようにしてみます。
プラグインを追加したので、動きを確認してみます。
4回リクエストを行うと、エラーになりました。
 他のプラグイン他にも多くのプラグインが用意されています。
https://docs.konghq.com/hub/
今回はRate Limitingを追加しましたが、Rate Limiting Advancedなど、より詳細に設定が可能なプラグインもあります。

※Enterpriseプランが必要なプラグインもあります。
 最後にKongはAPIの管理をシンプルかつ効率的に行うための強力なサービスです。

サービス、ルート、プラグインを理解することで、API管理の煩雑さを解消し、運用コストを大きく削減することができます。

この記事がどなたかの参考になれば幸いです。