ホーム
製品
Red Hat JBoss Enterprise Application Platform
6.4
管理および設定ガイド
5.4.2. Remoting サブシステムの設定

5.4.2. Remoting サブシステムの設定

概要

JBoss Remoting には、ワーカースレッドプール、1 つ以上のコネクター、および一連のローカルおよびリモート接続 URI の 3 つのトップレベル設定可能な要素があります。このトピックでは、設定可能な各項目の説明、各項目の設定方法についての CLI コマンドの例、および完全に設定されたサブシステムの XML の例を紹介します。この設定はサーバーにのみ適用されます。独自のアプリケーションにカスタムコネクターを使用しない限り、ほとんどのユーザーは Remoting サブシステムをまったく設定する必要はありません。EJB などの Remoting クライアントとして動作するアプリケーションには、特定のコネクターに接続するための個別の設定が必要です。

注記

Remoting サブシステム設定は Web ベースの管理コンソールに公開されませんが、コマンドラインベースの管理 CLI から完全に設定可能です。手作業による XML の編集は推奨されません。

CLI コマンドの適合

CLI コマンドは、デフォルト のプロファイルの設定時に管理対象ドメインに対して式化されます。別のプロファイルを設定するには、その名前を置き換えます。スタンドアロンサーバーの場合は、コマンドの /profile=default 部分を省略します。

Remoting サブシステム外の設定

remoting サブシステム以外の設定側面がいくつかあります。

ネットワークインターフェース

remoting サブシステムによって使用されるネットワークインターフェースは、domain/configuration/domain.xml または standalone/configuration/standalone.xml で定義された パブリック インターフェースです。

<interfaces>
   <interface name="management"/>
   <interface name="public"/>
   <interface name="unsecure"/>
</interfaces>

<interfaces>
   <interface name="management"/>
   <interface name="public"/>
   <interface name="unsecure"/>
</interfaces>

Copy to Clipboard

Toggle word wrap

パブリック インターフェースのホストごとの定義は、domain.xml または standalone.xml と同じディレクトリーの host.xml で定義されます。このインターフェースは、他のサブシステムによっても使用されます。変更時には注意が必要です。

<interfaces>
   <interface name="management">
      <inet-address value="${jboss.bind.address.management:127.0.0.1}"/>
   </interface>
   <interface name="public">
      <inet-address value="${jboss.bind.address:127.0.0.1}"/>
   </interface>
   <interface name="unsecure">
      <!-- Used for IIOP sockets in the standard configuration.
         To secure JacORB you need to setup SSL -->
      <inet-address value="${jboss.bind.address.unsecure:127.0.0.1}"/>
   </interface>
</interfaces>

<interfaces>
   <interface name="management">
      <inet-address value="${jboss.bind.address.management:127.0.0.1}"/>
   </interface>
   <interface name="public">
      <inet-address value="${jboss.bind.address:127.0.0.1}"/>
   </interface>
   <interface name="unsecure">
      <!-- Used for IIOP sockets in the standard configuration.
         To secure JacORB you need to setup SSL -->
      <inet-address value="${jboss.bind.address.unsecure:127.0.0.1}"/>
   </interface>
</interfaces>

Copy to Clipboard

Toggle word wrap

socket-binding

remoting サブシステムによって使用されるデフォルトの socket-binding は TCP ポート 4447 にバインドされます。これを変更する必要がある場合は、ソケットバインディングおよびソケットバインディンググループのドキュメントを参照してください。

ソケットバインディンググループとソケットバインディンググループに関する情報は、JBoss EAP 『管理ガイドのソケットバインディンググループの章を参照し』てください。『』 https://access.redhat.com/documentation/ja-jp/red_hat_jboss_enterprise_application_platform/?version=6.4

EJB のリモーティングコネクターリファレンス

EJB サブシステムには、リモートメソッド呼び出しに対するリモーティングコネクターへの参照が含まれます。デフォルト設定は次のとおりです。

<remote connector-ref="remoting-connector" thread-pool-name="default"/>

<remote connector-ref="remoting-connector" thread-pool-name="default"/>

Copy to Clipboard

Toggle word wrap

セキュアなトランスポート設定

リモーティングトランスポートは、クライアントが要求した場合に StartTLS を使用してセキュアな（HTTPS、Secure Servlet など）接続を使用します。セキュアな接続とセキュアでない接続に同じソケットバインディング（ネットワークポート）が使用されるため、サーバー側の追加設定は必要ありません。クライアントは必要に応じてセキュアなトランスポートまたはセキュアでないトランスポートを要求します。EJB、ORB、JMS プロバイダーなどの Remoting を使用する JBoss EAP 6 コンポーネントは、デフォルトでセキュアなインターフェースを要求します。

警告： StartTLS セキュリティーに関する考慮事項

StartTLS は、クライアントが要求した場合にセキュアな接続をアクティベートし、セキュアでない接続にデフォルト設定することで機能します。これは、攻撃者がクライアントの要求をインターセプト してセキュアでない接続を要求するために Middle スタイルの不正使用における Man に悪影響を与えることが本質的に行われます。セキュアでない接続が実際に適切なフォールバックである場合を除き、クライアントがセキュアな接続を受信しない場合、適切に失敗するよう記述する必要があります。

ワーカースレッドプール

ワーカースレッドプールは、Remoting コネクターを介して提供される作業の処理に使用できるスレッドのグループです。これは単一の要素 &lt ;worker-thread-pool> で、複数の属性を取ります。ネットワークタイムアウトの取得、スレッドの不足、またはメモリー使用量の制限が必要な場合には、これらの属性をチューニングします。特定の推奨事項は、特定の状況によって異なります。詳細は Red Hat グローバルサポートサービスまでお問い合わせください。

Expand

表5.4 ワーカースレッドプールの属性
属性	説明	CLI コマンド
read-threads	リモーティングワーカーに対して作成する読み取りスレッドの数。デフォルトは`1`です。	`/profile=default/subsystem=remoting/:write-attribute(name=worker-read-threads,value=1)`
write-threads	リモーティングワーカーに作成する書き込みスレッドの数。デフォルトは`1`です。	`/profile=default/subsystem=remoting/:write-attribute(name=worker-write-threads,value=1)`
task-keepalive	コアでないリモーティングワーカーのタスクスレッドにキープアライブを使用する期間 (ミリ秒単位)。デフォルトは `60` です。	`/profile=default/subsystem=remoting/:write-attribute(name=worker-task-keepalive,value=60)`
task-max-threads	リモーティングワーカーのタスクスレッドプールに対するスレッドの最大数。デフォルトは `16` です。	`/profile=default/subsystem=remoting/:write-attribute(name=worker-task-max-threads,value=16)`
task-core-threads	リモーティングワーカーのタスクスレッドプールに対するコアスレッドの数。デフォルトは `4` です。	`/profile=default/subsystem=remoting/:write-attribute(name=worker-task-core-threads,value=4)`
task-limit	許可するリモーティングワーカータスクの最大数。この数を超えるリモーティングワーカータスクは拒否されます。デフォルトは `16384` です。	`/profile=default/subsystem=remoting/:write-attribute(name=worker-task-limit,value=16384)`

コネクター

コネクターは主な Remoting 設定要素です。複数のコネクターを設定できます。それぞれは複数のサブ要素を持つ & lt;connector > 要素といくつかの属性で構成されます。デフォルトのコネクターは、JBoss EAP 6 の複数のサブシステムによって使用されます。カスタムコネクターの要素や属性の設定はアプリケーションに依存するため、詳細は Red Hat グローバルサポートサービスにお問い合わせください。

Expand

表5.5 コネクターの属性
属性	説明	CLI コマンド
socket-binding	このコネクターに使用するソケットバインディングの名前。	`/profile=default/subsystem=remoting/connector=remoting-connector/:write-attribute(name=socket-binding,value=remoting)`
authentication-provider	このコネクターで使用するJASPIC(Java Authentication Service Provider Interface for Containers)モジュール。モジュールはクラスパスにある必要があります。	`/profile=default/subsystem=remoting/connector=remoting-connector/:write-attribute(name=authentication-provider,value=myProvider)`
security-realm	オプション。アプリケーションのユーザー、パスワード、およびロールが含まれるセキュリティーレルム。EJB または Web アプリケーションはセキュリティーレルムに対して認証できます。`ApplicationRealm` はデフォルトの JBoss EAP 6 インストールで利用できます。	`/profile=default/subsystem=remoting/connector=remoting-connector/:write-attribute(name=security-realm,value=ApplicationRealm)`

Expand

表5.6 コネクター要素
属性	説明	CLI コマンド
sasl	SASL(Simple Authentication and Security Layer)認証メカニズムの組み込み要素	`該当なし`
properties	1 つ以上の &lt `;property&gt`; 要素が含まれ、それぞれ `name` 属性と任意の `value` 属性が含まれます。	`/profile=default/subsystem=remoting/connector=remoting-connector/property=myProp/:add(value=myPropValue)`

送信接続

3 種類のアウトバウンド接続を指定することができます。

URI への送信接続。
ローカルアウトバウンド接続：ソケットなどのローカルリソースに接続します。
リモートアウトバウンド接続：リモートリソースに接続し、セキュリティーレルムを使用して認証します。

すべてのアウトバウンド接続は < outbound-connections> 要素に囲まれて います。これらの各接続タイプは outbound-socket-binding-ref 属性を取ります。outbound-connection は uri 属性を取ります。リモートアウトバウンド接続は、承認に使用する任意の username および security-realm 属性を取ります。

Expand

表5.7 送信接続要素
属性	説明	CLI コマンド
outbound-connection	汎用アウトバウンド接続。	`/profile=default/subsystem=remoting/outbound-connection=my-connection/:add(uri=http://my-connection)`
local-outbound-connection	暗黙的な local:// URI スキームを使用した送信接続。	`/profile=default/subsystem=remoting/local-outbound-connection=my-connection/:add(outbound-socket-binding-ref=remoting2)`
remote-outbound-connection	セキュリティーレルムで basic/digest 認証を使用した remote:// URI スキームの送信接続。	`/profile=default/subsystem=remoting/remote-outbound-connection=my-connection/:add(outbound-socket-binding-ref=remoting,username=myUser,security-realm=ApplicationRealm)`

SASL 要素

SASL 子要素を定義する前に、最初の SASL 要素を作成する必要があります。以下のコマンドを使用します。

/profile=default/subsystem=remoting/connector=remoting-connector/security=sasl:add

/profile=default/subsystem=remoting/connector=remoting-connector/security=sasl:add

Copy to Clipboard

Toggle word wrap

SASL 要素の子要素は以下の表で説明されています。

Expand

表5.8 SASL 子要素
属性	説明	CLI コマンド
include-mechanisms	SASL メカニズムのリストである `value` 属性が含まれます。	`/profile=default/subsystem=remoting/connector=remoting-connector/security=sasl:write-attribute(name=include-mechanisms,value=["DIGEST","PLAIN","GSSAPI"])` Copy to Clipboard Toggle word wrap
qop	優先順で SASL Quality of 保護値のリストである `value` 属性が含まれます。	`/profile=default/subsystem=remoting/connector=remoting-connector/security=sasl:write-attribute(name=qop,value=["auth"])` Copy to Clipboard Toggle word wrap
strength	`value` 属性が含まれます。これは SASL 暗号強度の値のリストで優先順で表されます。	`/profile=default/subsystem=remoting/connector=remoting-connector/security=sasl:write-attribute(name=strength,value=["medium"])` Copy to Clipboard Toggle word wrap
reuse-session	ブール値である `value` 属性が含まれます。true の場合、セッションを再利用しようとします。	`/profile=default/subsystem=remoting/connector=remoting-connector/security=sasl:write-attribute(name=reuse-session,value=false)` Copy to Clipboard Toggle word wrap
server-auth	ブール値である `value` 属性が含まれます。true の場合、サーバーはクライアントに対して認証します。	`/profile=default/subsystem=remoting/connector=remoting-connector/security=sasl:write-attribute(name=server-auth,value=false)` Copy to Clipboard Toggle word wrap
policy	ゼロ以上の要素が含まれるローカリング要素。それぞれが単一の `値` を取ります。 forward-secrecy: 前方機密性の実装にメカニズムが必要であるかどうか（1 つのセッションに分割しても、今後のセッションに侵入するための情報が自動的に提供されない）非アクティブ - 辞書攻撃を受けやすいメカニズムを許可するかどうか。`false` を指定すると許可され、`true` は拒否されます。 no-anonymous: 匿名ログインを受け入れるメカニズムを許可するかどうか。`false` を指定すると許可され、`true` は拒否されます。 no-dictionary: パッシブ辞書攻撃を受けやすいメカニズムを許可するかどうか。`false` を指定すると許可され、`true` は拒否されます。 no-plain-text: 単純なプレーンテキスト攻撃を受けやすいメカニズムを許可するかどうか。`false` を指定すると許可され、`true` は拒否されます。 pass-credentials: クライアントのクレデンシャルを渡すメカニズムを許可するかどうか。	`/profile=default/subsystem=remoting/connector=remoting-connector/security=sasl/sasl-policy=policy:add` Copy to Clipboard Toggle word wrap `/profile=default/subsystem=remoting/connector=remoting-connector/security=sasl/sasl-policy=policy:write-attribute(name=forward-secrecy,value=true)` Copy to Clipboard Toggle word wrap `/profile=default/subsystem=remoting/connector=remoting-connector/security=sasl/sasl-policy=policy:write-attribute(name=no-active,value=false)` Copy to Clipboard Toggle word wrap `/profile=default/subsystem=remoting/connector=remoting-connector/security=sasl/sasl-policy=policy:write-attribute(name=no-anonymous,value=false)` Copy to Clipboard Toggle word wrap `/profile=default/subsystem=remoting/connector=remoting-connector/security=sasl/sasl-policy=policy:write-attribute(name=no-dictionary,value=true)` Copy to Clipboard Toggle word wrap `/profile=default/subsystem=remoting/connector=remoting-connector/security=sasl/sasl-policy=policy:write-attribute(name=no-plain-text,value=false)` Copy to Clipboard Toggle word wrap `/profile=default/subsystem=remoting/connector=remoting-connector/security=sasl/sasl-policy=policy:write-attribute(name=pass-credentials,value=true)` Copy to Clipboard Toggle word wrap
properties	1 つ以上の &lt `;property&gt`; 要素が含まれ、それぞれ `name` 属性と任意の `value` 属性が含まれます。	`/profile=default/subsystem=remoting/connector=remoting-connector/security=sasl/property=myprop:add(value=1)` Copy to Clipboard Toggle word wrap `/profile=default/subsystem=remoting/connector=remoting-connector/security=sasl/property=myprop2:add(value=2)` Copy to Clipboard Toggle word wrap

例5.10 設定例

以下の例は、JBoss EAP 6 に同梱されるデフォルトの remoting サブシステムを示しています。

<subsystem xmlns="urn:jboss:domain:remoting:1.1">
    <connector name="remoting-connector" socket-binding="remoting" security-realm="ApplicationRealm"/>
</subsystem>

<subsystem xmlns="urn:jboss:domain:remoting:1.1">
    <connector name="remoting-connector" socket-binding="remoting" security-realm="ApplicationRealm"/>
</subsystem>

Copy to Clipboard

Toggle word wrap

この例には多くのハイフン的な値が含まれており、前述の要素と属性をコンテキストに配置するように提示されています。

<subsystem xmlns="urn:jboss:domain:remoting:1.1">
    <worker-thread-pool read-threads="1" task-keepalive="60" task-max-threads="16" task-core-thread="4" task-limit="16384" write-threads="1" />
    <connector name="remoting-connector" socket-binding="remoting" security-realm="ApplicationRealm">
        <sasl>
            <include-mechanisms value="GSSAPI PLAIN DIGEST-MD5" />
            <qop value="auth" />
            <strength value="medium" />
            <reuse-session value="false" />
            <server-auth value="false" />
            <policy>
                <forward-secrecy value="true" />
                <no-active value="false" />
                <no-anonymous value="false" />
                <no-dictionary value="true" />
                <no-plain-text value="false" />
                <pass-credentials value="true" />
            </policy>
            <properties>
                <property name="myprop1" value="1" />
                <property name="myprop2" value="2" />
            </properties>
        </sasl>
        <authentication-provider name="myprovider" />
        <properties>
            <property name="myprop3" value="propValue" />
        </properties>
    </connector>
    <outbound-connections>
        <outbound-connection name="my-outbound-connection" uri="http://myhost:7777/"/>
        <remote-outbound-connection name="my-remote-connection" outbound-socket-binding-ref="my-remote-socket" username="myUser" security-realm="ApplicationRealm"/>
        <local-outbound-connection name="myLocalConnection" outbound-socket-binding-ref="my-outbound-socket"/>
    </outbound-connections>
</subsystem>

<subsystem xmlns="urn:jboss:domain:remoting:1.1">
    <worker-thread-pool read-threads="1" task-keepalive="60" task-max-threads="16" task-core-thread="4" task-limit="16384" write-threads="1" />
    <connector name="remoting-connector" socket-binding="remoting" security-realm="ApplicationRealm">
        <sasl>
            <include-mechanisms value="GSSAPI PLAIN DIGEST-MD5" />
            <qop value="auth" />
            <strength value="medium" />
            <reuse-session value="false" />
            <server-auth value="false" />
            <policy>
                <forward-secrecy value="true" />
                <no-active value="false" />
                <no-anonymous value="false" />
                <no-dictionary value="true" />
                <no-plain-text value="false" />
                <pass-credentials value="true" />
            </policy>
            <properties>
                <property name="myprop1" value="1" />
                <property name="myprop2" value="2" />
            </properties>
        </sasl>
        <authentication-provider name="myprovider" />
        <properties>
            <property name="myprop3" value="propValue" />
        </properties>
    </connector>
    <outbound-connections>
        <outbound-connection name="my-outbound-connection" uri="http://myhost:7777/"/>
        <remote-outbound-connection name="my-remote-connection" outbound-socket-binding-ref="my-remote-socket" username="myUser" security-realm="ApplicationRealm"/>
        <local-outbound-connection name="myLocalConnection" outbound-socket-binding-ref="my-outbound-socket"/>
    </outbound-connections>
</subsystem>

Copy to Clipboard

Toggle word wrap

設定イントロスペクションが文書化されていない

JNDI およびマルチキャストの自動検出

バグの報告

5.4.2. Remoting サブシステムの設定

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links