Descripción de condiciones

Estructura de documento JSON de entrada

Al evaluar expresiones JMESPath, WAF proporciona un documento JSON de entrada, que incluye los detalles de la solicitud HTTP o la respuesta HTTP que ha disparado la evaluación. El documento JSON de entrada siempre es un objeto JSON.

Ejemplo

Para una solicitud HTTP con los siguientes detalles:

• Puerto y dirección IP de origen: 129.146.10.1:48152

• Código de país al que pertenece la dirección IP de origen: US

• ASN al que pertenece la dirección IP de origen: 31898

• Puerto y dirección IP de destino: 205.147.88.0:80

• Host de destino: example.com

• Protocolo: 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

Se genera el siguiente documento de entrada JSON y se transfiere a las expresiones 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"]
      }
    }
  }
}

De referencia

{
  "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"]
}

Coincidencia de cadenas no sensible a mayúsculas/minúsculas

Además de las funciones de coincidencia de cadenas soportadas por defecto en JMESPath, WAF agrega soporte para cuatro funciones que pueden coincidir con cadenas de forma no sensible a mayúsculas/minúsculas:

• i_equals (variante no sensible a mayúsculas/minúsculas del operador ==);
• i_contains (variante no sensible a mayúsculas/minúsculas de la función contains);
• i_starts_with (variante no sensible a mayúsculas/minúsculas de la función starts_with);
• i_ends_with (variante no sensible a mayúsculas/minúsculas de la función ends_with).

i_equals

boolean i_equals(string $left, string $right)

i_contains

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

Si el valor $subject proporcionado es una cadena, esta función devuelve true si la cadena contiene el argumento $search proporcionado, cuando se comparan de forma no sensible a mayúsculas/minúsculas (las cadenas $left y $right se convierten a minúsculas, solo las letras en inglés se convierten a minúsculas). De lo contrario, esta función devuelve false.

Si $subject es una matriz, esta función devuelve true si al menos uno de los elementos de la matriz es igual al valor de $search proporcionado; de lo contrario, devuelve false.

Si $search es una cadena, la comparación se realiza con la misma lógica que en la función i_equals(): comparación no sensible a mayúsculas/minúsculas (tanto el elemento de la matriz $subject individual como las cadenas $search se convierten a minúsculas, solo las letras en inglés se convierten a minúsculas).

Si $search no es una cadena, la comparación se realiza mediante el operador == estándar.

i_starts_with

boolean i_starts_with(string $subject, string $prefix)

i_ends_with

boolean i_ends_with(string $subject, string $suffix)

Coincidencia de dirección IP

WAF proporciona soporte para varias funciones que pueden establecer una coincidencia de una dirección IP con una lista de rangos CIDR o recursos de la lista de direcciones de red WAF:

• address_in (establece una coincidencia de una dirección IP con una lista de rangos CIDR);

• address_in_network_address_list (establece una coincidencia de una dirección IP con un recurso de lista de direcciones de red WAF);

• vcn_address_in_network_address_list (establece una coincidencia de una dirección IP con un ID de VCN con un recurso de lista de direcciones de red WAF).

address_in

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

Devuelve true si el valor de $ip_address proporcionado está incluido en al menos una de las subredes CIDR especificadas en $cidr_subnets. Si no es así, devuelve false.

$ip_address debe ser una cadena que contenga una dirección IP.

$cidr_subnets debe ser una matriz de cadenas que contengan una subred CIDR cada una.

{
  "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 debe ser una cadena que contenga una dirección IP.

Los argumentos $nal_id deben ser una matriz de cadenas que haga referencia a los recursos de WAF NetworkAddressList por ID. Todos los NetworkAddressLists a los que se hace referencia deben ser del tipo: "ADDRESSES".

Ejemplo1

{
  "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 debe ser una cadena que contenga una dirección IP.

$vcn_id debe ser una cadena que contenga un OCID de una VCN.

$nal_ids debe ser una matriz de cadenas que haga referencia a los recursos de WAF NetworkAddressList por ID. Todos los NetworkAddressLists a los que se hace referencia deben ser del tipo: "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"
  }
}