4.2. AMQ 管理コンソールへのローカルおよびリモートアクセスの設定
このセクションの手順では、AMQ 管理コンソールへのローカルおよびリモートアクセスを設定する方法を説明します。
コンソールへのリモートアクセスには、以下の 2 つの形式を使用できます。
- ローカルブローカーのコンソールセッション内では、Connect タブを使用して別のリモートブローカーに接続します。
- リモートホストから、ローカルブローカーの外部からアクセスできる IP アドレスを使用して、ローカルブローカーのコンソールに接続します。
前提条件
-
少なくとも AMQ Broker 7.1.0 にアップグレードする必要があります。このアップグレードの一環として、
jolokia-access.xmlという名前のアクセス管理設定ファイルをブローカーインスタンスに追加します。アップグレードの詳細は、Upgrading a Broker instance from 7.0.x to 7.1.0 を参照してください。
手順
-
<broker_instance_dir>/etc/bootstrap.xmlファイルを開きます。 web要素内で、Web ポートはデフォルトでlocalhostにのみバインドされていることを確認します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow リモートホストからローカルブローカーのコンソールへの接続を有効にするには、Web ポートバインディングをネットワーク到達可能なインターフェイスに変更します。以下に例を示します。
<web bind="http://0.0.0.0:8161" path="web">
<web bind="http://0.0.0.0:8161" path="web">Copy to Clipboard Copied! Toggle word wrap Toggle overflow 上記の例では、
0.0.0.0を指定することで、Web ポートをローカルブローカーの すべて のインターフェイスにバインドします。-
bootstrap.xmlファイルを保存します。 -
<broker_instance_dir>/etc/jolokia-access.xmlファイルを開きます。 <cors>(Cross-Origin Resource Sharing) 要素内に、コンソールへのアクセスを許可する各 HTTP origin リクエストヘッダーにallow-originエントリーを追加します。以下に例を示します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 上記の設定では、以下の接続が許可されるように指定します。
ローカルホストからコンソールへの接続 (つまり、ローカルブローカーインスタンスのホストマシン)。
-
最初のアスタリスク (
*) ワイルドカード文字では、セキュアな接続にコンソールを設定したかどうかに基づいて、httpまたはhttpsスキームのいずれかを接続要求で指定できます。 - 2 つ目のアスタリスクワイルドカード文字を使用すると、ホストマシン上の任意のポートを接続に使用できます。
-
最初のアスタリスク (
-
ローカルブローカーの外部からアクセスできる IP アドレスを使用して、リモートホストからローカルブローカーのコンソールへの接続。この場合、ローカルブローカーの外部からアクセスできる IP アドレスは
192.168.0.49です。 -
別のリモートブローカーで開いたコンソールセッション内からローカルブローカーへの接続。この場合、リモートブローカーの IP アドレスは
192.168.0.51です。
-
jolokia-access.xmlファイルを保存します。 -
<broker_instance_dir>/etc/artemis.profileファイルを開きます。 コンソールの Connect タブを有効にするには、
Dhawtio.disableProxy引数の値をfalseに設定します。-Dhawtio.disableProxy=false
-Dhawtio.disableProxy=falseCopy to Clipboard Copied! Toggle word wrap Toggle overflow 重要コンソールがセキュアなネットワークに公開されている 場合のみ、コンソールからのリモート接続を有効にすることが推奨されます (つまり、
Dhawtio.disableProxy引数の値をfalseに設定)。Java システム引数の
JAVA_ARGSリストに、新しい引数Dhawtio.proxyWhitelistを追加します。コンマ区切りリストとして、ローカルブローカーから接続するリモートブローカーの IP アドレスを指定します (つまり、ローカルブローカーで実行しているコンソールセッション内の Connect タブを使用)。以下に例を示します。-Dhawtio.proxyWhitelist=192.168.0.51
-Dhawtio.proxyWhitelist=192.168.0.51Copy to Clipboard Copied! Toggle word wrap Toggle overflow 上記の設定に基づいて、ローカルブローカーのコンソールセッション内の Connect タブを使用して、IP アドレスが
192.168.0.51の別のリモートブローカーに接続できます。-
aretmis.profileファイルを保存します。
関連情報
- コンソールへのアクセス方法は、「AMQ 管理コンソールへのアクセス」 を参照してください。
詳細情報:
- クロスオリジンリソース共有は、W3C Recommendations を参照してください。
- Jolokia のセキュリティーについては、Jolokia Protocols を参照してください。
- コンソールへの接続のセキュリティー保護は、「AMQ 管理コンソールへのネットワークアクセスのセキュリティー保護」 を参照してください。