HTTP コールアウトの呼び出し

October 7, 2021

寄稿者:

HTTP コールアウトを設定したら、デフォルトの構文ポリシー規則にSYS.HTTP_CALLOUT(<name>) 式を含めることによって、コールアウトを呼び出します。この式では、<name> は呼び出す HTTP コールアウトの名前です。

コールアウト式とともにデフォルトの構文式演算子を使用して、応答を処理し、適切なアクションを実行できます。HTTP コールアウトエージェントからの応答の戻り値の型によって、応答で使用できる演算子のセットが決まります。分析する応答の一部がテキストの場合は、テキスト演算子を使用して応答を分析できます。たとえば、<string> 次の例のように、CONTAINS () 演算子を使用して、レスポンスの指定した部分に特定の文字列が含まれているかどうかを確認できます。

SYS.HTTP_CALLOUT(mycallout).contains("Good IP address")
 

応答側ポリシーで前述の式を使用する場合は、適切な応答側アクションを設定できます。

同様に、評価する応答の一部が数値である場合は、GT（int）などの数値演算子を使用できます。応答にブール値が含まれている場合は、ブール演算子を使用できます。

注：HTTPコールアウトは、再帰的に自分自身を呼び出すことができます。HTTP コールアウトの再帰を回避するには、HTTP コールアウト式と、再帰を防止するデフォルトの構文式を組み合わせます。HTTP コールアウトの再帰を回避する方法については、「HTTP コールアウトの再帰を回避する」を参照してください。

以前に生成されたコールアウトを評価した後にコールアウトを呼び出すポリシーを設定することで、HTTP コールアウトをカスケードすることもできます。このシナリオでは、あるポリシーがコールアウトを呼び出した後、Citrix ADCアプライアンスがコールアウトをコールアウトサーバーに送信する前にコールアウトを解析するときに、2番目のポリシーセットでコールアウトを評価し、追加のコールアウトを呼び出すことができます。このコールアウトは、3番目のポリシーセットで評価できます。このような実装については、次の例で説明します。

まず、myCallout1 という HTTP コールアウトを設定してから、応答側ポリシー Pol1 を設定して myCallout1 を呼び出すことができます。次に、2 番目の HTTP コールアウト myCallout2、レスポンダーポリシー Pol2 を構成できます。Pol2 を設定して、myCallout1 を評価し、myCallout2 を呼び出します。両方のレスポンダーポリシーをグローバルにバインドします。

HTTP コールアウトの再帰を避けるために、myCallout1 には「Request1」という一意のカスタム HTTP ヘッダーが設定されています。Pol1 は、HTTP コールアウトの再帰を避けるように設定されており、デフォルトの構文式

HTTP.REQ.HEADER("Request1").EQ("Callout Request").NOT.
 

Pol2は同じデフォルトの構文式を使用しますが、.NOT演算子は除外されるため、Citrix ADCアプライアンスがmyCallout1を解析するときにポリシーが評価します。myCallout2 は「Request2」と呼ばれる独自のヘッダーを識別し、Pol2 には myCallout2 が再帰的に呼び出されないようにするためのデフォルトの構文式が含まれています。

例:

> add policy httpCallout myCallout1

Done

> set policy httpCallout myCallout1 -IPAddress 10.102.3.95 -port 80 -returnType TEXT -hostExpr
 ""10.102.3.95"" -urlStemExpr ""/cgi-bin/check_clnt_from_database.pl"" -headers Request1
("Callout Request") -parameters cip(CLIENT.IP.SRC) -resultExpr "HTTP.RES.BODY(100)"

Done

> add responder policy Pol1 "HTTP.REQ.HEADER("Request1").EQ("Callout Request").NOT &&
SYS.HTTP_CALLOUT(myCallout1).CONTAINS("IP Matched")" RESET

Done

> bind responder global Pol1 100 END -type OVERRIDE

Done

> add policy httpCallout myCallout2

Done

> set policy httpCallout myCallout2 -IPAddress 10.102.3.96 -port 80 -returnType TEXT -hostExpr
""10.102.3.96"" -urlStemExpr ""/cgi-bin/check_clnt_location_from_database.pl"" -headers Request2
("Callout Request") -parameters cip(CLIENT.IP.SRC) -resultExpr "HTTP.RES.BODY(200)"

 Done

> add responder policy Pol2 "HTTP.REQ.HEADER("Request2").EQ("Callout Request").NOT &&
 HTTP.REQ.HEADER("Request1").EQ("Callout Request") && SYS.HTTP_CALLOUT(myCallout2).CONTAINS
("APAC")" RESET

 Done

> bind responder global Pol2 110 END -type OVERRIDE

Done

このコンテンツの正式なバージョンは英語で提供されています。Cloud Software Groupドキュメントのコンテンツの一部は、お客様の利便性のみを目的として機械翻訳されています。Cloud Software Groupは機械翻訳されたコンテンツを管理していないため、誤り、不正確な情報、不適切な用語が含まれる場合があります。英語の原文から他言語への翻訳について、精度、信頼性、適合性、正確性、またはお使いのCloud Software Group製品またはサービスと機械翻訳されたコンテンツとの整合性に関する保証、該当するライセンス契約書またはサービス利用規約、あるいはCloud Software Groupとのその他すべての契約に基づき提供される保証、および製品またはサービスのドキュメントとの一致に関する保証は、明示的か黙示的かを問わず、かかるドキュメントの機械翻訳された範囲には適用されないものとします。機械翻訳されたコンテンツの使用に起因する損害または問題について、Cloud Software Groupは責任を負わないものとします。

HTTP コールアウトの呼び出し

October 7, 2021

寄稿者:

HTTP コールアウトの呼び出し

この記事の概要