[MQ 9.2.0 Jul 2020]

IFrame への IBM MQ Console の組み込み

HTML <iframe> 要素を使用して、1 つの Web ページをインライン・フレーム (IFrame) によって別のページに組み込むことができます。 セキュリティー上の理由から、デフォルトでは IBM® MQ Console を IFrame に組み込むことはできません。 ただし、mqweb サーバーの mqConsoleFrameAncestors 構成プロパティーを使用して IFrame を有効にできます。

本タスクについて

mqweb サーバーは、IFrame を使用して IBM MQ Console を埋め込むことができる Web ページのオリジンの許可リストを維持します。 オリジンは、URL スキーム、ドメイン、ポートの組み合わせです (例: https://example.com:1234)。

mqweb サーバーで mqConsoleFrameAncestors 構成プロパティーを使用して、リスト内の項目を指定できます。

デフォルトでは、 mqConsoleFrameAncestors はブランクです。これは、 IBM MQ Console を IFrame に組み込むことができないことを意味します。

手順

次のコマンドを入力して、 IBM MQ Console を IFrame に組み込むことができる Web ページのオリジンのリストを指定します。
setmqweb properties -k mqConsoleFrameAncestors -v allowedOrigins
ここで、 allowedOrigins はオリジンのコンマ区切りリストです。 各オリジンは以下の内容で構成されます。
  • ホスト名または IP アドレス
  • URL スキーム (オプション)
  • ポート番号 (オプション)
ホスト名の先頭をワイルドカード文字 (*) にしたり、ポート番号でワイルドカード文字 (*) を使用したりもできます。
オリジンの例:
https://example.com:1234
これにより、 https://example.com:1234 から提供されるすべての Web ページで IBM MQ Console を IFrame で埋め込むことができます。
https://*.example.com:*
これは、 example.com で終わるホスト名を持つ HTTPSページで、任意のポートを使用している場合、 IBM MQ Console をIFrameに埋め込むことを可能にします。

以下の例では、 https://site2.example.com:1234 または https://site2.example.com:1235から提供される Web ページから IFrame に IBM MQ Console を組み込むことができます。
setmqweb properties -k mqConsoleFrameAncestors -v 
https://site2.example.com:1234,https://site2.example.com:1235