コンテンツにスキップ
Kong Logo | Kong Docs Logo
  • ドキュメント
    • API仕様を確認する
      View all API Specs すべてのAPI仕様を表示 View all API Specs arrow image
    • ドキュメンテーション
      API Specs
      Kong Gateway
      軽量、高速、柔軟なクラウドネイティブAPIゲートウェイ
      Kong Konnect
      SaaSのエンドツーエンド接続のための単一プラットフォーム
      Kong AI Gateway
      GenAI インフラストラクチャ向けマルチ LLM AI Gateway
      Kong Mesh
      Kuma と Envoy をベースにしたエンタープライズサービスメッシュ
      decK
      Kongの構成を宣言型で管理する上で役立ちます
      Kong Ingress Controller
      Kubernetesクラスタ内で動作し、Kongをプロキシトラフィックに設定する
      Kong Gateway Operator
      YAMLマニフェストを使用してKubernetes上のKongデプロイメントを管理する
      Insomnia
      コラボレーティブAPI開発プラットフォーム
  • Plugin Hub
    • Plugin Hubを探索する
      View all plugins すべてのプラグインを表示 View all plugins arrow image
    • 機能性 すべて表示 View all arrow image
      すべてのプラグインを表示
      AI's icon
      AI
      マルチ LLM AI Gatewayプラグインを使用してAIトラフィックを管理、保護、制御する
      認証's icon
      認証
      認証レイヤーでサービスを保護する
      セキュリティ's icon
      セキュリティ
      追加のセキュリティレイヤーでサービスを保護する
      トラフィック制御's icon
      トラフィック制御
      インバウンドおよびアウトバウンドAPIトラフィックの管理、スロットル、制限
      サーバーレス's icon
      サーバーレス
      他のプラグインと組み合わせてサーバーレス関数を呼び出します
      分析と監視's icon
      分析と監視
      APIとマイクロサービストラフィックを視覚化、検査、監視
      変革's icon
      変革
      Kongでリクエストとレスポンスをその場で変換
      ログ記録's icon
      ログ記録
      インフラストラクチャに最適なトランスポートを使用して、リクエストと応答データをログに記録します
  • サポート
  • コミュニティ
  • Kongアカデミー
デモを見る 無料トライアルを開始
Kong Gateway
3.8.x
  • Home icon
  • Kong Gateway
  • Kong Plugins
  • Kong Pluginsについて
report-issue問題を報告する
  • Kong Gateway
  • Kong Konnect
  • Kong Mesh
  • Kong AI Gateway
  • Plugin Hub
  • decK
  • Kong Ingress Controller
  • Kong Gateway Operator
  • Insomnia
  • Kuma

  • ドキュメント投稿ガイドライン
  • 3.10.x (latest)
  • 3.9.x
  • 3.8.x
  • 3.7.x
  • 3.6.x
  • 3.5.x
  • 3.4.x (LTS)
  • 3.3.x
  • 2.8.x (LTS)
  • アーカイブ (2.6より前)
  • はじめに
    • Kong Gatewayの概要
    • サポート
      • バージョンサポートポリシー
      • サードパーティの依存関係
      • ブラウザサポート
      • 脆弱性パッチ適用プロセス
      • ソフトウェア部品表
    • 安定性
    • リリースノート
    • 破壊的な変更
      • Kong Gateway 3.8.x
      • Kong Gateway 3.7.x
      • Kong Gateway 3.6.x
      • Kong Gateway 3.5.x
      • Kong Gateway 3.4.x
      • Kong Gateway 3.3.x
      • Kong Gateway 3.2.x
      • Kong Gateway 3.1.x
      • Kong Gateway 3.0.x
      • Kong Gateway 2.8.x 以前
    • キーコンセプト
      • サービス
      • ルート
      • コンシューマ
      • アップストリーム
      • プラグイン
      • コンシューマグループ
    • How Kong Works
      • ルーティングトラフィック
      • ロードバランシング
      • ヘルスチェックとサーキットブレーカ
    • 用語集
  • Kong を始めよう
    • Kong をゲットする
    • サービスとルート
    • レート制限
    • プロキシキャッシュ
    • キー認証
    • ロードバランシング
  • コングをインストールする
    • 概要
    • Kubernetes
      • 概要
      • Kong Gatewayをインストール
      • Admin API
      • Kong Manager をインストールする
    • Docker
      • docker run を使用する
      • 独自の Docker イメージをビルドする
    • Linux
      • Amazon Linux
      • Debian
      • Red Hat
      • Ubuntu
    • インストール後
      • データストアを設定
      • エンタープライズライセンスを適用
      • Kong Managerを有効にする
  • Kong in production
    • 展開のトポロジーズ
      • 概要
      • ハイブリッドモード
        • 概要
        • ハイブリッドモードでKong Gatewayをデプロイする
      • DB-lessデプロイ
      • 繁体字版
    • Running Kong
      • non-rootユーザーとしてKongを実行しています
      • 管理者 API の保護
      • systemdの使用
    • アクセスコントロール
      • コングゲートウェイを安全に開始
      • プログラムによる管理者の作成
      • RBAC を有効にする
    • ライセンス
      • 概要
      • ライセンスをダウンロード
      • エンタープライズライセンスのデプロイ
      • ライセンスAPIの使用
      • ライセンス使用状況をモニターする
    • ネットワーク
      • デフォルトのポート
      • DNSに関する考察
      • ネットワークとファイアウォール
      • CP/DP Communication through a Forward Proxy
      • PostgreSQL TLS
        • PostgreSQL TLS の設定
        • PostgreSQL TLS のトラブルシューティング
    • Kongの設定ファイル
    • 環境変数
    • KongからウェブサイトとAPIを提供する
    • モニタリング
      • 概要
      • Prometheus
      • StatsD
      • Datadog
      • ヘルスチェックプローブ
      • AIメトリクスを公開してグラフ
    • トレース
      • 概要
      • カスタム・トレース・エクスポーターの作成
      • トレースAPIリファレンス
    • リソースサイズのガイドライン
    • セキュリティアップデートプロセス
    • ブルー・グリーンの展開
    • カナリアのデプロイ
    • クラスタリングリファレンス
    • パフォーマンス
      • パフォーマンステストのベンチマーク
      • パフォーマンスのベンチマークを作成
      • Brotli圧縮によるパフォーマンスの向上
    • ロギングとデバッグ
      • ログの参照
      • ダイナミックログレベルの更新
      • ゲートウェイログをカスタマイズ
      • デバッグリクエスト
      • AIゲートウェイ分析
    • gRPCサービスの設定
    • 式ルータを使用
    • アップグレードと移行
      • 香港ゲートウェイ3.x.xをアップグレードする
      • バックアップと復元
      • アップグレードの戦略
        • デュアルクラスターのアップグレード
        • インプレイスアップグレード
        • 青緑色のアップグレード
        • ローリングアップグレード
      • 2.8 LTSから3.4 LTSにアップグレード
      • OSSからエンタープライズへ移行
      • 移行ガイドライン Cassandra から PostgreSQL
      • 新しい DNS クライアントに移行
      • 破壊的な変更
  • Kong Gateway Enterprise
    • 概要
    • シークレット管理
      • 概要
      • はじめに
      • ローテーション
      • 高度な使い方
      • バックエンドの設定
        • 概要
        • 環境変数
        • AWS シークレットマネージャー
        • Azure Key Vault
        • Google Cloud Secret Manager
        • HashiCorp Vault
      • How-To
        • AWS シークレットマネージャでデータベースを保護する
      • 参照フォーマット
    • 動的なプラグインの順序
      • 概要
      • 動的なプラグインの順序を始めましょう
    • 監査ログ
    • キーリングとデータ暗号化
    • ワークスペース
    • コンシューマグループ
    • イベントフック
    • データ プレーンレジリエンスの設定
    • 制御機の停止管理について
    • FIPS 140-2
      • 概要
      • FIPS 準拠パッケージをインストール
      • FIPS 140-2 準拠プラグイン
    • AWS IAMでKong Gateway Amazon RDSデータベースを認証する
    • 署名された香港の画像の署名を確認します
    • 署名された香港画像のビルド証明書を確認する
  • Kong AI Gateway
    • 概要
    • AI ゲートウェイを始めよう
    • LLM プロバイダー統合ガイド
      • OpenAI
      • Cohere
      • Azure
      • Anthropic
      • ミストラル
      • Llama2
    • AIプラットフォーム統合ガイド
      • Gemini
      • Amazon Bedrock
    • AIゲートウェイ分析
    • AI指標を公開・グラフ
    • AI Gateway plugins
  • Kong Manager
    • 概要
    • Kong Managerを有効にする
    • Kong Manager を始めましょう
      • サービスとルート
      • レート制限
      • プロキシキャッシュ
      • コンシューマーとの認証
      • 負荷バランス
    • 認証と承認
      • 概要
      • スーパー管理者を作成
      • ワークスペースとチーム
      • パスワードとRBACトークンをリセット
      • ベーシック認証
      • LDAP
        • LDAP の設定
        • LDAP サービス ディレクトリ マッピング
      • OIDC
        • OIDCの設定
        • OIDC 認証済みグループマッピング
        • 以前の設定から移行
      • セッション
      • RBAC
        • 概要
        • RBACを有効にする
        • ロールと権限を追加
        • ユーザーを作成
        • 管理者を作成
    • ネットワーク設定
    • ワークスペース
    • 顧客グループを作成
    • メールを送信中
    • トラブルシューティング
  • カスタムプラグインを開発
    • 概要
    • はじめに
      • はじめに
      • プラグインプロジェクトの設定
      • プラグインテストを追加
      • プラグイン設定を追加
      • 外部サービスを消費する
      • プラグインをデプロイ
    • ファイル構造
    • カスタムロジックの実装
    • プラグインの設定
    • データストアへのアクセス
    • カスタムエンティティの保存
    • カスタムエンティティをキャッシュ中
    • 管理者 API の拡張
    • テストを書く
    • 設置と配布
    • プロキシ-ワズムフィルター
      • プロキシワズムフィルタを作成
      • プロキシ-ワズムフィルタの設定
    • プラグイン開発キット
      • 概要
      • kong.client
      • kong.client.tls
      • kong.cluster
      • kong.ctx
      • kong.ip
      • kong.jwe
      • kong.log
      • kong.nginx
      • kong.node
      • kong.plugin
      • kong.request
      • kong.response
      • kong.router
      • kong.service
      • kong.service.request
      • kong.service.response
      • kong.table
      • kong.telemetry.log
      • kong.tracing
      • kong.vault
      • kong.websocket.client
      • kong.websocket.upstream
    • 他の言語でのプラグイン
      • 移動
      • Javascript
      • Python
      • コンテナでのプラグインの実行
      • 外部プラグインのパフォーマンス
  • Kong Plugins
    • 概要
    • 認証リファレンス
    • 複数の認証プラグインを許可
    • プラグインのキュー
      • 概要
      • プラグインキューイングリファレンス
  • Admin API
    • 概要
    • 宣言設定
    • Enterprise API
      • 情報ルート
      • 健康ルート
      • タグ
      • デバッグルート
      • サービス
      • ルート
      • コンシューマ
      • プラグイン
      • 証明書
      • CA 証明書
      • SNI
      • アップストリーム
      • ターゲット
      • ヴォールト
      • キー
      • チェーンをフィルター
      • ライセンス
      • ワークスペース
      • RBAC
      • 管理者
      • コンシューマグループ
      • イベントフック
      • キーリングとデータ暗号化
      • 監査ログ
      • Status API
    • オープンソースAPI
  • 参照
    • kong.conf
    • Nginx ディレクティブの注入中
    • CLI
    • キー管理
    • 表現の言語
      • 概要
      • 言語リファレンス
      • パフォーマンスの最適化
    • ライブラリのレート制限
    • WebAssembly
    • FAQ
enterprise-switcher-icon 次に切り替える: OSS
On this pageOn this page
  • プラグインとは何か
  • スコーププラグイン
    • グローバルスコープ
    • 優先順位
  • デプロイメントタイプとのプラグインの互換性
  • カスタムプラグイン
    • カスタムプラグインの開発
    • サードパーティのプラグイン
  • 関連項目
旧バージョンのドキュメントを参照しています。 最新のドキュメントはこちらをご参照ください。

Kong Pluginsについて

プラグインとは何か

Kong Gatewayは、一般的に プラグイン と呼ばれるモジュールを読み込んで実行するために設計されたLuaアプリケーションです。プラグインは高度な機能を提供し、Kong Gatewayの使用を拡張するため、実装により多くの機能を追加できるようになります。

Kong は、Kong GatewayとKonnectにバンドルされる一連の標準Luaプラグインを提供します。アクセスできるプラグインのセットは、ライセンスティアによって異なります。

カスタムプラグインを開発して、Kong Gatewayに独自のカスタム機能を追加することもできます。

スコーププラグイン

環境のニーズに応じて、さまざまな文脈においてプラグインを実行できます。各プラグインはグローバルに実行することも、以下の組み合わせに拡大することもできます。

  • サービス
  • ルート
  • コンシューマ
  • コンシューマグループ

スコープを使用すると、リクエストがバックエンドサービスに送信される前、あるいは応答を受信した後など、Kongが環境内で関数を処理する方法をカスタマイズできます。たとえば、プラグインを1つのルートに適用した場合、そのプラグインは、リクエストがシステムを通過する特定のパスでのみトリガーされます。 一方、プラグインをグローバルに適用すると、他の構成に関係なく、すべてのリクエストで実行されます。

グローバルスコープ

サービス、ルート、コンシューマ、またはコンシューマグループに関連付けられていないグローバルプラグインはグローバルと見なされ、他の構成に関係なく、すべてのリクエストで実行されます。

  • 自己管理型のKong Gateway Enterpriseでは、プラグインは特定のワークスペース内のすべてのエンティティに適用されます。
  • 自己管理型 Kong Gateway (OSS) では、プラグインは環境全体に適用されます。
  • Konnectでは、プラグインは特定のコントロールプレーン(CP)内のすべてのエンティティに適用されます。

すべてのプラグインはこれらのスコープのサブセットをサポートします。

各プラグインでサポートされているすべてのスコープについては、スコープ互換性リファレンスを参照してください。

優先順位

1つのプラグインインスタンスは1つのリクエストにつき、常に 1回 実行されます。実行される際の構成は、プラグインが構成されているエンティティによって異なります。プラグインは、さまざまなエンティティ、エンティティの組み合わせ、またはグローバルにも構成できます。これは、たとえばほとんどのリクエストに対しては特定の方法でプラグインを設定したいけれど、 認証されたリクエスト に対しては多少異なる動作にしたい場合に役立ちます。

したがって、構成が異なるさまざまなエンティティに適用された場合、プラグインを実行する優先順位が存在します。特定のプラグインに構成されているエンティティの数は、そのプラグインの優先度に直接相関します。プラグインが構成されているエンティティの数が多いほど、優先順位が高くなります。

複数のエンティティに設定されたプラグインの完全な優先順位は次のとおりです。

  1. コンシューマ + ルート + サービス :最も優先度が高く、特定のルートとサービス上の特定のコンシューマからの認証されたリクエストに影響します。
  2. コンシューマグループ + サービス + ルート : 特定のサービスおよびルートにわたる認証ユーザーのグループに影響します。
  3. コンシューマ + ルート : 特定のルート上の特定のコンシューマからの認証されたリクエストをターゲットにします。
  4. コンシューマ + サービス : 指定されたサービス内の任意のルートにアクセスする特定のコンシューマから認証されたリクエストに適用されます。
  5. コンシューマグループ + ルート : 特定のルート上の認証されたユーザーのグループに影響します。
  6. コンシューマグループ + サービス :認証済みユーザーグループ向けの特定サービス内のすべてのルートに適用されます。
  7. ルート + サービス : 特定のルートとサービスを利用するすべてのコンシューマを対象とします。
  8. コンシューマ : すべてのルートとサービスにわたる、認証された特定のコンシューマからのすべてのリクエストに適用されます。
  9. コンシューマグループ : 認証されたユーザーの指定されたグループのすべてのルートとサービスに影響します。
  10. ルート :指定されたルート専用。
  11. サービス :特定のサービス
  12. グローバルに設定されたプラグイン : 優先順位が最も低く、コンシューマのステータスに関わらず、すべてのサービスとルートに渡りすべてのリクエストに適用されます。

コンシューマグループの優先順位に関する注意 : コンシューマが2つのコンシューマグループのメンバーであり、それぞれにスコープ設定されたプラグインがある場合、Kong Gateway はこれらのプラグインの 1 つのみを実行することで、動作を決定します。ただし、この動作を制御する特定のルールは定義されておらず、将来のリリースで変更される可能性があります。

デプロイメントタイプとのプラグインの互換性

Kong Gateway はさまざまな方法でデプロイでき、すべてのプラグインが各モードと完全に互換性があるわけではありません。比較については、プラグインの互換性を参照してください。

カスタムプラグイン

カスタムプラグインの開発

Kongは、プラグイン開発キット(PDK)、データベースの抽象化、移行など、プラグインを開発するための開発環境全体を提供します。

プラグインは、PDKを介してリクエストオブジェクト/レスポンスオブジェクトまたはストリームと対話するモジュールで構成され、任意のロジックを実装します。Kongは、次の言語でPDKを提供しています。

  • Lua
  • Go
  • Python
  • JavaScript

これらのPDKは、プラグインとKongのコア(または他のコンポーネント)との間の相互作用を容易にするためにプラグインが使用できる関数のセットです。

独自のプラグインの作成を開始するには、入門ガイドのドキュメントを確認してください。 または次の参考文献を参照してください。

  • プラグイン開発キットのリファレンス
  • その他の言語サポート

サードパーティのプラグイン

サードパーティとのパートナーシップを通して、Kong は Kong Plugin Hub にサードパーティのカスタムプラグインをいくつかリストしています。 これらのプラグインは Kong パートナーによって管理されています。 自作のプラグインを Kong Plugin Hub で紹介したい場合は、Kong のパートナーになることをお勧めします。

関連項目

  • Kong Plugin Hub:すべてのKongバンドルプラグインとパートナープラグイン

参考資料

  • 各プラグインでサポートされているスコープ
  • 各プラグインでサポートされているトポロジ
  • 各プラグインでサポートされているプロトコル

プラグインのライセンスおよび価格のティア

  • 自己管理型Kong Gatewayライセンスティア
  • Konnectの価格帯
Thank you for your feedback.
Was this page useful?
情報が多すぎる場合 close cta icon
Kong Konnectを使用すると、より多くの機能とより少ないインフラストラクチャを実現できます。月額1Mリクエストが無料。
無料でお試しください
  • Kong
    APIの世界を動かす

    APIマネジメント、サービスメッシュ、イングレスコントローラーの統合プラットフォームにより、開発者の生産性、セキュリティ、パフォーマンスを大幅に向上します。

    • 製品
      • Kong Konnect
      • Kong Gateway Enterprise
      • Kong Gateway
      • Kong Mesh
      • Kong Ingress Controller
      • Kong Insomnia
      • 製品アップデート
      • 始める
    • ドキュメンテーション
      • Kong Konnectドキュメント
      • Kong Gatewayドキュメント
      • Kong Meshドキュメント
      • Kong Insomniaドキュメント
      • Kong Konnect Plugin Hub
    • オープンソース
      • Kong Gateway
      • Kuma
      • Insomnia
      • Kongコミュニティ
    • 会社概要
      • Kongについて
      • お客様
      • キャリア
      • プレス
      • イベント
      • お問い合わせ
  • 利用規約• プライバシー• 信頼とコンプライアンス
© Kong Inc. 2025