本記事は「Kong Advent Calendar 2025」の20日目のエントリとして、Kong ManagerのUIをカスタマイズする方法について解説する。
Kong ManagerはKong Gatewayの管理UIだが、実は外観を少しだけカスタマイズすることが出来る。
具体的には、以下の3つがカスタマイズできる。
- ヘッダーバナー
- フッターバナー
- ログインバナー
今回はこれを設定するためのパラメータを試してみて、実際に見た目がどのように変わるかを見ていく。
ヘッダーバナーのカスタマイズ
ヘッダーバナーについては以下が設定できる。
-
admin_gui_header_txt：ヘッダーバナーに表示するテキスト -
admin_gui_header_bg_color：背景色（CSS カラー名、# 付き 16 進、RGB） -
admin_gui_header_txt_color：文字色（CSS カラー名、# 付き 16 進、RGB）
実査に使ってみる。以下を指定してKong Gatewayを起動する。
KONG_ADMIN_GUI_HEADER_TXT="ヘッダーバナーですよ"
KONG_ADMIN_GUI_HEADER_BG_COLOR="#FF0000"
KONG_ADMIN_GUI_HEADER_TXT_COLOR="#0000FF"
なお、バナーの背景色は赤、文字色は青を指定している。
結果がこちら。
ヘッダーバナーが追加された。
このバナーはどのページを見ても表示されるので、何かしらのお知らせに使えるかもしれない。
フッターバナーのカスタマイズ
フッターバナーについては以下が設定できる。
-
admin_gui_footer_txt：フッターバナーに表示するテキスト -
admin_gui_footer_bg_color：フッターバナーの背景色（CSSカラー名、# 付き 16 進、RGB） -
admin_gui_footer_txt_color：フッターバナーの文字色（CSSカラー名、# 付き 16 進、RGB）
こちらも実際に使ってみる。以下を指定してKong Gatewayを起動する。
KONG_ADMIN_GUI_FOOTER_TXT="フッターバナーですよ"
KONG_ADMIN_GUI_FOOTER_BG_COLOR="#00FF00"
KONG_ADMIN_GUI_FOOTER_TXT_COLOR="#FF00FF"
なお、バナーの背景色は緑、文字色は紫を指定している。
結果がこちら。
こちらも指定した色でフッターバナーが追加された。
これもどのページを見ても表示されるので、問い合わせ先とかを表示するのに使えるかもしれない。（ただしリンクは張れないので注意）
ログインバナーのカスタマイズ
最後にログインバナーをカスタマイズしてみる。
これはRBAC設定が有効な場合にのみ表示されるバナーで、以下の項目が設定できる。
-
admin_gui_login_banner_title：ログインバナーのタイトル -
admin_gui_login_banner_body：ログインバナーの本文
なお、標準だとこんな感じ。
動作確認する。以下を指定してKong Gatewayを起動する。
KONG_ADMIN_GUI_LOGIN_BANNER_TITLE="バナータイトルですよ"
KONG_ADMIN_GUI_LOGIN_BANNER_BODY="バナーの本文ですよ"
結果がこちら。
ログインバナーが指定した内容で追加されていることが分かる。
複数Kongのクラスタを配備している場合、本番環境かどうかを記載するといいかもしれない。
まとめ
今回は普段あまり使われていナさそうなKong Managerのカスタマイズ機能について確認した。
ヘッダーバナー、フッターバナー、ログインバナーの3つがカスタマイズでき、簡単に見た目を変えられることが分かった。
活用方法は色々考えられるが、特に本番・検証・開発環境を分けている場合に、どの環境を操作しているかを明示するのに役立つと思う。
一方で、設定はkong.confでしか設定できず、設定変更のたびにControl Planeを再起動する必要があるので、一時的なお知らせについては使いづらいかもしれない。
いい活用方法があったら共有してもらえると幸いです。