Informazioni sulle condizioni

Struttura documento JSON di input

Quando si valutano le espressioni JMESPath, WAF fornisce un documento JSON di input, che include i dettagli della richiesta HTTP o della risposta HTTP che ha attivato la valutazione. Il documento JSON di input è sempre un oggetto JSON.

Esempio

Per una richiesta HTTP con i seguenti dettagli:

• Indirizzo IP e porta di origine: 129.146.10.1:48152

• Codice paese a cui appartiene l'indirizzo IP di origine: USA

• ASN a cui appartiene l'indirizzo IP di origine: 31898

• Indirizzo IP e porta di destinazione: 205.147.88.0:80

• Host di destinazione: example.com

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

Il seguente documento di input JSON viene generato e passato alle espressioni 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"]
      }
    }
  }
}

Di riferimento

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

Corrispondenza stringa con distinzione tra maiuscole e minuscole

Oltre alle funzioni di corrispondenza delle stringhe supportate per impostazione predefinita in JMESPath, WAF aggiunge il supporto per quattro funzioni che possono corrispondere alle stringhe senza distinzione tra maiuscole e minuscole:

• i_uguale (variante senza distinzione tra maiuscole e minuscole dell'operatore ==);
• i_contains (variante senza distinzione tra maiuscole e minuscole della funzione Contiene);
• i_starts_with (variante senza distinzione tra maiuscole e minuscole della funzione starts_with);
• i_ends_with (variante senza distinzione tra maiuscole e minuscole della funzione ends_with).

i_uguale a

boolean i_equals(string $left, string $right)

i_contiene

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

Se $subject fornito è una stringa, questa funzione restituisce true se la stringa contiene l'argomento $search fornito, se confrontata senza distinzione tra maiuscole e minuscole (sia le stringhe $left che $right vengono convertite in minuscole, solo le lettere inglesi vengono convertite in minuscole). In caso contrario, questa funzione restituisce false.

Se $subject è un array, questa funzione restituisce true se almeno uno degli elementi dell'array è uguale al valore $search fornito, altrimenti restituisce false.

Se $search è una stringa - il confronto viene eseguito utilizzando la stessa logica della funzione i_equals(): confronto senza distinzione tra maiuscole e minuscole (sia l'elemento array $subject che le stringhe $search vengono convertite in minuscole, solo le lettere inglesi vengono convertite in minuscole).

Se $search non è una stringa, il confronto viene eseguito utilizzando l'operatore standard ==.

i_start_con

boolean i_starts_with(string $subject, string $prefix)

i_end_con

boolean i_ends_with(string $subject, string $suffix)

Corrispondenza indirizzo IP

WAF aggiunge il supporto per più funzioni che possono corrispondere a un indirizzo IP rispetto a una lista di intervalli CIDR o risorse della lista di indirizzi di rete WAF:

• address_in (abbina un indirizzo IP a un elenco di intervalli CIDR);

• address_in_network_address_list (corrisponde a un indirizzo IP rispetto a una risorsa della lista di indirizzi di rete WAF);

• vcn_address_in_network_address_list (abbina un indirizzo IP con un ID VCN a una risorsa della lista di indirizzi di rete WAF).

address_in

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

Restituisce true se $ip_address specificato è contenuto in almeno una delle subnet CIDR specificate in $cidr_subnets. In caso contrario restituisce false.

$ip_address deve essere una stringa contenente un indirizzo IP.

$cidr_subnets deve essere un array di stringhe contenenti ciascuna subnet 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 deve essere una stringa contenente un indirizzo IP.

Gli argomenti $nal_id devono essere un array di stringhe che fanno riferimento alle risorse NetworkAddressList WAF per ID. Tutti i riferimenti a NetworkAddressLists devono essere di tipo: "ADDRESSES".

Esempio 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 deve essere una stringa contenente un indirizzo IP.

$vcn_id deve essere una stringa contenente un OCID di una VCN.

$nal_ids deve essere un array di stringhe che fanno riferimento alle risorse NetworkAddressList WAF per ID. Tutti i NetworkAddressLists di riferimento devono essere di 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"
  }
}