製品ドキュメント
ADC
14.1 - Current Release 13.1 13.0 12.1
PDFを表示

セレクタを構成する

December 8, 2023
寄稿者: 
C

セレクタは、要求を識別するためのフィルタです。クライアント IP アドレスやリクエスト内の URL などのリクエスト属性を識別する最大 5 つの個別のデフォルト構文式で構成されます。各式は非複合デフォルト構文式であり、他の式と AND 関係にあると見なされます。セレクター式の例をいくつか示します：

  • HTTP.REQ.URL
  • CLIENT.IP.SRC
  • HTTP.RES.BODY(1000).AFTER_STR("<string>").BEFORE_STR("<string>")"
  • CLIENT.IP.SRC.SUBNET(24)

セレクターは、レート制限とアクション分析の設定で使用されます。セレクターはレート制限設定ではオプションですが、アクション分析設定では必須です。

パラメータを指定する順序は重要です。たとえば、1つのセレクターでIPアドレスとドメインを（この順序で）構成し、別のセレクターでドメインとIPアドレスを（逆の順序で）指定すると、NetScalerはこれらの値を一意と見なします。これにより、同じトランザクションが 2 回カウントされる可能性があります。また、複数のポリシーが同じセレクタを呼び出す場合、NetScalerは同じトランザクションを複数回カウントできます。

セレクタの式を変更すると、それを呼び出すポリシーが新しいポリシーラベルまたはバインドポイントにバインドされていると、エラーが発生することがあります。たとえば、myLimitSelector1 という名前のセレクタを作成し、それを myLimitId1 から呼び出して、dnsRateLimit1 という名前の DNS ポリシーから識別子を呼び出すとします。myLimitSelector1 の式を変更すると、dnsRateLimit1 を新しいバインドポイントにバインドするときにエラーが発生することがあります。回避策は、これらの式を呼び出すポリシーを作成する前に、これらの式を変更することです。

Citrix ADCアプライアンスには、 最も一般的なユースケースに対応するセレクターが組み込まれています 。

また、選択したリクエスト属性を識別する式を使用してセレクタを設定することもできます。たとえば、特定のヘッダーで到着するリクエストのレコードを作成するとします。ヘッダーを評価するために、使用するセレクターにHTTP.REQ.HEADER("<header_name>")を追加できます。

コマンドラインインターフェイスを使用してセレクタを設定するには、次の手順を実行します。

コマンドプロンプトで次のコマンドを入力して、セレクタを構成し、構成を確認します。

  • add stream selector <name> <rule> ...
  • show stream selector

例

> add stream selector myselector HTTP.REQ.URL CLIENT.IP.SRC
 Done
> show stream selector myselector
    Name: myselector
    Expressions:
        1) HTTP.REQ.URL
        2) CLIENT.IP.SRC
 Done
>
<!--NeedCopy-->

コマンドラインインターフェイスを使用してセレクタを変更または削除するには、次の手順を実行します。

  • セレクターを変更するには、set stream selector コマンド、セレクターの名前、および式を含む規則パラメーターを入力します。保持する既存の式と、追加する新しい式を入力します。
  • セレクターを削除するには、rm stream selector コマンドとセレクターの名前を入力します。

GUI を使用してセレクタを設定するには、次の手順を実行します。

  1. [ AppExpert ] > [ アクション分析] > [セレクター]に移動します。
  2. 詳細ウィンドウで、次のいずれかの操作を行います：
    • セレクタを作成するには、[ 追加] をクリックします。
    • セレクタを変更するには、セレクタを選択し、[ 編集] をクリックします。
  3. 「 セレクタの作成 」または「 セレクタの設定 」ページで、次のパラメータを設定します。
    • Name：セレクターの名前を追加するには、 名前フィールドに名前を入力します 。名前は ASCII、英数字、またはアンダースコア文字で始まる必要があります。名前には、ASCII 英数字、アンダースコア、ハッシュ、ピリオド、スペース、コロン、アット文字、等号、ハイフンのみを含める必要があります。
    • Expressions. セレクタ設定に式を追加するには、[ 挿入] をクリックします。セレクター設定から式を削除するには、[式] ボックスで式を選択し、[削除] をクリックします。注:[式] ボックスに、有効なパラメータを入力します。たとえば、HTTP と入力します。次に、このパラメータの後にピリオドを入力します。ドロップダウンメニューが表示されます。このメニューの内容には、入力した最初のキーワードの後に続くキーワードが表示されます。このエクスプレフィックス内の次のキーワードを選択するには、ドロップダウンメニューで選択したキーワードをダブルクリックします。[式] テキストボックスには、 式プレフィックスの 1 番目と 2 番目のキーワード (HTTP.REQ など) の両方が表示されます。完全なエクスプレッションが形成されるまで、エクスプレッションコンポーネントの追加を続けます。
  4. [ 挿入] をクリックします。
  5. 非複合式を 5 つまで追加します。
  6. [ 作成 ]、[ 閉じる] の順にクリックします。
セレクタを構成する
December 8, 2023
寄稿者: 
C
December 8, 2023
寄稿者: 
C

この記事の概要

サイトに関するフィードバック | Your privacy choices footer linkプライバシーに関する選択肢 | プライバシーと法令 | Cookieの設定 | 同意設定 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.