条件の理解

入力JSONドキュメント構造

JMESPath式を評価する際、WAFは、評価をトリガーしたHTTPリクエストまたはHTTPレスポンスの詳細を含む入力JSONドキュメントを提供します。入力JSONドキュメントは、常にJSONオブジェクトです。

例

次の詳細を含むHTTPリクエストの場合:

• ソースIPアドレスおよびポート: 129.146.10.1:48152

• ソースIPアドレスが属する国コード: US

• ソースIPアドレスが属するASN: 31898

• 宛先IPアドレスおよびポート: 205.147.88.0:80

• 宛先ホスト: example.com

• プロトコル: HTTP/1.1

GET /test/path/img.jpg?param1=a&m2=b HTTP/1.1
Accept: */*
Accept-Encoding: gzip, deflate
Connection: keep-alive
Cookie: cookie1=A; cookie2=B; cookie3=3C; cookie3=3D
Host: example.com
User-Agent: HTTPie/2.4.0

次のJSON入力ドキュメントが生成され、JMESPath式に渡されます:

{
  "connection": {
    "source": {
      "address": "129.146.10.1",
      "port": 49152,
      "geo": {
        "countryCode": "US"
      },
      "routing": {
        "asn": 31898
      }
    },
    "destination": {
      "address": "205.147.88.0",
      "port": 80
    },
    "protocol": "http"
  },
  "http": {
    "request": {
      "host": "www.example.com",
      "method": "GET",
      "version": "1.1",
      "url": {
        "path": "/test/path/img.jpg",
        "query": "param1=a&param2=b",
        "queryParameters": {
          "param1": ["a"],
          "param2": ["b"]
        },
        "queryPrefix": "?"
      },
      "headers": {
        "accept": ["*/*"],
        "accept-encoding": ["gzip, deflate"],
        "connection": ["keep-alive"],
        "cookie": [
          "cookie1=A; cookie2=B; cookie3=3C; cookie3=3D"
        ],
        "host": ["www.example.com"],
        "user-agent": ["HTTPie/2.4.0"]
      },
      "cookies": {
        "cookie1": ["A"],
        "cookie2": ["B"],
        "cookie3": ["3C", "3D"]
      }
    }
  }
}

リファレンス

{
  "param1": ["a"],
  "param2": ["b"],
  "param3": ["c"]
}

{
  "multi": ["one","two", "3"],
  "encoded key": ["two words"]
}

Accept: application/json, text/csv
Accept: */*
Accept-Encoding: gzip
Accept-Encoding: deflate
Connection: keep-alive
Content-Language: en, fr
Content-Type: application/json
Host: www.example.com
User-Agent: HTTPie/2.2.0

{
  "accept":           ["application/json, text/csv", "*/*"],
  "accept-encoding":  ["gzip", "deflate"],
  "connection":       ["keep-alive"],
  "content-language": ["en, fr"],
  "content-type":     ["application/json"],
  "host":             ["www.example.com"],
  "user-agent":       ["HTTPie/2.2.0"]
}
}

cookie1=A; cookie2=B; cookie3=3C; cookie3=3D

{
  "cookie1": ["A"],
  "cookie2": ["B"],
  "cookie3": ["3C", "3D"]
}

Cache-Control: no-cache
Cache-Control: must-revalidate
Connection: keep-alive
Content-Encoding: gzip
Content-Type: text/html;charset=UTF-8

{
  "cache-control":    ["no-cache", "must-revalidate"],
  "connection":       ["keep-alive"],
  "content-encoding": ["gzip"],
  "content-type":     ["text/html;charset=UTF-8"]
}

大/小文字を区別しない文字列照合

WAFでは、JMESPathでデフォルトでサポートされている文字列照合関数に加えて、大文字と小文字を区別せずに文字列を照合できる4つの関数のサポートが追加されています:

• i_equals (==演算子の大/小文字を区別しないバリアント)。
• i_contains (contains関数の大/小文字を区別しないバリアント)。
• i_starts_with (starts_with関数の大/小文字を区別しないバリアント)。
• i_ends_with (ends_with関数の大/小文字を区別しないバリアント)。

i_equals

boolean i_equals(string $left, string $right)

i_contains

boolean i_contains(array|string $subject, any $search)

大/小文字を区別せずに比較すると、指定された$subjectが文字列の場合、この関数は、指定された$search引数が文字列に含まれている場合はtrueを返します($leftと$rightの両方の文字列は小文字に変換されます。英語の文字のみが小文字に変換されます)。それ以外の場合、この関数はfalseを返します。

$subjectが配列の場合、この関数は、配列内の少なくとも1つの要素が指定の$search値と等しい場合はtrueを返し、それ以外の場合はfalseを返します。

$searchが文字列の場合、比較はi_equals()関数と同じロジック(大/小文字を区別しない比較)を使用して行われます(個々の$subject配列要素と$search文字列の両方が小文字に変換されます。英語の文字のみが小文字に変換されます)。

$searchが文字列でない場合、比較は標準の==演算子を使用して行われます。

i_starts_with

boolean i_starts_with(string $subject, string $prefix)

i_ends_with

boolean i_ends_with(string $subject, string $suffix)

IPアドレスの照合

WAFでは、IPアドレスをCIDR範囲のリストまたはWAFネットワーク・アドレス・リスト・リソースと照合できる複数の機能のサポートが追加されています:

• address_in (IPアドレスをCIDR範囲のリストと照合します)。

• address_in_network_address_list (IPアドレスをWAFネットワーク・アドレス・リスト・リソースと照合します)。

• vcn_address_in_network_address_list (VCN IDを持つIPアドレスをWAFネットワーク・アドレス・リスト・リソースと照合します)。

address_in

boolean address_in(string $ip_address, array[string] $cidr_subnets)

指定された$ip_addressが、$cidr_subnetsで指定されたCIDRサブネットの少なくとも1つに含まれている場合は、trueを返します。それ以外の場合は、falseを返します。

$ip_addressは、IPアドレスを含む文字列である必要があります。

$cidr_subnetsは、それぞれ1つのCIDRサブネットを含む文字列の配列である必要があります。

{
  "connection": {
    "source": {
      "address": "1.1.1.1"
    }
  }
}

address_in_network_address_list

boolean address_in_network_address_list(string $ip_address, array[string] $nal_ids)

$ip_addressは、IPアドレスを含む文字列である必要があります。

$nal_id引数は、IDでWAF NetworkAddressListリソースを参照する文字列の配列である必要があります。参照されるすべてのNetworkAddressListsのタイプは、"ADDRESSES"である必要があります。

例1

{
  "connection": {
    "source": {
      "address": "1.1.1.1"
    }
  }
}

{
  "connection": {
    "source": {
      "address": "1.1.1.1"
    }
  }
}

vcn_address_in_network_address_list

boolean vcn_address_in_network_address_list(string $ip_address, string $vcn_id, array[string] $nal_ids)

$ip_addressは、IPアドレスを含む文字列である必要があります。

$vcn_idは、VCNのOCIDを含む文字列である必要があります。

$nal_idsは、IDでWAF NetworkAddressListリソースを参照する文字列の配列である必要があります。参照されるすべてのNetworkAddressListsのタイプは、"VCN_ADDRESSES"である必要があります。

{
  "connection": {
    "source": {
      "address": "10.0.0.1"
    }
  },
  "paResource": {
    "vcnOcid": "ocid1.vcn...a"
  }
}

vcn_address_in_network_address_list(
  connection.source.address,
  connection.paResource.vcnOcid,
  ['ocid1.webappfirewallnetworkaddresslist...a']
)

{
  "connection": {
    "source": {
      "address": "10.0.0.1"
    }
  },
  "paResource": {
    "vcnOcid": "ocid1.vcn...a"
  }
}