変更する HTTPInput、 HTTPReply、 SOAPInput、 SOAPReply、および SOAPAsyncResponse ノードに関連付けられているリソースとプロパティーを選択します。
これらのプロパティーを変更するには、統合ノード名、および -e と単一の統合サーバーの名前、さらに -o と統合サーバー・オブジェクトを指定する必要があります。 指定する場合-o統合サーバー名省略できます-e指定された統合ノード上のすべての統合サーバーに適用されるプロパティーを変更します。
これらのプロパティーはすべて統合サーバー・レベルで定義するため、指定した統合サーバーにデプロイするすべての HTTPInput、 HTTPReply、 SOAPInput、 SOAPReply、および SOAPAsyncResponse ノードに適用されます。
デフォルトで、統合ノードにデプロイする HTTP ノードはすべての単一の統合ノードのリスナーを使用します。 必要であれば、すべての統合サーバーが統合サーバー内の組み込みリスナーを使用するように統合ノードの構成を変更できます。 一部の統合サーバーに対しては統合ノードのリスナーを使用し、他の統合サーバーに対しては組み込みリスナーを使用することもできます。 これらのオプションの詳細については 、 HTTP のリスナー をご覧ください。
デフォルトでは、統合サーバーにデプロイするすべての SOAP ノードは、組み込みリスナーを使用します。 統合ノードのリスナーを使用するように、一部またはすべての統合サーバーの構成を変更することができます。 これらのオプションの詳細については 、 HTTP のリスナー をご覧ください。
統合ノード・リスナーを使用する場合は、統合ノードのデフォルト・キュー・マネージャーを指定する必要があります。 詳細については、 「 IBM App Connect Enterprise 」と「 IBM MQ 」の連携を参照してください。
統合ノードリスナーを使用するための HTTP またはSOAPノード の設定に関する詳細は 、「統合ノード HTTP リスナーパラメータ」 を参照してください。
すべての変更が実装されるためには、統合サーバーを再始動する必要があります。
ObjectName を、以下のオプションの中から選択します。
- 共通プロパティーを制御する場合は、ExecutionGroup。
- インバウンド HTTP 通信を制御する場合は HTTPConnector。 このコネクターは、インバウンド (サーバー・サイド) HTTP 通信にのみ使用します。 これらのプロパティーは、要求ノードを含むアウトバウンド・トラフィックには適用されません。
- インバウンド HTTPS 通信を制御する場合は HTTPSConnector。 このコネクターは、インバウンド (サーバー・サイド) HTTPS 通信にのみ使用します。 これらのプロパティーは、要求ノードを含むアウトバウンド・トラフィックには適用されません。
-o ExecutionGroup
以下のプロパティーおよび値が有効です。
- -n httpNodesUseEmbeddedListener
- このリスナーが有効になっている場合、すべての HTTPInput および HTTPReplyノードに統合ノード HTTP リスナーを使用させるには、値を falseに設定します。 指定された統合サーバーにデプロイされたすべての HTTPInput および HTTPReply ノードが組み込み統合サーバー・リスナーを使用するようにするには、値を true に設定します。
統合ノードの HTTP リスナーを無効にした場合、このプロパティの値に関わらず、すべての HTTPInputノードと HTTPReplyノードは組み込みのリスナーを使用します。
- -n soapNodesUseEmbeddedListener
- すべての SOAPInput、 SOAPReply、および SOAPAsyncResponse ノードが組み込み HTTP リスナーを使用するようにするには、値を true に設定します。 値を false に設定すると、すべての SOAPInput が SOAPReply となり、 SOAPAsyncResponse 指定の統合サーバーにデプロイされたノードが、統合ノードリスナーを使用するようにします。このリスナーが有効になっている場合。
統合ノードの HTTP リスナーを無効にした場合、すべての SOAPInput 、SOAPReply、 SOAPAsyncResponse ノードは、このプロパティの値に関係なく、組み込みのリスナーを使用します。
-o HTTPConnector
HTTPConnector および HTTPSConnector に有効なプロパティーと値は以下のとおりです。
- -n AutoRespondToHTTPHEADRequests
- コネクターが返されるようにするには、値を true に設定します。HTTP 200 OK応答 (要求が、メッセージ・フローに関連付けられた URI に対するものである場合)。 メッセージ・フローに関連付けられた URI に関する要求の場合にメッセージ・フローを呼び出すようにするには、この値を false に設定します。 要求がメッセージ・フローに関連付けられた URI に対するものでない場合、コネクターは以下を返します。HTTP 404 Not
Found応答。
- -n ConnBacklog
- この値として、キューに入れることができる着信接続要求の最大数を設定します。 この制限に達すると、受信される要求は拒否されます。
- -n ConnTimeout
- このプロパティを使用して、 HTTP 接続がサーバー側で切断されるまでに無効状態になってよい時間を秒単位で設定します。
- -n ContentSecurityPolicy
- このプロパティを使用して、 HTTP Content-Security-Policy レスポンスヘッダーに挿入する文字列を設定します。 詳しくは、 Content-Security-Policyを参照してください。
- -n CORSAllowCredentials
- Web ブラウザーがインバウンド・クロスオリジン要求で資格情報 (HTTP Cookie および HTTP 認証) を渡すことを許可する場合は、値を true に設定します。
true に設定すると、値 trueが設定された Access-Control-Allow-Credentials ヘッダーが応答に追加されます。
Web ブラウザーがインバウンド・クロスオリジン要求で資格情報を渡さないようにするには、値を false に設定します。
- -n CORSAllowHeaders
- このプロパティーを使用して、Web ブラウザーが、このコネクターによってホストされている HTTP サービスに渡すことが許可される HTTP ヘッダーを制御できます。 この値は、プリフライト・クロスオリジン要求を受け取った場合のみ使用されます。
プリフライト・クロスオリジン要求には、実際の要求に使用される HTTP ヘッダーのリストを Access-Control-Request-Headers ヘッダーの値として含めることができます。
プリフライト・クロスオリジン要求を許可するには、そのヘッダーのすべての値が、このプロパティーにリストされている値のいずれかと大/小文字を区別しないで一致する必要があります。 このプロパティーを、許可される HTTP ヘッダーのコンマ区切りリストに設定します。
- 値タイプ - ストリング
- 初期値 - Accept,Accept-Language,Content-Language,Content-Type
- -n CORSAllowMethods
- このプロパティーを使用して、このコネクターにホストされている HTTP サービスにアクセスしているときに Web ブラウザーが使用を許可される HTTP メソッドを制御します。 この値は、プリフライト・クロスオリジン要求を受け取った場合のみ使用されます。
プリフライト・クロスオリジン要求には、実際の要求の HTTP メソッドが Access-Control-Request-Method ヘッダーの値として含まれています。 プリフライト・クロスオリジン要求を許可するには、そのヘッダーの値が、このプロパティーにリストされている値のいずれかと大/小文字の区別も含めて一致する必要があります。
このプロパティーを、許可される HTTP メソッドのコンマ区切りリストに設定します。
- 値タイプ - ストリング
- 初期値 - GET,HEAD,POST,PUT,PATCH,DELETE,OPTIONS
- -n CORSAllowOrigins
- このプロパティーを使用して、インバウンド・クロスオリジン要求の許可された発信元のリストを構成します。 発信元は、クロスオリジン要求の開始元の URI のスキーマ、ホスト、および ポートです。 例えば、クロスオリジン要求が、
http://example.com:7800/api/customers でホストされている Web ページから開始された場合、そのクロスオリジン要求の発信元は http://example.com:7800 です。Web ブラウザーが行うクロスオリジン要求には、発信元ヘッダーの値として自動的に発信元が含まれます。
すべてのクロスオリジン要求を許可するには、この値をアスタリスク (*) に設定します。それ以外の場合は、値を、クロスオリジン・アクセスで許可される発信元のコンマ区切りのリストに設定します。 例: http://www.example.com,https://www.example.com:7843,http://othersite.net:7800
- -n CORSEnabled
- この値を true に設定すると、コネクタは Web ブラウザからの有効な HTTP Cross-Origin Resource Sharing ( CORS ) リクエストに応答するようになります。
すべての CORS 処理を無効にするには、この値を false に設定してください。
- -n CORSExposeHeaders
- このプロパティーを使用して、Web ブラウザー内で実行している Web ページが、クロスオリジン要求への応答で返される指定されたヘッダーの値を確認することを許可します。 ヘッダー Cache-Control、Content-Language、Content-Type、Expires、Last-Modified、および Pragma は、この値の設定にかかわらず、常に許可されます。
Web ブラウザーで実行している Web ページが応答内のその他のヘッダーを確認することを許可するには、値をヘッダー名のコンマ区切りのリストとして設定します。 例えば、X-Header1,X-Header2,X-Header3などです
この値が空でないリストとして設定されている場合に、インバウンド・クロスオリジン要求が許可されていると、このプロパティーの値が設定された Access-Control-Expose-Headers ヘッダーが応答に追加されます。
この値が空のリストに設定されている場合、Access-Control-Expose-Headers ヘッダーは応答に追加されません。
- 値タイプ - ストリング
- 初期値 - Content-Type
- -n CORSMaxAge
- このプロパティーを使用して、Web ブラウザーがプリフライト・クロスオリジン要求への応答をキャッシュに入れることを許可します。 この値が 0 または正整数に設定され、インバウンド・クロスオリジン要求が許可されている場合、このプロパティーの値を持つ Access-Control-Max-Age ヘッダーが応答に追加されます。
この値は、Web ブラウザーがプリフライト・クロスオリジン要求への応答をキャッシュに入れることができる最大時間を秒単位で指定します。 0 の値は、Web ブラウザーがプリフライト・クロスオリジン要求への応答をキャッシュに入れないようにします。
この値を -1 に設定すると、Access-Control-Max-Age ヘッダーは応答に追加されません。 ヘッダーが存在しない場合、Web ブラウザーによっては、プリフライト・クロスオリジン要求への応答をキャッシュに入れることがあります。
- -n DuplicateHeaderAction
- このプロパティを使用して、複数の HTTP ヘッダーフィールドが同じ名前で検出された際に実行するアクションを指定します。 以下の値のうちいずれか 1 つを指定できます。
- combineHeaders
- RFC 2616 4.2 および RFC 7230 3.2.2で定義されているように、それぞれのフィールド値を単一のコンマ区切りリストに結合します。
- useFirstHeader
- 最初に検出されたヘッダーのみを使用し、同じフィールド名を持つ後続のヘッダーはすべて無視します。
- useLastHeader
- 検出された最後のヘッダーのみを使用し、同じフィールド名を持つ先行ヘッダーはすべて無視します。
- errorOnDuplicate
- 同じ名前の HTTP ヘッダーフィールドが複数ある場合は、エラーで処理を終了する。
- 値タイプ - ストリング
- 初期値- combineHeaders
- -n EnableLookups
- DNSルックアップを使用して（完全修飾ドメイン名などの）情報を返すようにするには、値をtrueに設定し、 HTTP ヘッダー（
X-Remote-Host など）に含めます。 IP アドレスを返すには、false に設定します。
- -n HealthCheckRespondToGET
- このプロパティーを使用して、組み込みリスナーが GET/要求に応答する方法を指定します。 このプロパティーが
trueに設定されている場合、組み込みリスナーは GET/要求に対して、統合サーバーが初期化を終了した場合は状況コード 200 OK で応答し、統合サーバーが初期化を完了していない場合は HealthCheckServerStartingCode プロパティーで指定された状況コードで応答します。 統合ノード・リスナーは、統合サーバーの状況に関係なく、 200 OK で応答します。 このプロパティーが falseに設定されている場合、両方のリスナーがそのような要求に対して 404
Not Foundで応答します。
- -n HealthCheckServerStartingCode
- このプロパティーを使用して、組み込みリスナーの統合サーバーが始動処理中であり、 HealthCheckRespondToGET プロパティーを
trueに設定して構成されている場合に、組み込みリスナーが GET/要求に応答して返す状況コードを指定します。 このプロパティーは、統合ノード・リスナーによって無視されます。
- -n IntegratedWindowsAuthentication
- 統合 Windows 認証 (IWA) を使用して、Windows で統合ノードに対してインバウンド要求を保護するようにするには、このプロパティーを設定します。 セミコロンまたはスペースで区切られた以下の値を 1 つ以上指定することができます。
- NTLM
- この値を指定すると、NTLM プロトコルを使用します。
- Negotiate
- この値を指定すると、Negotiate (SPNEGO) プロセスを使用します。 このプロセスにより、 IBM App Connect Enterprise はNTLMプロトコルまたは Kerberos プロトコルの使用についてネゴシエーションを行うことができます。 Kerberos が使用可能であれば、それが優先プロトコルです。
- Negotiate:Kerberos
- この値を指定すると、Negotiate (SPNEGO) プロセスを使用して、Kerberos プロトコルの使用のみをネゴシエーションします。 クライアントが Kerberos プロトコルに対応していない場合、 IBM App Connect Enterprise は接続を拒否します。
値を指定した順序が、HTTP 応答でクライアントに値が戻される順序になります。 IWA を使用不可にするには、このプロパティーをブランク・ストリングに設定します。
HTTP、REST、またはSOAP入力ノードで、 Kerberos 対応プロトコルを使用するように構成されている場合、インバウンドの統合Windows認証（IWA）を使用する際には、ACEユーザーのドメインコントローラー上に Kerberos サービスプリンシパル名を作成する必要があります。
- -n iwagshostnameオーバーライド
- SOAPまたは HTTP 入力ノードからGSS制御の Kerberos 認証で使用されるローカルホスト名を設定します。
このプロパティは 、MQSI_GSS_HOSTNAME_OVERRIDE環境変数を更新することで設定することもできます。この設定よりも優先されます。
このプロパティは Unix システムでのみ適用され、Windowsシステムでは適用されません。
- -n IWATimeout
- IWA セッション・タイムアウトを秒単位で設定します。 値が設定されない場合、デフォルトは 300 です。
- -n ListenerAddress
- 複数の IP アドレスがあるサーバーの場合、この値は、ポート 7080 でのリスニングに使用する IP アドレスに設定します。 このプロパティーが設定されていない場合、サーバーに関連付けられているすべての IP アドレスでポート 7080 が使用されます。 指定できるアドレスは最大 1 つまでです。
- -n ListenerPort
- この値として、コネクターがサーバー・ソケットを作成し、着信接続を待機する TCP/IP ポート番号を設定します。
この値を設定すると、コネクターの自動ポート検出機能は切断されます。このポートは許可される唯一のポートであり、別のプログラムがこのポートを既に使用している場合は、コネクターは開始できません。
- 値タイプ - 整数
- 初期値 - 7800
- 他の有効な値 - 0 から 65536 の範囲内の任意の整数
- -n ListenerThreads
- このプロパティーは、リスナーを実行するために使用可能なスレッドの数を指定します。 このプロパティーが
-1 または 0 に設定されている場合、使用可能なスレッドの数は、システム上の使用可能な CPU コア数の半分になります。
- -n MaxConnections
- この値として、リスナーが受け入れるインバウンド HTTP 接続の最大数を設定します。 デフォルトは、-1 (制限なし) です。 MaxConnections 制限に達し、新しい接続試行が行われると、リスナーは接続を拒否します。
- -n MaxheaderSize
- HTTP がサポートするヘッダーの最大サイズ。 デフォルトは 8192です。 必要に応じて値を増やすことができます。 制限はありません。
- -n MaxKeepAliveRequests
- この値として、持続接続を使用できる要求の最大数を設定します。 キープアライブ要求を無効にし、要求ごとに接続の新規作成を強制的に実行するには、この値を 1 に設定します。
- -n MaxPostSize
- この値として、統合ノードのリスナーにより処理可能な POST の最大サイズ (バイト単位) を設定します。 この制限を超える要求は、HTTP 413 Payload Too Large 応答で拒否されます。
- -n QueueCapacity
- HTTP リスナーからメッセージ・フローに要求を転送するメモリー内キューによって保管できる要求の最大数を設定します。
QueueCapacity プロパティーと QueueWait プロパティーは連動して、インバウンド・キューを調整します。 インバウンド・キューが ( QueueCapacity プロパティーで指定された要求の最大数に達することによって) 満杯になると、リスナーは QueueWait プロパティーで指定された最大間隔まで待機し、キューで使用できるようになります。 (メッセージ・フローがキューから要求を受け取った結果として、) スペースが使用可能になると、リスナーは次のインバウンド要求をキューに追加します。 待機間隔が経過するまでキューがいっぱいのままの場合、クライアントに HTTP 503 Service Unavailable メッセージが返されます。
デフォルト値は 1000 です。
- -n QueueWait
- HTTP 503 Service Unavailable （ミリ秒単位）で、受信したリクエストを拒否するまでにリスナーが待機する最大間隔を設定します。
QueueWait プロパティーと QueueCapacity プロパティーは連動して、インバウンド・キューを調整します。 インバウンド・キューが ( QueueCapacity プロパティーで指定された要求の最大数に達することによって) 満杯になると、リスナーは QueueWait プロパティーで指定された最大間隔まで待機し、キューで使用できるようになります。 (メッセージ・フローがキューから要求を受け取った結果として、) スペースが使用可能になると、リスナーは次のインバウンド要求をキューに追加します。 待機間隔が経過するまでキューがいっぱいのままの場合、クライアントに HTTP 503 Service Unavailable メッセージが返されます。
- 値タイプ - 整数
- 初期値 - 5000 (ミリ秒)
- -n ServerName
- このサーバーから送信されるすべての HTTP 応答の「Server」ヘッダーに設定する値を設定します。
- -n TimeoutSweepInterval
- タイムアウト・メッセージの検査間隔 (ミリ秒単位) を設定します。 デフォルトの時間間隔は 20 ミリ秒です。
- -n XContentTypeOptions
- X-Content-Type- Options 応答ヘッダーを含めることで、MIME タイプ・スニッフィングをオプトアウトするには、nosniff に設定します。 詳細は、 X-Content-Type-Options を参照してください。
- -n XSSProtection
- disable、 sanitize、または blockに設定します。 詳細は 、X-XSS-Protection を参照してください。
-o HTTPSConnector
HTTPConnector についてリストされているプロパティーは、HTTPSConnector でも有効です。 HTTPSConnector で有効なその他のプロパティーと値を以下に示します。
- -n AllowRenegotiation
- このプロパティを使用して、 TLS バージョン 1.2 で、 TLS のセッション再ネゴシエーションを許可するかどうかを指定します。 TLS 1.3 では、 TLS のセッション再ネゴシエーションのサポートが削除されたため、この設定は無視されます。
- -n CipherSpec
- この値として、使用可能な暗号を解く鍵のリストを設定します。 値を設定しないと、任意の使用可能な暗号を解く鍵が使用されます。 クライアントが、優先度順に配列した暗号のリストを送信します。 サーバーは、リスト内で許容される最初の暗号を選択します。 リスト内のいずれの暗号も適合しない場合、サーバーはハンドシェーク障害アラートを返し、接続を閉じます。
OpenSSL 暗号仕様に関する詳細情報については、 https://www.openssl.org/docs/man1.1.0/man1/ciphers.html。
- 値タイプ - コンマ区切りリスト
- 初期値 - ヌル
- -n EnableTLSTrace
- このプロパティーを設定して、コンソールへの TLS ハンドシェーク・メッセージのトレースを使用可能にします。 デフォルトでは、このプロパティーは false に設定されています。
- -n KeyAlias
- この値として、鍵ストアでサーバー証明書に指定されている別名を設定します。 デフォルトでは、鍵ストアの 1 番目の鍵が使用されます。
- -n KeyPassword
- この値として、鍵ストア・ファイルのサーバー証明書にアクセスするために使用されるパスワードを設定します。 この値は、プレーン・テキストのパスワードにすることも、値に
brokerKeystore::KeyPasswordという接頭部が付いている場合は、 mqsisetdbparms コマンドによって構成された名前付きの値にすることもできます。
- -n KeystoreFile
- この値として、サーバー証明書が格納されている鍵ストア・ファイルのパスとファイル名を設定します。
- 値タイプ - ストリング
- 初期値 - プラットフォームのデフォルト
- -n KeystorePassword
- この値として、鍵ストア・ファイルのサーバー証明書にアクセスするために使用されるパスワードを設定します。 値はプレーンテキストのパスワードか、値の先頭に"brokerKeystore::",パスワードは、mqsisetdbparms指示。
- -n KeystoreType
- この値として、使用する鍵ストア・ファイルのタイプを設定します。
- -n ReqClientAuth
- 接続を受け入れる前に、有効な SSL 証明書をクライアントから受信する必要がある場合は、この値を true に設定します。
- -n RejectUnauthorizedClient
- クライアント証明書のないクライアントの接続を許可したい場合は、値を false に設定します。
このプロパティーは、ReqClientAuth プロパティーが true に設定されている場合にのみ適用されます。
- -n StrictTransportSecurity
- 接続に Strict-Transport-Security ヘッダーを使用するには、このプロパティーを設定します。 詳細については 、Strict-Transport-Security を参照してください。
- -n TLSCertVerifyDepth
- この値を使用して、検証に合格するために証明書チェーンに入れることができる証明書の最大数を指定します。 証明書チェーンに、この制限によって指定された数より多くの証明書がある場合、検証は失敗します。 許可される証明書のデフォルト数は 100 です。
- -n TLSContextTimeout
- この値を使用して、新しいセッションがタイムアウトになるまでの時間の長さを指定します。 デフォルトのタイムアウトは 300 秒です。
- -n TLSProtocols
- この値を使用して、使用可能にする TLS プロトコルのバージョンを指定します。 TLSProtocols プロパティーには、all、none、または TLSv1.2 および TLSv1.3 のコンマ区切りのストリング・リストの値を指定できます。 TLS プロトコルでサポートされているバージョンは、 1.2 および 1.3 のみです。 これらの値で大/小文字の区別はされません。 デフォルト値は all です。
TLSProtocols を all に設定すると、両方のバージョンが使用可能になります。
TLSProtocols を TLSv1.2 および TLSv1.3 のコンマ区切りのストリング・リストに設定すると、両方のバージョンが使用可能になります。 これらのバージョンは任意の順序でリストできます。
TLSProtocols を none に設定すると、すべての TLS バージョンが使用不可になり、リスナーは使用できなくなります。
- -n TruststoreFile
- この値として、トラストストア・ファイルのパスとファイル名を設定します。
- 値タイプ - ストリング
- 初期値 - プラットフォームのデフォルト
- -n TruststorePassword
- この値として、トラストストア・ファイルにアクセスするために使用するパスワードを設定します。 プレーン・テキストのパスワードを指定できます。または、値に
brokerTruststore:: という接頭部が付いている場合は、パスワードは mqsisetdbparms コマンドにより構成される名前付き値です。
- -n TruststoreType
- この値として、使用するトラストストア・ファイルのタイプを設定します。
パラメータの変更方法については 、mqsichangepropertiesコマンドを参照してください。