oracle.oci.oci_waas_policy – Manage a WaasPolicy resource in Oracle Cloud Infrastructure

Note

This plugin is part of the oracle.oci collection (version 4.11.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install oracle.oci.

To use it in a playbook, specify: oracle.oci.oci_waas_policy.

New in version 2.9.0: of oracle.oci

Synopsis

  • This module allows the user to create, update and delete a WaasPolicy resource in Oracle Cloud Infrastructure

  • For state=present, creates a new Web Application Acceleration and Security (WAAS) policy in the specified compartment. A WAAS policy must be established before creating Web Application Firewall (WAF) rules. To use WAF rules, your web application’s origin servers must defined in the WaasPolicy schema.

  • A domain name must be specified when creating a WAAS policy. The domain name should be different from the origins specified in your WaasPolicy. Once domain name is entered and stored, it is unchangeable.

  • Use the record data returned in the cname field of the WaasPolicy object to create a CNAME record in your DNS configuration that will direct your domain’s traffic through the WAF.

  • For the purposes of access control, you must provide the OCID of the compartment where you want the service to reside. For information about access control and compartments, see Overview of the IAM Service.

  • You must specify a display name and domain for the WAAS policy. The display name does not have to be unique and can be changed. The domain name should be different from every origin specified in WaasPolicy.

  • All Oracle Cloud Infrastructure resources, including WAAS policies, receive a unique, Oracle-assigned ID called an Oracle Cloud Identifier (OCID). When a resource is created, you can find its OCID in the response. You can also retrieve a resource’s OCID by using a list API operation for that resource type, or by viewing the resource in the Console. Fore more information, see Resource Identifiers.

  • Note: After sending the POST request, the new object’s state will temporarily be CREATING. Ensure that the resource’s state has changed to ACTIVE before use.

  • This resource has the following action operations in the oracle.oci.oci_waas_policy_actions module: accept_recommendations, change_compartment, purge_cache.

Requirements

The below requirements are needed on the host that executes this module.

Parameters

Parameter Choices/Defaults Comments
additional_domains
list / elements=string
An array of additional domains for the specified web application.
This parameter is updatable.
api_user
string
The OCID of the user, on whose behalf, OCI APIs are invoked. If not set, then the value of the OCI_USER_ID environment variable, if any, is used. This option is required if the user is not specified through a configuration file (See config_file_location). To get the user's OCID, please refer https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/apisigningkey.htm.
api_user_fingerprint
string
Fingerprint for the key pair being used. If not set, then the value of the OCI_USER_FINGERPRINT environment variable, if any, is used. This option is required if the key fingerprint is not specified through a configuration file (See config_file_location). To get the key pair's fingerprint value please refer https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/apisigningkey.htm.
api_user_key_file
string
Full path and filename of the private key (in PEM format). If not set, then the value of the OCI_USER_KEY_FILE variable, if any, is used. This option is required if the private key is not specified through a configuration file (See config_file_location). If the key is encrypted with a pass-phrase, the api_user_key_pass_phrase option must also be provided.
api_user_key_pass_phrase
string
Passphrase used by the key referenced in api_user_key_file, if it is encrypted. If not set, then the value of the OCI_USER_KEY_PASS_PHRASE variable, if any, is used. This option is required if the key passphrase is not specified through a configuration file (See config_file_location).
auth_purpose
string
    Choices:
  • service_principal
The auth purpose which can be used in conjunction with 'auth_type=instance_principal'. The default auth_purpose for instance_principal is None.
auth_type
string
    Choices:
  • api_key ←
  • instance_principal
  • instance_obo_user
  • resource_principal
The type of authentication to use for making API requests. By default auth_type="api_key" based authentication is performed and the API key (see api_user_key_file) in your config file will be used. If this 'auth_type' module option is not specified, the value of the OCI_ANSIBLE_AUTH_TYPE, if any, is used. Use auth_type="instance_principal" to use instance principal based authentication when running ansible playbooks within an OCI compute instance.
cert_bundle
string
The full path to a CA certificate bundle to be used for SSL verification. This will override the default CA certificate bundle. If not set, then the value of the OCI_ANSIBLE_CERT_BUNDLE variable, if any, is used.
compartment_id
string
The OCID of the compartment in which to create the WAAS policy.
Required for create using state=present.
Required for update when environment variable OCI_USE_NAME_AS_IDENTIFIER is set.
Required for delete when environment variable OCI_USE_NAME_AS_IDENTIFIER is set.
config_file_location
string
Path to configuration file. If not set then the value of the OCI_CONFIG_FILE environment variable, if any, is used. Otherwise, defaults to ~/.oci/config.
config_profile_name
string
The profile to load from the config file referenced by config_file_location. If not set, then the value of the OCI_CONFIG_PROFILE environment variable, if any, is used. Otherwise, defaults to the "DEFAULT" profile in config_file_location.
defined_tags
dictionary
Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
Example: `{"Operations": {"CostCenter": "42"}}`
This parameter is updatable.
display_name
string
A user-friendly name for the WAAS policy. The name can be changed and does not need to be unique.
Required for create, update, delete when environment variable OCI_USE_NAME_AS_IDENTIFIER is set.
This parameter is updatable when OCI_USE_NAME_AS_IDENTIFIER is not set.

aliases: name
domain
string
The web application domain that the WAAS policy protects.
Required for create using state=present.
force_create
boolean
    Choices:
  • no ←
  • yes
Whether to attempt non-idempotent creation of a resource. By default, create resource is an idempotent operation, and doesn't create the resource if it already exists. Setting this option to true, forcefully creates a copy of the resource, even if it already exists.This option is mutually exclusive with key_by.
freeform_tags
dictionary
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags.
Example: `{"Department": "Finance"}`
This parameter is updatable.
key_by
list / elements=string
The list of attributes of this resource which should be used to uniquely identify an instance of the resource. By default, all the attributes of a resource are used to uniquely identify a resource.
origin_groups
dictionary
The map of origin groups and their keys used to associate origins to the `wafConfig`. Origin groups allow you to apply weights to groups of origins for load balancing purposes. Origins with higher weights will receive larger proportions of client requests. To add additional origins to your WAAS policy, update the `origins` field of a `UpdateWaasPolicy` request.
This parameter is updatable.
origins
list / elements=dictionary
The list of objects containing origin references and additional properties.
origin
string
The IP address or CIDR notation of the origin server.
weight
integer
The weight of the origin used in load balancing. Origins with higher weights will receive larger proportions of client requests.
origins
dictionary
A map of host to origin for the web application. The key should be a customer friendly name for the host, ex. primary, secondary, etc.
This parameter is updatable.
custom_headers
list / elements=dictionary
A list of HTTP headers to forward to your origin.
name
string / required
The name of the header.
value
string / required
The value of the header.
http_port
integer
The HTTP port on the origin that the web application listens on. If unspecified, defaults to `80`. If `0` is specified - the origin is not used for HTTP traffic.
https_port
integer
The HTTPS port on the origin that the web application listens on. If unspecified, defaults to `443`. If `0` is specified - the origin is not used for HTTPS traffic.
uri
string / required
The URI of the origin. Does not support paths. Port numbers should be specified in the `httpPort` and `httpsPort` fields.
policy_config
dictionary
This parameter is updatable.
certificate_id
string
The OCID of the SSL certificate to use if HTTPS is supported.
cipher_group
string
    Choices:
  • DEFAULT
The set cipher group for the configured TLS protocol. This sets the configuration for the TLS connections between clients and edge nodes only. - **DEFAULT:** Cipher group supports TLS 1.0, TLS 1.1, TLS 1.2, TLS 1.3 protocols. It has the following ciphers enabled: `ECDHE-RSA- AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE- DSS-AES128-GCM-SHA256:kEDH+AESGCM:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE- RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE-RSA-AES128-SHA:DHE- DSS-AES128-SHA256:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:AES128-GCM-SHA256:AES256-GCM- SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:AES:CAMELLIA:!DES- CBC3-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA`
client_address_header
string
    Choices:
  • X_FORWARDED_FOR
  • X_CLIENT_IP
  • X_REAL_IP
  • CLIENT_IP
  • TRUE_CLIENT_IP
Specifies an HTTP header name which is treated as the connecting client's IP address. Applicable only if `isBehindCdn` is enabled.
The edge node reads this header and its value and sets the client IP address as specified. It does not create the header if the header is not present in the request. If the header is not present, the connecting IP address will be used as the client's true IP address. It uses the last IP address in the header's value as the true IP address.
Example: `X-Client-Ip: 11.1.1.1, 13.3.3.3`
In the case of multiple headers with the same name, only the first header will be used. It is assumed that CDN sets the correct client IP address to prevent spoofing.
- **X_FORWARDED_FOR:** Corresponds to `X-Forwarded-For` header name.
- **X_CLIENT_IP:** Corresponds to `X-Client-Ip` header name.
- **X_REAL_IP:** Corresponds to `X-Real-Ip` header name.
- **CLIENT_IP:** Corresponds to `Client-Ip` header name.
- **TRUE_CLIENT_IP:** Corresponds to `True-Client-Ip` header name.
health_checks
dictionary
expected_response_code_group
list / elements=string
    Choices:
  • 2XX
  • 3XX
  • 4XX
  • 5XX
The HTTP response codes that signify a healthy state. - **2XX:** Success response code group. - **3XX:** Redirection response code group. - **4XX:** Client errors response code group. - **5XX:** Server errors response code group.
expected_response_text
string
Health check will search for the given text in a case-sensitive manner within the response body and will fail if the text is not found.
headers
dictionary
HTTP header fields to include in health check requests, expressed as `"name": "value"` properties. Because HTTP header field names are case-insensitive, any use of names that are case-insensitive equal to other names will be rejected. If Host is not specified, requests will include a Host header field with value matching the policy's protected domain. If User-Agent is not specified, requests will include a User-Agent header field with value "waf health checks".
**Note:** The only currently-supported header fields are Host and User-Agent.
healthy_threshold
integer
Number of successful health checks after which the server is marked up.
interval_in_seconds
integer
Time between health checks of an individual origin server, in seconds.
is_enabled
boolean
    Choices:
  • no
  • yes
Enables or disables the health checks.
is_response_text_check_enabled
boolean
    Choices:
  • no
  • yes
Enables or disables additional check for predefined text in addition to response code.
method
string
    Choices:
  • GET
  • HEAD
  • POST
An HTTP verb (i.e. HEAD, GET, or POST) to use when performing the health check.
path
string
Path to visit on your origins when performing the health check.
timeout_in_seconds
integer
Response timeout represents wait time until request is considered failed, in seconds.
unhealthy_threshold
integer
Number of failed health checks after which the server is marked down.
is_behind_cdn
boolean
    Choices:
  • no
  • yes
Enabling `isBehindCdn` allows for the collection of IP addresses from client requests if the WAF is connected to a CDN.
is_cache_control_respected
boolean
    Choices:
  • no
  • yes
Enable or disable automatic content caching based on the response `cache-control` header. This feature enables the origin to act as a proxy cache. Caching is usually defined using `cache-control` header. For example `cache-control: max-age=120` means that the returned resource is valid for 120 seconds. Caching rules will overwrite this setting.
is_https_enabled
boolean
    Choices:
  • no
  • yes
Enable or disable HTTPS support. If true, a `certificateId` is required. If unspecified, defaults to `false`.
is_https_forced
boolean
    Choices:
  • no
  • yes
Force HTTP to HTTPS redirection. If unspecified, defaults to `false`.
is_origin_compression_enabled
boolean
    Choices:
  • no
  • yes
Enable or disable GZIP compression of origin responses. If enabled, the header `Accept-Encoding: gzip` is sent to origin, otherwise, the empty `Accept-Encoding:` header is used.
is_response_buffering_enabled
boolean
    Choices:
  • no
  • yes
Enable or disable buffering of responses from the origin. Buffering improves overall stability in case of network issues, but slightly increases Time To First Byte.
is_sni_enabled
boolean
    Choices:
  • no
  • yes
SNI stands for Server Name Indication and is an extension of the TLS protocol. It indicates which hostname is being contacted by the browser at the beginning of the 'handshake'-process. This allows a server to connect multiple SSL Certificates to one IP address and port.
load_balancing_method
dictionary
An object that represents a load balancing method and its properties.
domain
string
The domain for which the cookie is set, defaults to WAAS policy domain.
Applicable when method is 'STICKY_COOKIE'
expiration_time_in_seconds
integer
The time for which a browser should keep the cookie in seconds. Empty value will cause the cookie to expire at the end of a browser session.
Applicable when method is 'STICKY_COOKIE'
method
string / required
    Choices:
  • ROUND_ROBIN
  • STICKY_COOKIE
  • IP_HASH
Load balancing methods are algorithms used to efficiently distribute traffic among origin servers.
- **IP_HASH:** All the incoming requests from the same client IP address should go to the same content origination server. IP_HASH load balancing method uses origin weights when choosing which origin should the hash be assigned to initially.
- **ROUND_ROBIN:** Forwards requests sequentially to the available origin servers. The first request - to the first origin server, the second request - to the next origin server, and so on. After it sends a request to the last origin server, it starts again with the first origin server. When using weights on origins, Weighted Round Robin assigns more requests to origins with a greater weight. Over a period of time, origins will receive a number of requests in proportion to their weight.
- **STICKY_COOKIE:** Adds a session cookie to the first response from the origin server and identifies the server that sent the response. The client's next request contains the cookie value, and nginx routes the request to the origin server that responded to the first request. STICKY_COOKIE load balancing method falls back to Round Robin for the first request.
name
string
The name of the cookie used to track the persistence. Can contain any US-ASCII character except separator or control character.
Applicable when method is 'STICKY_COOKIE'
tls_protocols
list / elements=string
    Choices:
  • TLS_V1
  • TLS_V1_1
  • TLS_V1_2
  • TLS_V1_3
A list of allowed TLS protocols. Only applicable when HTTPS support is enabled. The TLS protocol is negotiated while the request is connecting and the most recent protocol supported by both the edge node and client browser will be selected. If no such version exists, the connection will be aborted. - **TLS_V1:** corresponds to TLS 1.0 specification.
- **TLS_V1_1:** corresponds to TLS 1.1 specification.
- **TLS_V1_2:** corresponds to TLS 1.2 specification.
- **TLS_V1_3:** corresponds to TLS 1.3 specification.
Enabled TLS protocols must go in a row. For example if `TLS_v1_1` and `TLS_V1_3` are enabled, `TLS_V1_2` must be enabled too.
websocket_path_prefixes
list / elements=string
ModSecurity is not capable to inspect WebSockets. Therefore paths specified here have WAF disabled if Connection request header from the client has the value Upgrade (case insensitive matching) and Upgrade request header has the value websocket (case insensitive matching). Paths matches if the concatenation of request URL path and query starts with the contents of the one of `websocketPathPrefixes` array value. In All other cases challenges, like JSC, HIC and etc., remain active.
region
string
The Oracle Cloud Infrastructure region to use for all OCI API requests. If not set, then the value of the OCI_REGION variable, if any, is used. This option is required if the region is not specified through a configuration file (See config_file_location). Please refer to https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/regions.htm for more information on OCI regions.
state
string
    Choices:
  • present ←
  • absent
The state of the WaasPolicy.
Use state=present to create or update a WaasPolicy.
Use state=absent to delete a WaasPolicy.
tenancy
string
OCID of your tenancy. If not set, then the value of the OCI_TENANCY variable, if any, is used. This option is required if the tenancy OCID is not specified through a configuration file (See config_file_location). To get the tenancy OCID, please refer https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/apisigningkey.htm
waas_policy_id
string
The OCID of the WAAS policy.
Required for update using state=present when environment variable OCI_USE_NAME_AS_IDENTIFIER is not set.
Required for delete using state=absent when environment variable OCI_USE_NAME_AS_IDENTIFIER is not set.

aliases: id
waf_config
dictionary
This parameter is updatable.
access_rules
list / elements=dictionary
The access rules applied to the Web Application Firewall. Access rules allow custom content access policies to be defined and `ALLOW`, `DETECT`, or `BLOCK` actions to be taken on a request when specified criteria are met.
action
string / required
    Choices:
  • ALLOW
  • DETECT
  • BLOCK
  • BYPASS
  • REDIRECT
  • SHOW_CAPTCHA
The action to take when the access criteria are met for a rule. If unspecified, defaults to `ALLOW`.
- **ALLOW:** Takes no action, just logs the request.
- **DETECT:** Takes no action, but creates an alert for the request.
- **BLOCK:** Blocks the request by returning specified response code or showing error page.
- **BYPASS:** Bypasses some or all challenges.
- **REDIRECT:** Redirects the request to the specified URL. These fields are required when `REDIRECT` is selected: `redirectUrl`, `redirectResponseCode`.
- **SHOW_CAPTCHA:** Show a CAPTCHA Challenge page instead of the requested page.
Regardless of action, no further rules are processed once a rule is matched.
block_action
string
    Choices:
  • SET_RESPONSE_CODE
  • SHOW_ERROR_PAGE
The method used to block requests if `action` is set to `BLOCK` and the access criteria are met. If unspecified, defaults to `SET_RESPONSE_CODE`.
block_error_page_code
string
The error code to show on the error page when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_ERROR_PAGE`, and the access criteria are met. If unspecified, defaults to 'Access rules'.
block_error_page_description
string
The description text to show on the error page when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_ERROR_PAGE`, and the access criteria are met. If unspecified, defaults to 'Access blocked by website owner. Please contact support.'
block_error_page_message
string
The message to show on the error page when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_ERROR_PAGE`, and the access criteria are met. If unspecified, defaults to 'Access to the website is blocked.'
block_response_code
integer
The response status code to return when `action` is set to `BLOCK`, `blockAction` is set to `SET_RESPONSE_CODE`, and the access criteria are met. If unspecified, defaults to `403`. The list of available response codes: `200`, `201`, `202`, `204`, `206`, `300`, `301`, `302`, `303`, `304`, `307`, `400`, `401`, `403`, `404`, `405`, `408`, `409`, `411`, `412`, `413`, `414`, `415`, `416`, `422`, `444`, `494`, `495`, `496`, `497`, `499`, `500`, `501`, `502`, `503`, `504`, `507`.
bypass_challenges
list / elements=string
    Choices:
  • JS_CHALLENGE
  • DEVICE_FINGERPRINT_CHALLENGE
  • HUMAN_INTERACTION_CHALLENGE
  • CAPTCHA
The list of challenges to bypass when `action` is set to `BYPASS`. If unspecified or empty, all challenges are bypassed.
- **JS_CHALLENGE:** Bypasses JavaScript Challenge.
- **DEVICE_FINGERPRINT_CHALLENGE:** Bypasses Device Fingerprint Challenge.
- **HUMAN_INTERACTION_CHALLENGE:** Bypasses Human Interaction Challenge.
- **CAPTCHA:** Bypasses CAPTCHA Challenge.
captcha_footer
string
The text to show in the footer when showing a CAPTCHA challenge when `action` is set to `SHOW_CAPTCHA` and the request is challenged.
captcha_header
string
The text to show in the header when showing a CAPTCHA challenge when `action` is set to `SHOW_CAPTCHA` and the request is challenged.
captcha_submit_label
string
The text to show on the label of the CAPTCHA challenge submit button when `action` is set to `SHOW_CAPTCHA` and the request is challenged.
captcha_title
string
The title used when showing a CAPTCHA challenge when `action` is set to `SHOW_CAPTCHA` and the request is challenged.
criteria
list / elements=dictionary / required
The list of access rule criteria. The rule would be applied only for the requests that matched all the listed conditions.
condition
string / required
    Choices:
  • URL_IS
  • URL_IS_NOT
  • URL_STARTS_WITH
  • URL_PART_ENDS_WITH
  • URL_PART_CONTAINS
  • URL_REGEX
  • URL_DOES_NOT_MATCH_REGEX
  • URL_DOES_NOT_START_WITH
  • URL_PART_DOES_NOT_CONTAIN
  • URL_PART_DOES_NOT_END_WITH
  • IP_IS
  • IP_IS_NOT
  • IP_IN_LIST
  • IP_NOT_IN_LIST
  • HTTP_HEADER_CONTAINS
  • HTTP_METHOD_IS
  • HTTP_METHOD_IS_NOT
  • COUNTRY_IS
  • COUNTRY_IS_NOT
  • USER_AGENT_IS
  • USER_AGENT_IS_NOT
The criteria the access rule and JavaScript Challenge uses to determine if action should be taken on a request. - **URL_IS:** Matches if the concatenation of request URL path and query is identical to the contents of the `value` field. URL must start with a `/`. - **URL_IS_NOT:** Matches if the concatenation of request URL path and query is not identical to the contents of the `value` field. URL must start with a `/`. - **URL_STARTS_WITH:** Matches if the concatenation of request URL path and query starts with the contents of the `value` field. URL must start with a `/`. - **URL_PART_ENDS_WITH:** Matches if the concatenation of request URL path and query ends with the contents of the `value` field. - **URL_PART_CONTAINS:** Matches if the concatenation of request URL path and query contains the contents of the `value` field. - **URL_REGEX:** Matches if the concatenation of request URL path and query is described by the regular expression in the value field. The value must be a valid regular expression recognized by the PCRE library in Nginx (https://www.pcre.org). - **URL_DOES_NOT_MATCH_REGEX:** Matches if the concatenation of request URL path and query is not described by the regular expression in the `value` field. The value must be a valid regular expression recognized by the PCRE library in Nginx (https://www.pcre.org). - **URL_DOES_NOT_START_WITH:** Matches if the concatenation of request URL path and query does not start with the contents of the `value` field. - **URL_PART_DOES_NOT_CONTAIN:** Matches if the concatenation of request URL path and query does not contain the contents of the `value` field. - **URL_PART_DOES_NOT_END_WITH:** Matches if the concatenation of request URL path and query does not end with the contents of the `value` field. - **IP_IS:** Matches if the request originates from one of the IP addresses contained in the defined address list. The `value` in this case is string with one or multiple IPs or CIDR notations separated by new line symbol \n *Example:* "1.1.1.1\n1.1.1.2\n1.2.2.1/30" - **IP_IS_NOT:** Matches if the request does not originate from any of the IP addresses contained in the defined address list. The `value` in this case is string with one or multiple IPs or CIDR notations separated by new line symbol \n *Example:* "1.1.1.1\n1.1.1.2\n1.2.2.1/30" - **IP_IN_LIST:** Matches if the request originates from one of the IP addresses contained in the referenced address list. The `value` in this case is OCID of the address list. - **IP_NOT_IN_LIST:** Matches if the request does not originate from any IP address contained in the referenced address list. The `value` field in this case is OCID of the address list. - **HTTP_HEADER_CONTAINS:** The HTTP_HEADER_CONTAINS criteria is defined using a compound value separated by a colon: a header field name and a header field value. `host:test.example.com` is an example of a criteria value where `host` is the header field name and `test.example.com` is the header field value. A request matches when the header field name is a case insensitive match and the header field value is a case insensitive, substring match. *Example:* With a criteria value of `host:test.example.com`, where `host` is the name of the field and `test.example.com` is the value of the host field, a request with the header values, `Host: www.test.example.com` will match, where as a request with header values of `host: www.example.com` or `host: test.sub.example.com` will not match. - **HTTP_METHOD_IS:** Matches if the request method is identical to one of the values listed in field. The `value` in this case is string with one or multiple HTTP methods separated by new line symbol \n The list of available methods: `GET`, `HEAD`, `POST`, `PUT`, `DELETE`, `CONNECT`, `OPTIONS`, `TRACE`, `PATCH`
*Example:* "GET\nPOST"
- **HTTP_METHOD_IS_NOT:** Matches if the request is not identical to any of the contents of the `value` field. The `value` in this case is string with one or multiple HTTP methods separated by new line symbol \n The list of available methods: `GET`, `HEAD`, `POST`, `PUT`, `DELETE`, `CONNECT`, `OPTIONS`, `TRACE`, `PATCH`
*Example:* "GET\nPOST"
- **COUNTRY_IS:** Matches if the request originates from one of countries in the `value` field. The `value` in this case is string with one or multiple countries separated by new line symbol \n Country codes are in ISO 3166-1 alpha-2 format. For a list of codes, see ISO's website. *Example:* "AL\nDZ\nAM" - **COUNTRY_IS_NOT:** Matches if the request does not originate from any of countries in the `value` field. The `value` in this case is string with one or multiple countries separated by new line symbol \n Country codes are in ISO 3166-1 alpha-2 format. For a list of codes, see ISO's website. *Example:* "AL\nDZ\nAM" - **USER_AGENT_IS:** Matches if the requesting user agent is identical to the contents of the `value` field. *Example:* `Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:35.0) Gecko/20100101 Firefox/35.0` - **USER_AGENT_IS_NOT:** Matches if the requesting user agent is not identical to the contents of the `value` field. *Example:* `Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:35.0) Gecko/20100101 Firefox/35.0`
is_case_sensitive
boolean
    Choices:
  • no
  • yes
When enabled, the condition will be matched with case-sensitive rules.
value
string / required
The criteria value.
name
string / required
The unique name of the access rule.
redirect_response_code
string
    Choices:
  • MOVED_PERMANENTLY
  • FOUND
The response status code to return when `action` is set to `REDIRECT`.
- **MOVED_PERMANENTLY:** Used for designating the permanent movement of a page (numerical code - 301).
- **FOUND:** Used for designating the temporary movement of a page (numerical code - 302).
redirect_url
string
The target to which the request should be redirected, represented as a URI reference. Required when `action` is `REDIRECT`.
response_header_manipulation
list / elements=dictionary
An object that represents an action to apply to an HTTP response headers if all rule criteria will be matched regardless of `action` value.
action
string / required
    Choices:
  • EXTEND_HTTP_RESPONSE_HEADER
  • ADD_HTTP_RESPONSE_HEADER
  • REMOVE_HTTP_RESPONSE_HEADER
header
string / required
A header field name that conforms to RFC 7230.
Example: `example_header_name`
value
string
A header field value that conforms to RFC 7230.
Example: `example_value`
Required when action is one of ['ADD_HTTP_RESPONSE_HEADER', 'EXTEND_HTTP_RESPONSE_HEADER']
address_rate_limiting
dictionary
The settings used to limit the number of requests from an IP address.
allowed_rate_per_address
integer
The number of allowed requests per second from one IP address. If unspecified, defaults to `1`.
block_response_code
integer
The response status code returned when a request is blocked. If unspecified, defaults to `503`. The list of available response codes: `400`, `401`, `403`, `404`, `405`, `408`, `409`, `411`, `412`, `413`, `414`, `415`, `416`, `422`, `494`, `495`, `496`, `497`, `499`, `500`, `501`, `502`, `503`, `504`, `507`.
is_enabled
boolean / required
    Choices:
  • no
  • yes
Enables or disables the address rate limiting Web Application Firewall feature.
max_delayed_count_per_address
integer
The maximum number of requests allowed to be queued before subsequent requests are dropped. If unspecified, defaults to `10`.
caching_rules
list / elements=dictionary
A list of caching rules applied to the web application.
action
string / required
    Choices:
  • CACHE
  • BYPASS_CACHE
The action to take when the criteria of a caching rule are met. - **CACHE:** Caches requested content when the criteria of the rule are met.
- **BYPASS_CACHE:** Allows requests to bypass the cache and be directed to the origin when the criteria of the rule is met.
caching_duration
string
The duration to cache content for the caching rule, specified in ISO 8601 extended format. Supported units: seconds, minutes, hours, days, weeks, months. The maximum value that can be set for any unit is `99`. Mixing of multiple units is not supported. Only applies when the `action` is set to `CACHE`. Example: `PT1H`
client_caching_duration
string
The duration to cache content in the user's browser, specified in ISO 8601 extended format. Supported units: seconds, minutes, hours, days, weeks, months. The maximum value that can be set for any unit is `99`. Mixing of multiple units is not supported. Only applies when the `action` is set to `CACHE`. Example: `PT1H`
criteria
list / elements=dictionary / required
The array of the rule criteria with condition and value. The caching rule would be applied for the requests that matched any of the listed conditions.
condition
string / required
    Choices:
  • URL_IS
  • URL_STARTS_WITH
  • URL_PART_ENDS_WITH
  • URL_PART_CONTAINS
The condition of the caching rule criteria. - **URL_IS:** Matches if the concatenation of request URL path and query is identical to the contents of the `value` field.
- **URL_STARTS_WITH:** Matches if the concatenation of request URL path and query starts with the contents of the `value` field.
- **URL_PART_ENDS_WITH:** Matches if the concatenation of request URL path and query ends with the contents of the `value` field.
- **URL_PART_CONTAINS:** Matches if the concatenation of request URL path and query contains the contents of the `value` field.
URLs must start with a `/`. URLs can't contain restricted double slashes `//`. URLs can't contain the restricted `'` `&` `?` symbols. Resources to cache can only be specified by a URL, any query parameters are ignored.
value
string / required
The value of the caching rule criteria.
is_client_caching_enabled
boolean
    Choices:
  • no
  • yes
Enables or disables client caching. Browsers use the `Cache-Control` header value for caching content locally in the browser. This setting overrides the addition of a `Cache-Control` header in responses.
key
string
The unique key for the caching rule.
name
string / required
The name of the caching rule.
captchas
list / elements=dictionary
A list of CAPTCHA challenge settings. CAPTCHAs challenge requests to ensure a human is attempting to reach the specified URL and not a bot.
failure_message
string / required
The text to show when incorrect CAPTCHA text is entered. If unspecified, defaults to `The CAPTCHA was incorrect. Try again.`
footer_text
string
The text to show in the footer when showing a CAPTCHA challenge. If unspecified, defaults to 'Enter the letters and numbers as they are shown in the image above.'
header_text
string
The text to show in the header when showing a CAPTCHA challenge. If unspecified, defaults to 'We have detected an increased number of attempts to access this website. To help us keep this site secure, please let us know that you are not a robot by entering the text from the image below.'
session_expiration_in_seconds
integer / required
The amount of time before the CAPTCHA expires, in seconds. If unspecified, defaults to `300`.
submit_label
string / required
The text to show on the label of the CAPTCHA challenge submit button. If unspecified, defaults to `Yes, I am human`.
title
string / required
The title used when displaying a CAPTCHA challenge. If unspecified, defaults to `Are you human?`
url
string / required
The unique URL path at which to show the CAPTCHA challenge.
custom_protection_rules
list / elements=dictionary
A list of the custom protection rule OCIDs and their actions.
action
string
    Choices:
  • DETECT
  • BLOCK
The action to take when the custom protection rule is triggered. `DETECT` - Logs the request when the criteria of the custom protection rule are met. `BLOCK` - Blocks the request when the criteria of the custom protection rule are met.
exclusions
list / elements=dictionary
exclusions
list / elements=string
target
string
    Choices:
  • REQUEST_COOKIES
  • REQUEST_COOKIE_NAMES
  • ARGS
  • ARGS_NAMES
The target of the exclusion.
id
string
The OCID of the custom protection rule.
device_fingerprint_challenge
dictionary
The device fingerprint challenge settings. Blocks bots based on unique device fingerprint information.
action
string
    Choices:
  • DETECT
  • BLOCK
The action to take on requests from detected bots. If unspecified, defaults to `DETECT`.
action_expiration_in_seconds
integer
The number of seconds between challenges for the same IP address. If unspecified, defaults to `60`.
challenge_settings
dictionary
block_action
string
    Choices:
  • SET_RESPONSE_CODE
  • SHOW_ERROR_PAGE
  • SHOW_CAPTCHA
The method used to block requests that fail the challenge, if `action` is set to `BLOCK`. If unspecified, defaults to `SHOW_ERROR_PAGE`.
block_error_page_code
string
The error code to show on the error page when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_ERROR_PAGE` and the request is blocked. If unspecified, defaults to `403`.
block_error_page_description
string
The description text to show on the error page when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_ERROR_PAGE`, and the request is blocked. If unspecified, defaults to `Access blocked by website owner. Please contact support.`
block_error_page_message
string
The message to show on the error page when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_ERROR_PAGE`, and the request is blocked. If unspecified, defaults to `Access to the website is blocked`.
block_response_code
integer
The response status code to return when `action` is set to `BLOCK`, `blockAction` is set to `SET_RESPONSE_CODE` or `SHOW_ERROR_PAGE`, and the request is blocked. If unspecified, defaults to `403`. The list of available response codes: `200`, `201`, `202`, `204`, `206`, `300`, `301`, `302`, `303`, `304`, `307`, `400`, `401`, `403`, `404`, `405`, `408`, `409`, `411`, `412`, `413`, `414`, `415`, `416`, `422`, `444`, `494`, `495`, `496`, `497`, `499`, `500`, `501`, `502`, `503`, `504`, `507`.
captcha_footer
string
The text to show in the footer when showing a CAPTCHA challenge when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_CAPTCHA`, and the request is blocked. If unspecified, default to `Enter the letters and numbers as they are shown in image above`.
captcha_header
string
The text to show in the header when showing a CAPTCHA challenge when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_CAPTCHA`, and the request is blocked. If unspecified, defaults to `We have detected an increased number of attempts to access this webapp. To help us keep this webapp secure, please let us know that you are not a robot by entering the text from captcha below.`
captcha_submit_label
string
The text to show on the label of the CAPTCHA challenge submit button when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_CAPTCHA`, and the request is blocked. If unspecified, defaults to `Yes, I am human`.
captcha_title
string
The title used when showing a CAPTCHA challenge when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_CAPTCHA`, and the request is blocked. If unspecified, defaults to `Are you human?`
failure_threshold
integer
The number of failed requests allowed before taking action. If unspecified, defaults to `10`.
failure_threshold_expiration_in_seconds
integer
The number of seconds before the failure threshold resets. If unspecified, defaults to `60`.
is_enabled
boolean / required
    Choices:
  • no
  • yes
Enables or disables the device fingerprint challenge Web Application Firewall feature.
max_address_count
integer
The maximum number of IP addresses permitted with the same device fingerprint. If unspecified, defaults to `20`.
max_address_count_expiration_in_seconds
integer
The number of seconds before the maximum addresses count resets. If unspecified, defaults to `60`.
good_bots
list / elements=dictionary
A list of bots allowed to access the web application.
description
string
The description of the bot.
This parameter is updatable.
is_enabled
boolean / required
    Choices:
  • no
  • yes
Enables or disables the bot.
This parameter is updatable.
key
string / required
The unique key for the bot.
This parameter is updatable.
name
string
The bot name.
This parameter is updatable.
human_interaction_challenge
dictionary
The human interaction challenge settings. Detects natural human interactions such as mouse movements, time on site, and page scrolling to identify bots.
action
string
    Choices:
  • DETECT
  • BLOCK
The action to take against requests from detected bots. If unspecified, defaults to `DETECT`.
action_expiration_in_seconds
integer
The number of seconds between challenges for the same IP address. If unspecified, defaults to `60`.
challenge_settings
dictionary
block_action
string
    Choices:
  • SET_RESPONSE_CODE
  • SHOW_ERROR_PAGE
  • SHOW_CAPTCHA
The method used to block requests that fail the challenge, if `action` is set to `BLOCK`. If unspecified, defaults to `SHOW_ERROR_PAGE`.
block_error_page_code
string
The error code to show on the error page when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_ERROR_PAGE` and the request is blocked. If unspecified, defaults to `403`.
block_error_page_description
string
The description text to show on the error page when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_ERROR_PAGE`, and the request is blocked. If unspecified, defaults to `Access blocked by website owner. Please contact support.`
block_error_page_message
string
The message to show on the error page when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_ERROR_PAGE`, and the request is blocked. If unspecified, defaults to `Access to the website is blocked`.
block_response_code
integer
The response status code to return when `action` is set to `BLOCK`, `blockAction` is set to `SET_RESPONSE_CODE` or `SHOW_ERROR_PAGE`, and the request is blocked. If unspecified, defaults to `403`. The list of available response codes: `200`, `201`, `202`, `204`, `206`, `300`, `301`, `302`, `303`, `304`, `307`, `400`, `401`, `403`, `404`, `405`, `408`, `409`, `411`, `412`, `413`, `414`, `415`, `416`, `422`, `444`, `494`, `495`, `496`, `497`, `499`, `500`, `501`, `502`, `503`, `504`, `507`.
captcha_footer
string
The text to show in the footer when showing a CAPTCHA challenge when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_CAPTCHA`, and the request is blocked. If unspecified, default to `Enter the letters and numbers as they are shown in image above`.
captcha_header
string
The text to show in the header when showing a CAPTCHA challenge when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_CAPTCHA`, and the request is blocked. If unspecified, defaults to `We have detected an increased number of attempts to access this webapp. To help us keep this webapp secure, please let us know that you are not a robot by entering the text from captcha below.`
captcha_submit_label
string
The text to show on the label of the CAPTCHA challenge submit button when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_CAPTCHA`, and the request is blocked. If unspecified, defaults to `Yes, I am human`.
captcha_title
string
The title used when showing a CAPTCHA challenge when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_CAPTCHA`, and the request is blocked. If unspecified, defaults to `Are you human?`
failure_threshold
integer
The number of failed requests before taking action. If unspecified, defaults to `10`.
failure_threshold_expiration_in_seconds
integer
The number of seconds before the failure threshold resets. If unspecified, defaults to `60`.
interaction_threshold
integer
The number of interactions required to pass the challenge. If unspecified, defaults to `3`.
is_enabled
boolean / required
    Choices:
  • no
  • yes
Enables or disables the human interaction challenge Web Application Firewall feature.
is_nat_enabled
boolean
    Choices:
  • no
  • yes
When enabled, the user is identified not only by the IP address but also by an unique additional hash, which prevents blocking visitors with shared IP addresses.
recording_period_in_seconds
integer
The number of seconds to record the interactions from the user. If unspecified, defaults to `15`.
set_http_header
dictionary
Adds an additional HTTP header to requests that fail the challenge before being passed to the origin. Only applicable when the `action` is set to `DETECT`.
name
string / required
The name of the header.
value
string / required
The value of the header.
js_challenge
dictionary
The JavaScript challenge settings. Blocks bots by challenging requests from browsers that have no JavaScript support.
action
string
    Choices:
  • DETECT
  • BLOCK
The action to take against requests from detected bots. If unspecified, defaults to `DETECT`.
action_expiration_in_seconds
integer
The number of seconds between challenges from the same IP address. If unspecified, defaults to `60`.
are_redirects_challenged
boolean
    Choices:
  • no
  • yes
When enabled, redirect responses from the origin will also be challenged. This will change HTTP 301/302 responses from origin to HTTP 200 with an HTML body containing JavaScript page redirection.
challenge_settings
dictionary
block_action
string
    Choices:
  • SET_RESPONSE_CODE
  • SHOW_ERROR_PAGE
  • SHOW_CAPTCHA
The method used to block requests that fail the challenge, if `action` is set to `BLOCK`. If unspecified, defaults to `SHOW_ERROR_PAGE`.
block_error_page_code
string
The error code to show on the error page when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_ERROR_PAGE` and the request is blocked. If unspecified, defaults to `403`.
block_error_page_description
string
The description text to show on the error page when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_ERROR_PAGE`, and the request is blocked. If unspecified, defaults to `Access blocked by website owner. Please contact support.`
block_error_page_message
string
The message to show on the error page when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_ERROR_PAGE`, and the request is blocked. If unspecified, defaults to `Access to the website is blocked`.
block_response_code
integer
The response status code to return when `action` is set to `BLOCK`, `blockAction` is set to `SET_RESPONSE_CODE` or `SHOW_ERROR_PAGE`, and the request is blocked. If unspecified, defaults to `403`. The list of available response codes: `200`, `201`, `202`, `204`, `206`, `300`, `301`, `302`, `303`, `304`, `307`, `400`, `401`, `403`, `404`, `405`, `408`, `409`, `411`, `412`, `413`, `414`, `415`, `416`, `422`, `444`, `494`, `495`, `496`, `497`, `499`, `500`, `501`, `502`, `503`, `504`, `507`.
captcha_footer
string
The text to show in the footer when showing a CAPTCHA challenge when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_CAPTCHA`, and the request is blocked. If unspecified, default to `Enter the letters and numbers as they are shown in image above`.
captcha_header
string
The text to show in the header when showing a CAPTCHA challenge when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_CAPTCHA`, and the request is blocked. If unspecified, defaults to `We have detected an increased number of attempts to access this webapp. To help us keep this webapp secure, please let us know that you are not a robot by entering the text from captcha below.`
captcha_submit_label
string
The text to show on the label of the CAPTCHA challenge submit button when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_CAPTCHA`, and the request is blocked. If unspecified, defaults to `Yes, I am human`.
captcha_title
string
The title used when showing a CAPTCHA challenge when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_CAPTCHA`, and the request is blocked. If unspecified, defaults to `Are you human?`
criteria
list / elements=dictionary
When defined, the JavaScript Challenge would be applied only for the requests that matched all the listed conditions.
condition
string / required
    Choices:
  • URL_IS
  • URL_IS_NOT
  • URL_STARTS_WITH
  • URL_PART_ENDS_WITH
  • URL_PART_CONTAINS
  • URL_REGEX
  • URL_DOES_NOT_MATCH_REGEX
  • URL_DOES_NOT_START_WITH
  • URL_PART_DOES_NOT_CONTAIN
  • URL_PART_DOES_NOT_END_WITH
  • IP_IS
  • IP_IS_NOT
  • IP_IN_LIST
  • IP_NOT_IN_LIST
  • HTTP_HEADER_CONTAINS
  • HTTP_METHOD_IS
  • HTTP_METHOD_IS_NOT
  • COUNTRY_IS
  • COUNTRY_IS_NOT
  • USER_AGENT_IS
  • USER_AGENT_IS_NOT
The criteria the access rule and JavaScript Challenge uses to determine if action should be taken on a request. - **URL_IS:** Matches if the concatenation of request URL path and query is identical to the contents of the `value` field. URL must start with a `/`. - **URL_IS_NOT:** Matches if the concatenation of request URL path and query is not identical to the contents of the `value` field. URL must start with a `/`. - **URL_STARTS_WITH:** Matches if the concatenation of request URL path and query starts with the contents of the `value` field. URL must start with a `/`. - **URL_PART_ENDS_WITH:** Matches if the concatenation of request URL path and query ends with the contents of the `value` field. - **URL_PART_CONTAINS:** Matches if the concatenation of request URL path and query contains the contents of the `value` field. - **URL_REGEX:** Matches if the concatenation of request URL path and query is described by the regular expression in the value field. The value must be a valid regular expression recognized by the PCRE library in Nginx (https://www.pcre.org). - **URL_DOES_NOT_MATCH_REGEX:** Matches if the concatenation of request URL path and query is not described by the regular expression in the `value` field. The value must be a valid regular expression recognized by the PCRE library in Nginx (https://www.pcre.org). - **URL_DOES_NOT_START_WITH:** Matches if the concatenation of request URL path and query does not start with the contents of the `value` field. - **URL_PART_DOES_NOT_CONTAIN:** Matches if the concatenation of request URL path and query does not contain the contents of the `value` field. - **URL_PART_DOES_NOT_END_WITH:** Matches if the concatenation of request URL path and query does not end with the contents of the `value` field. - **IP_IS:** Matches if the request originates from one of the IP addresses contained in the defined address list. The `value` in this case is string with one or multiple IPs or CIDR notations separated by new line symbol \n *Example:* "1.1.1.1\n1.1.1.2\n1.2.2.1/30" - **IP_IS_NOT:** Matches if the request does not originate from any of the IP addresses contained in the defined address list. The `value` in this case is string with one or multiple IPs or CIDR notations separated by new line symbol \n *Example:* "1.1.1.1\n1.1.1.2\n1.2.2.1/30" - **IP_IN_LIST:** Matches if the request originates from one of the IP addresses contained in the referenced address list. The `value` in this case is OCID of the address list. - **IP_NOT_IN_LIST:** Matches if the request does not originate from any IP address contained in the referenced address list. The `value` field in this case is OCID of the address list. - **HTTP_HEADER_CONTAINS:** The HTTP_HEADER_CONTAINS criteria is defined using a compound value separated by a colon: a header field name and a header field value. `host:test.example.com` is an example of a criteria value where `host` is the header field name and `test.example.com` is the header field value. A request matches when the header field name is a case insensitive match and the header field value is a case insensitive, substring match. *Example:* With a criteria value of `host:test.example.com`, where `host` is the name of the field and `test.example.com` is the value of the host field, a request with the header values, `Host: www.test.example.com` will match, where as a request with header values of `host: www.example.com` or `host: test.sub.example.com` will not match. - **HTTP_METHOD_IS:** Matches if the request method is identical to one of the values listed in field. The `value` in this case is string with one or multiple HTTP methods separated by new line symbol \n The list of available methods: `GET`, `HEAD`, `POST`, `PUT`, `DELETE`, `CONNECT`, `OPTIONS`, `TRACE`, `PATCH`
*Example:* "GET\nPOST"
- **HTTP_METHOD_IS_NOT:** Matches if the request is not identical to any of the contents of the `value` field. The `value` in this case is string with one or multiple HTTP methods separated by new line symbol \n The list of available methods: `GET`, `HEAD`, `POST`, `PUT`, `DELETE`, `CONNECT`, `OPTIONS`, `TRACE`, `PATCH`
*Example:* "GET\nPOST"
- **COUNTRY_IS:** Matches if the request originates from one of countries in the `value` field. The `value` in this case is string with one or multiple countries separated by new line symbol \n Country codes are in ISO 3166-1 alpha-2 format. For a list of codes, see ISO's website. *Example:* "AL\nDZ\nAM" - **COUNTRY_IS_NOT:** Matches if the request does not originate from any of countries in the `value` field. The `value` in this case is string with one or multiple countries separated by new line symbol \n Country codes are in ISO 3166-1 alpha-2 format. For a list of codes, see ISO's website. *Example:* "AL\nDZ\nAM" - **USER_AGENT_IS:** Matches if the requesting user agent is identical to the contents of the `value` field. *Example:* `Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:35.0) Gecko/20100101 Firefox/35.0` - **USER_AGENT_IS_NOT:** Matches if the requesting user agent is not identical to the contents of the `value` field. *Example:* `Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:35.0) Gecko/20100101 Firefox/35.0`
is_case_sensitive
boolean
    Choices:
  • no
  • yes
When enabled, the condition will be matched with case-sensitive rules.
value
string / required
The criteria value.
failure_threshold
integer
The number of failed requests before taking action. If unspecified, defaults to `10`.
is_enabled
boolean / required
    Choices:
  • no
  • yes
Enables or disables the JavaScript challenge Web Application Firewall feature.
is_nat_enabled
boolean
    Choices:
  • no
  • yes
When enabled, the user is identified not only by the IP address but also by an unique additional hash, which prevents blocking visitors with shared IP addresses.
set_http_header
dictionary
Adds an additional HTTP header to requests that fail the challenge before being passed to the origin. Only applicable when the `action` is set to `DETECT`.
name
string / required
The name of the header.
value
string / required
The value of the header.
origin
string
The key in the map of origins referencing the origin used for the Web Application Firewall. The origin must already be included in `Origins`. Required when creating the `WafConfig` resource, but is not required upon updating the configuration.
This parameter is updatable.
origin_groups
list / elements=string
The map of origin groups and their keys used to associate origins to the `wafConfig`. Origin groups allow you to apply weights to groups of origins for load balancing purposes. Origins with higher weights will receive larger proportions of client requests. To add additional origins to your WAAS policy, update the `origins` field of a `UpdateWaasPolicy` request.
This parameter is updatable.
protection_rules
list / elements=dictionary
A list of the protection rules and their details.
action
string
    Choices:
  • OFF
  • DETECT
  • BLOCK
The action to take when the traffic is detected as malicious. If unspecified, defaults to `OFF`.
This parameter is updatable.
description
string
The description of the protection rule.
This parameter is updatable.
exclusions
list / elements=dictionary
exclusions
list / elements=string
This parameter is updatable.
target
string
    Choices:
  • REQUEST_COOKIES
  • REQUEST_COOKIE_NAMES
  • ARGS
  • ARGS_NAMES
The target of the exclusion.
This parameter is updatable.
key
string
The unique key of the protection rule.
This parameter is updatable.
labels
list / elements=string
The list of labels for the protection rule.
**Note:** Protection rules with a `ResponseBody` label will have no effect unless `isResponseInspected` is true.
This parameter is updatable.
mod_security_rule_ids
list / elements=string
The list of the ModSecurity rule IDs that apply to this protection rule. For more information about ModSecurity's open source WAF rules, see Mod Security's documentation.
This parameter is updatable.
name
string
The name of the protection rule.
This parameter is updatable.
protection_settings
dictionary
The settings applied to protection rules.
allowed_http_methods
list / elements=string
    Choices:
  • OPTIONS
  • GET
  • HEAD
  • POST
  • PUT
  • DELETE
  • TRACE
  • CONNECT
  • PATCH
  • PROPFIND
The list of allowed HTTP methods. If unspecified, default to `[OPTIONS, GET, HEAD, POST]`. This setting only applies if a corresponding protection rule is enabled, such as the "Restrict HTTP Request Methods" rule (key: 911100).
block_action
string
    Choices:
  • SHOW_ERROR_PAGE
  • SET_RESPONSE_CODE
If `action` is set to `BLOCK`, this specifies how the traffic is blocked when detected as malicious by a protection rule. If unspecified, defaults to `SET_RESPONSE_CODE`.
block_error_page_code
string
The error code to show on the error page when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_ERROR_PAGE`, and the traffic is detected as malicious by a protection rule. If unspecified, defaults to `403`.
block_error_page_description
string
The description text to show on the error page when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_ERROR_PAGE`, and the traffic is detected as malicious by a protection rule. If unspecified, defaults to `Access blocked by website owner. Please contact support.`
block_error_page_message
string
The message to show on the error page when `action` is set to `BLOCK`, `blockAction` is set to `SHOW_ERROR_PAGE`, and the traffic is detected as malicious by a protection rule. If unspecified, defaults to 'Access to the website is blocked.'
block_response_code
integer
The response code returned when `action` is set to `BLOCK`, `blockAction` is set to `SET_RESPONSE_CODE`, and the traffic is detected as malicious by a protection rule. If unspecified, defaults to `403`. The list of available response codes: `400`, `401`, `403`, `405`, `409`, `411`, `412`, `413`, `414`, `415`, `416`, `500`, `501`, `502`, `503`, `504`, `507`.
is_response_inspected
boolean
    Choices:
  • no
  • yes
Inspects the response body of origin responses. Can be used to detect leakage of sensitive data. If unspecified, defaults to `false`.
**Note:** Only origin responses with a Content-Type matching a value in `mediaTypes` will be inspected.
max_argument_count
integer
The maximum number of arguments allowed to be passed to your application before an action is taken. Arguements are query parameters or body parameters in a PUT or POST request. If unspecified, defaults to `255`. This setting only applies if a corresponding protection rule is enabled, such as the "Number of Arguments Limits" rule (key: 960335).
Example: If `maxArgumentCount` to `2` for the Max Number of Arguments protection rule (key: 960335), the following requests would be blocked: `GET /myapp/path?query=one&query=two&query=three` `POST /myapp/path` with Body `{"argument1":"one","argument2":"two","argument3":"three"}`
max_name_length_per_argument
integer
The maximum length allowed for each argument name, in characters. Arguements are query parameters or body parameters in a PUT or POST request. If unspecified, defaults to `400`. This setting only applies if a corresponding protection rule is enabled, such as the "Values Limits" rule (key: 960208).
max_response_size_in_ki_b
integer
The maximum response size to be fully inspected, in binary kilobytes (KiB). Anything over this limit will be partially inspected. If unspecified, defaults to `1024`.
max_total_name_length_of_arguments
integer
The maximum length allowed for the sum of the argument name and value, in characters. Arguements are query parameters or body parameters in a PUT or POST request. If unspecified, defaults to `64000`. This setting only applies if a corresponding protection rule is enabled, such as the "Total Arguments Limits" rule (key: 960341).
media_types
list / elements=string
The list of media types to allow for inspection, if `isResponseInspected` is enabled. Only responses with MIME types in this list will be inspected. If unspecified, defaults to `["text/html", "text/plain", "text/xml"]`.
Supported MIME types include:
- text/html - text/plain - text/asp - text/css - text/x-script - application/json - text/webviewhtml - text/x-java-source - application/x-javascript - application/javascript - application/ecmascript - text/javascript - text/ecmascript - text/x-script.perl - text/x-script.phyton - application/plain - application/xml - text/xml
recommendations_period_in_days
integer
The length of time to analyze traffic traffic, in days. After the analysis period, `WafRecommendations` will be populated. If unspecified, defaults to `10`.
Use `GET /waasPolicies/{waasPolicyId}/wafRecommendations` to view WAF recommendations.
threat_feeds
list / elements=dictionary
A list of threat intelligence feeds and the actions to apply to known malicious traffic based on internet intelligence.
action
string
    Choices:
  • OFF
  • DETECT
  • BLOCK
The action to take when traffic is flagged as malicious by data from the threat intelligence feed. If unspecified, defaults to `OFF`.
This parameter is updatable.
description
string
The description of the threat intelligence feed.
This parameter is updatable.
key
string
The unique key of the threat intelligence feed.
This parameter is updatable.
name
string
The name of the threat intelligence feed.
This parameter is updatable.
whitelists
list / elements=dictionary
A list of IP addresses that bypass the Web Application Firewall.
address_lists
list / elements=string
A list of OCID of IP address lists to include in the whitelist.
addresses
list / elements=string
A set of IP addresses or CIDR notations to include in the whitelist.
name
string / required
The unique name of the whitelist.
wait
boolean
    Choices:
  • no
  • yes ←
Whether to wait for create or delete operation to complete.
wait_timeout
integer
Time, in seconds, to wait when wait=yes. Defaults to 1200 for most of the services but some services might have a longer wait timeout.

Examples

- name: Create waas_policy
  oci_waas_policy:
    # required
    compartment_id: "ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx"
    domain: domain_example

    # optional
    display_name: display_name_example
    additional_domains: [ "additional_domains_example" ]
    origins:
      # required
      uri: uri_example

      # optional
      http_port: 56
      https_port: 56
      custom_headers:
      - # required
        name: name_example
        value: value_example
    origin_groups:
      # optional
      origins:
      - # optional
        origin: origin_example
        weight: 56
    policy_config:
      # optional
      certificate_id: "ocid1.certificate.oc1..xxxxxxEXAMPLExxxxxx"
      is_https_enabled: true
      is_https_forced: true
      tls_protocols: [ "TLS_V1" ]
      is_origin_compression_enabled: true
      is_behind_cdn: true
      client_address_header: X_FORWARDED_FOR
      is_cache_control_respected: true
      is_response_buffering_enabled: true
      cipher_group: DEFAULT
      load_balancing_method:
        # required
        method: ROUND_ROBIN
      websocket_path_prefixes: [ "websocket_path_prefixes_example" ]
      is_sni_enabled: true
      health_checks:
        # optional
        is_enabled: true
        method: GET
        path: path_example
        headers: null
        expected_response_code_group: [ "2XX" ]
        is_response_text_check_enabled: true
        expected_response_text: expected_response_text_example
        interval_in_seconds: 56
        timeout_in_seconds: 56
        healthy_threshold: 56
        unhealthy_threshold: 56
    waf_config:
      # optional
      access_rules:
      - # required
        name: name_example
        criteria:
        - # required
          condition: URL_IS
          value: value_example

          # optional
          is_case_sensitive: true
        action: ALLOW

        # optional
        block_action: SET_RESPONSE_CODE
        block_response_code: 56
        block_error_page_message: block_error_page_message_example
        block_error_page_code: block_error_page_code_example
        block_error_page_description: block_error_page_description_example
        bypass_challenges: [ "JS_CHALLENGE" ]
        redirect_url: redirect_url_example
        redirect_response_code: MOVED_PERMANENTLY
        captcha_title: captcha_title_example
        captcha_header: captcha_header_example
        captcha_footer: captcha_footer_example
        captcha_submit_label: captcha_submit_label_example
        response_header_manipulation:
        - # required
          value: value_example
          action: EXTEND_HTTP_RESPONSE_HEADER
          header: header_example
      address_rate_limiting:
        # required
        is_enabled: true

        # optional
        allowed_rate_per_address: 56
        max_delayed_count_per_address: 56
        block_response_code: 56
      captchas:
      - # required
        url: url_example
        session_expiration_in_seconds: 56
        title: title_example
        failure_message: failure_message_example
        submit_label: submit_label_example

        # optional
        header_text: header_text_example
        footer_text: footer_text_example
      device_fingerprint_challenge:
        # required
        is_enabled: true

        # optional
        action: DETECT
        failure_threshold: 56
        action_expiration_in_seconds: 56
        failure_threshold_expiration_in_seconds: 56
        max_address_count: 56
        max_address_count_expiration_in_seconds: 56
        challenge_settings:
          # optional
          block_action: SET_RESPONSE_CODE
          block_response_code: 56
          block_error_page_message: block_error_page_message_example
          block_error_page_description: block_error_page_description_example
          block_error_page_code: block_error_page_code_example
          captcha_title: captcha_title_example
          captcha_header: captcha_header_example
          captcha_footer: captcha_footer_example
          captcha_submit_label: captcha_submit_label_example
      good_bots:
      - # required
        key: key_example
        is_enabled: true

        # optional
        name: name_example
        description: description_example
      human_interaction_challenge:
        # required
        is_enabled: true

        # optional
        action: DETECT
        failure_threshold: 56
        action_expiration_in_seconds: 56
        failure_threshold_expiration_in_seconds: 56
        interaction_threshold: 56
        recording_period_in_seconds: 56
        set_http_header:
          # required
          name: name_example
          value: value_example
        challenge_settings:
          # optional
          block_action: SET_RESPONSE_CODE
          block_response_code: 56
          block_error_page_message: block_error_page_message_example
          block_error_page_description: block_error_page_description_example
          block_error_page_code: block_error_page_code_example
          captcha_title: captcha_title_example
          captcha_header: captcha_header_example
          captcha_footer: captcha_footer_example
          captcha_submit_label: captcha_submit_label_example
        is_nat_enabled: true
      js_challenge:
        # required
        is_enabled: true

        # optional
        action: DETECT
        failure_threshold: 56
        action_expiration_in_seconds: 56
        set_http_header:
          # required
          name: name_example
          value: value_example
        challenge_settings:
          # optional
          block_action: SET_RESPONSE_CODE
          block_response_code: 56
          block_error_page_message: block_error_page_message_example
          block_error_page_description: block_error_page_description_example
          block_error_page_code: block_error_page_code_example
          captcha_title: captcha_title_example
          captcha_header: captcha_header_example
          captcha_footer: captcha_footer_example
          captcha_submit_label: captcha_submit_label_example
        are_redirects_challenged: true
        criteria:
        - # required
          condition: URL_IS
          value: value_example

          # optional
          is_case_sensitive: true
        is_nat_enabled: true
      origin: origin_example
      caching_rules:
      - # required
        name: name_example
        action: CACHE
        criteria:
        - # required
          condition: URL_IS
          value: value_example

        # optional
        key: key_example
        caching_duration: caching_duration_example
        is_client_caching_enabled: true
        client_caching_duration: client_caching_duration_example
      custom_protection_rules:
      - # optional
        id: "ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx"
        action: DETECT
        exclusions:
        - # optional
          target: REQUEST_COOKIES
          exclusions: [ "exclusions_example" ]
      origin_groups: [ "origin_groups_example" ]
      protection_rules:
      - # optional
        key: key_example
        mod_security_rule_ids: [ "mod_security_rule_ids_example" ]
        name: name_example
        description: description_example
        action: OFF
        labels: [ "labels_example" ]
        exclusions:
        - # optional
          target: REQUEST_COOKIES
          exclusions: [ "exclusions_example" ]
      protection_settings:
        # optional
        block_action: SHOW_ERROR_PAGE
        block_response_code: 56
        block_error_page_message: block_error_page_message_example
        block_error_page_code: block_error_page_code_example
        block_error_page_description: block_error_page_description_example
        max_argument_count: 56
        max_name_length_per_argument: 56
        max_total_name_length_of_arguments: 56
        recommendations_period_in_days: 56
        is_response_inspected: true
        max_response_size_in_ki_b: 56
        allowed_http_methods: [ "OPTIONS" ]
        media_types: [ "media_types_example" ]
      threat_feeds:
      - # optional
        key: key_example
        name: name_example
        action: OFF
        description: description_example
      whitelists:
      - # required
        name: name_example

        # optional
        addresses: [ "addresses_example" ]
        address_lists: [ "address_lists_example" ]
    freeform_tags: {'Department': 'Finance'}
    defined_tags: {'Operations': {'CostCenter': 'US'}}

- name: Update waas_policy
  oci_waas_policy:
    # required
    waas_policy_id: "ocid1.waaspolicy.oc1..xxxxxxEXAMPLExxxxxx"

    # optional
    display_name: display_name_example
    additional_domains: [ "additional_domains_example" ]
    origins:
      # required
      uri: uri_example

      # optional
      http_port: 56
      https_port: 56
      custom_headers:
      - # required
        name: name_example
        value: value_example
    origin_groups:
      # optional
      origins:
      - # optional
        origin: origin_example
        weight: 56
    policy_config:
      # optional
      certificate_id: "ocid1.certificate.oc1..xxxxxxEXAMPLExxxxxx"
      is_https_enabled: true
      is_https_forced: true
      tls_protocols: [ "TLS_V1" ]
      is_origin_compression_enabled: true
      is_behind_cdn: true
      client_address_header: X_FORWARDED_FOR
      is_cache_control_respected: true
      is_response_buffering_enabled: true
      cipher_group: DEFAULT
      load_balancing_method:
        # required
        method: ROUND_ROBIN
      websocket_path_prefixes: [ "websocket_path_prefixes_example" ]
      is_sni_enabled: true
      health_checks:
        # optional
        is_enabled: true
        method: GET
        path: path_example
        headers: null
        expected_response_code_group: [ "2XX" ]
        is_response_text_check_enabled: true
        expected_response_text: expected_response_text_example
        interval_in_seconds: 56
        timeout_in_seconds: 56
        healthy_threshold: 56
        unhealthy_threshold: 56
    waf_config:
      # optional
      access_rules:
      - # required
        name: name_example
        criteria:
        - # required
          condition: URL_IS
          value: value_example

          # optional
          is_case_sensitive: true
        action: ALLOW

        # optional
        block_action: SET_RESPONSE_CODE
        block_response_code: 56
        block_error_page_message: block_error_page_message_example
        block_error_page_code: block_error_page_code_example
        block_error_page_description: block_error_page_description_example
        bypass_challenges: [ "JS_CHALLENGE" ]
        redirect_url: redirect_url_example
        redirect_response_code: MOVED_PERMANENTLY
        captcha_title: captcha_title_example
        captcha_header: captcha_header_example
        captcha_footer: captcha_footer_example
        captcha_submit_label: captcha_submit_label_example
        response_header_manipulation:
        - # required
          value: value_example
          action: EXTEND_HTTP_RESPONSE_HEADER
          header: header_example
      address_rate_limiting:
        # required
        is_enabled: true

        # optional
        allowed_rate_per_address: 56
        max_delayed_count_per_address: 56
        block_response_code: 56
      captchas:
      - # required
        url: url_example
        session_expiration_in_seconds: 56
        title: title_example
        failure_message: failure_message_example
        submit_label: submit_label_example

        # optional
        header_text: header_text_example
        footer_text: footer_text_example
      device_fingerprint_challenge:
        # required
        is_enabled: true

        # optional
        action: DETECT
        failure_threshold: 56
        action_expiration_in_seconds: 56
        failure_threshold_expiration_in_seconds: 56
        max_address_count: 56
        max_address_count_expiration_in_seconds: 56
        challenge_settings:
          # optional
          block_action: SET_RESPONSE_CODE
          block_response_code: 56
          block_error_page_message: block_error_page_message_example
          block_error_page_description: block_error_page_description_example
          block_error_page_code: block_error_page_code_example
          captcha_title: captcha_title_example
          captcha_header: captcha_header_example
          captcha_footer: captcha_footer_example
          captcha_submit_label: captcha_submit_label_example
      good_bots:
      - # required
        key: key_example
        is_enabled: true

        # optional
        name: name_example
        description: description_example
      human_interaction_challenge:
        # required
        is_enabled: true

        # optional
        action: DETECT
        failure_threshold: 56
        action_expiration_in_seconds: 56
        failure_threshold_expiration_in_seconds: 56
        interaction_threshold: 56
        recording_period_in_seconds: 56
        set_http_header:
          # required
          name: name_example
          value: value_example
        challenge_settings:
          # optional
          block_action: SET_RESPONSE_CODE
          block_response_code: 56
          block_error_page_message: block_error_page_message_example
          block_error_page_description: block_error_page_description_example
          block_error_page_code: block_error_page_code_example
          captcha_title: captcha_title_example
          captcha_header: captcha_header_example
          captcha_footer: captcha_footer_example
          captcha_submit_label: captcha_submit_label_example
        is_nat_enabled: true
      js_challenge:
        # required
        is_enabled: true

        # optional
        action: DETECT
        failure_threshold: 56
        action_expiration_in_seconds: 56
        set_http_header:
          # required
          name: name_example
          value: value_example
        challenge_settings:
          # optional
          block_action: SET_RESPONSE_CODE
          block_response_code: 56
          block_error_page_message: block_error_page_message_example
          block_error_page_description: block_error_page_description_example
          block_error_page_code: block_error_page_code_example
          captcha_title: captcha_title_example
          captcha_header: captcha_header_example
          captcha_footer: captcha_footer_example
          captcha_submit_label: captcha_submit_label_example
        are_redirects_challenged: true
        criteria:
        - # required
          condition: URL_IS
          value: value_example

          # optional
          is_case_sensitive: true
        is_nat_enabled: true
      origin: origin_example
      caching_rules:
      - # required
        name: name_example
        action: CACHE
        criteria:
        - # required
          condition: URL_IS
          value: value_example

        # optional
        key: key_example
        caching_duration: caching_duration_example
        is_client_caching_enabled: true
        client_caching_duration: client_caching_duration_example
      custom_protection_rules:
      - # optional
        id: "ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx"
        action: DETECT
        exclusions:
        - # optional
          target: REQUEST_COOKIES
          exclusions: [ "exclusions_example" ]
      origin_groups: [ "origin_groups_example" ]
      protection_rules:
      - # optional
        key: key_example
        mod_security_rule_ids: [ "mod_security_rule_ids_example" ]
        name: name_example
        description: description_example
        action: OFF
        labels: [ "labels_example" ]
        exclusions:
        - # optional
          target: REQUEST_COOKIES
          exclusions: [ "exclusions_example" ]
      protection_settings:
        # optional
        block_action: SHOW_ERROR_PAGE
        block_response_code: 56
        block_error_page_message: block_error_page_message_example
        block_error_page_code: block_error_page_code_example
        block_error_page_description: block_error_page_description_example
        max_argument_count: 56
        max_name_length_per_argument: 56
        max_total_name_length_of_arguments: 56
        recommendations_period_in_days: 56
        is_response_inspected: true
        max_response_size_in_ki_b: 56
        allowed_http_methods: [ "OPTIONS" ]
        media_types: [ "media_types_example" ]
      threat_feeds:
      - # optional
        key: key_example
        name: name_example
        action: OFF
        description: description_example
      whitelists:
      - # required
        name: name_example

        # optional
        addresses: [ "addresses_example" ]
        address_lists: [ "address_lists_example" ]
    freeform_tags: {'Department': 'Finance'}
    defined_tags: {'Operations': {'CostCenter': 'US'}}

- name: Update waas_policy using name (when environment variable OCI_USE_NAME_AS_IDENTIFIER is set)
  oci_waas_policy:
    # required
    compartment_id: "ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx"
    display_name: display_name_example

    # optional
    additional_domains: [ "additional_domains_example" ]
    origins:
      # required
      uri: uri_example

      # optional
      http_port: 56
      https_port: 56
      custom_headers:
      - # required
        name: name_example
        value: value_example
    origin_groups:
      # optional
      origins:
      - # optional
        origin: origin_example
        weight: 56
    policy_config:
      # optional
      certificate_id: "ocid1.certificate.oc1..xxxxxxEXAMPLExxxxxx"
      is_https_enabled: true
      is_https_forced: true
      tls_protocols: [ "TLS_V1" ]
      is_origin_compression_enabled: true
      is_behind_cdn: true
      client_address_header: X_FORWARDED_FOR
      is_cache_control_respected: true
      is_response_buffering_enabled: true
      cipher_group: DEFAULT
      load_balancing_method:
        # required
        method: ROUND_ROBIN
      websocket_path_prefixes: [ "websocket_path_prefixes_example" ]
      is_sni_enabled: true
      health_checks:
        # optional
        is_enabled: true
        method: GET
        path: path_example
        headers: null
        expected_response_code_group: [ "2XX" ]
        is_response_text_check_enabled: true
        expected_response_text: expected_response_text_example
        interval_in_seconds: 56
        timeout_in_seconds: 56
        healthy_threshold: 56
        unhealthy_threshold: 56
    waf_config:
      # optional
      access_rules:
      - # required
        name: name_example
        criteria:
        - # required
          condition: URL_IS
          value: value_example

          # optional
          is_case_sensitive: true
        action: ALLOW

        # optional
        block_action: SET_RESPONSE_CODE
        block_response_code: 56
        block_error_page_message: block_error_page_message_example
        block_error_page_code: block_error_page_code_example
        block_error_page_description: block_error_page_description_example
        bypass_challenges: [ "JS_CHALLENGE" ]
        redirect_url: redirect_url_example
        redirect_response_code: MOVED_PERMANENTLY
        captcha_title: captcha_title_example
        captcha_header: captcha_header_example
        captcha_footer: captcha_footer_example
        captcha_submit_label: captcha_submit_label_example
        response_header_manipulation:
        - # required
          value: value_example
          action: EXTEND_HTTP_RESPONSE_HEADER
          header: header_example
      address_rate_limiting:
        # required
        is_enabled: true

        # optional
        allowed_rate_per_address: 56
        max_delayed_count_per_address: 56
        block_response_code: 56
      captchas:
      - # required
        url: url_example
        session_expiration_in_seconds: 56
        title: title_example
        failure_message: failure_message_example
        submit_label: submit_label_example

        # optional
        header_text: header_text_example
        footer_text: footer_text_example
      device_fingerprint_challenge:
        # required
        is_enabled: true

        # optional
        action: DETECT
        failure_threshold: 56
        action_expiration_in_seconds: 56
        failure_threshold_expiration_in_seconds: 56
        max_address_count: 56
        max_address_count_expiration_in_seconds: 56
        challenge_settings:
          # optional
          block_action: SET_RESPONSE_CODE
          block_response_code: 56
          block_error_page_message: block_error_page_message_example
          block_error_page_description: block_error_page_description_example
          block_error_page_code: block_error_page_code_example
          captcha_title: captcha_title_example
          captcha_header: captcha_header_example
          captcha_footer: captcha_footer_example
          captcha_submit_label: captcha_submit_label_example
      good_bots:
      - # required
        key: key_example
        is_enabled: true

        # optional
        name: name_example
        description: description_example
      human_interaction_challenge:
        # required
        is_enabled: true

        # optional
        action: DETECT
        failure_threshold: 56
        action_expiration_in_seconds: 56
        failure_threshold_expiration_in_seconds: 56
        interaction_threshold: 56
        recording_period_in_seconds: 56
        set_http_header:
          # required
          name: name_example
          value: value_example
        challenge_settings:
          # optional
          block_action: SET_RESPONSE_CODE
          block_response_code: 56
          block_error_page_message: block_error_page_message_example
          block_error_page_description: block_error_page_description_example
          block_error_page_code: block_error_page_code_example
          captcha_title: captcha_title_example
          captcha_header: captcha_header_example
          captcha_footer: captcha_footer_example
          captcha_submit_label: captcha_submit_label_example
        is_nat_enabled: true
      js_challenge:
        # required
        is_enabled: true

        # optional
        action: DETECT
        failure_threshold: 56
        action_expiration_in_seconds: 56
        set_http_header:
          # required
          name: name_example
          value: value_example
        challenge_settings:
          # optional
          block_action: SET_RESPONSE_CODE
          block_response_code: 56
          block_error_page_message: block_error_page_message_example
          block_error_page_description: block_error_page_description_example
          block_error_page_code: block_error_page_code_example
          captcha_title: captcha_title_example
          captcha_header: captcha_header_example
          captcha_footer: captcha_footer_example
          captcha_submit_label: captcha_submit_label_example
        are_redirects_challenged: true
        criteria:
        - # required
          condition: URL_IS
          value: value_example

          # optional
          is_case_sensitive: true
        is_nat_enabled: true
      origin: origin_example
      caching_rules:
      - # required
        name: name_example
        action: CACHE
        criteria:
        - # required
          condition: URL_IS
          value: value_example

        # optional
        key: key_example
        caching_duration: caching_duration_example
        is_client_caching_enabled: true
        client_caching_duration: client_caching_duration_example
      custom_protection_rules:
      - # optional
        id: "ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx"
        action: DETECT
        exclusions:
        - # optional
          target: REQUEST_COOKIES
          exclusions: [ "exclusions_example" ]
      origin_groups: [ "origin_groups_example" ]
      protection_rules:
      - # optional
        key: key_example
        mod_security_rule_ids: [ "mod_security_rule_ids_example" ]
        name: name_example
        description: description_example
        action: OFF
        labels: [ "labels_example" ]
        exclusions:
        - # optional
          target: REQUEST_COOKIES
          exclusions: [ "exclusions_example" ]
      protection_settings:
        # optional
        block_action: SHOW_ERROR_PAGE
        block_response_code: 56
        block_error_page_message: block_error_page_message_example
        block_error_page_code: block_error_page_code_example
        block_error_page_description: block_error_page_description_example
        max_argument_count: 56
        max_name_length_per_argument: 56
        max_total_name_length_of_arguments: 56
        recommendations_period_in_days: 56
        is_response_inspected: true
        max_response_size_in_ki_b: 56
        allowed_http_methods: [ "OPTIONS" ]
        media_types: [ "media_types_example" ]
      threat_feeds:
      - # optional
        key: key_example
        name: name_example
        action: OFF
        description: description_example
      whitelists:
      - # required
        name: name_example

        # optional
        addresses: [ "addresses_example" ]
        address_lists: [ "address_lists_example" ]
    freeform_tags: {'Department': 'Finance'}
    defined_tags: {'Operations': {'CostCenter': 'US'}}

- name: Delete waas_policy
  oci_waas_policy:
    # required
    waas_policy_id: "ocid1.waaspolicy.oc1..xxxxxxEXAMPLExxxxxx"
    state: absent

- name: Delete waas_policy using name (when environment variable OCI_USE_NAME_AS_IDENTIFIER is set)
  oci_waas_policy:
    # required
    compartment_id: "ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx"
    display_name: display_name_example
    state: absent

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
waas_policy
complex
on success
Details of the WaasPolicy resource acted upon by the current operation

Sample:
{'additional_domains': [], 'cname': 'cname_example', 'compartment_id': 'ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx', 'defined_tags': {'Operations': {'CostCenter': 'US'}}, 'display_name': 'display_name_example', 'domain': 'domain_example', 'freeform_tags': {'Department': 'Finance'}, 'id': 'ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx', 'lifecycle_state': 'CREATING', 'origin_groups': {'origins': [{'origin': 'origin_example', 'weight': 56}]}, 'origins': {'custom_headers': [{'name': 'name_example', 'value': 'value_example'}], 'http_port': 56, 'https_port': 56, 'uri': 'uri_example'}, 'policy_config': {'certificate_id': 'ocid1.certificate.oc1..xxxxxxEXAMPLExxxxxx', 'cipher_group': 'DEFAULT', 'client_address_header': 'X_FORWARDED_FOR', 'health_checks': {'expected_response_code_group': [], 'expected_response_text': 'expected_response_text_example', 'headers': {}, 'healthy_threshold': 56, 'interval_in_seconds': 56, 'is_enabled': True, 'is_response_text_check_enabled': True, 'method': 'GET', 'path': 'path_example', 'timeout_in_seconds': 56, 'unhealthy_threshold': 56}, 'is_behind_cdn': True, 'is_cache_control_respected': True, 'is_https_enabled': True, 'is_https_forced': True, 'is_origin_compression_enabled': True, 'is_response_buffering_enabled': True, 'is_sni_enabled': True, 'load_balancing_method': {'domain': 'domain_example', 'expiration_time_in_seconds': 56, 'method': 'IP_HASH', 'name': 'name_example'}, 'tls_protocols': [], 'websocket_path_prefixes': []}, 'time_created': '2013-10-20T19:20:30+01:00', 'waf_config': {'access_rules': [{'action': 'ALLOW', 'block_action': 'SET_RESPONSE_CODE', 'block_error_page_code': 'block_error_page_code_example', 'block_error_page_description': 'block_error_page_description_example', 'block_error_page_message': 'block_error_page_message_example', 'block_response_code': 56, 'bypass_challenges': [], 'captcha_footer': 'captcha_footer_example', 'captcha_header': 'captcha_header_example', 'captcha_submit_label': 'captcha_submit_label_example', 'captcha_title': 'captcha_title_example', 'criteria': [{'condition': 'URL_IS', 'is_case_sensitive': True, 'value': 'value_example'}], 'name': 'name_example', 'redirect_response_code': 'MOVED_PERMANENTLY', 'redirect_url': 'redirect_url_example', 'response_header_manipulation': [{'action': 'EXTEND_HTTP_RESPONSE_HEADER', 'header': 'header_example', 'value': 'value_example'}]}], 'address_rate_limiting': {'allowed_rate_per_address': 56, 'block_response_code': 56, 'is_enabled': True, 'max_delayed_count_per_address': 56}, 'caching_rules': [{'action': 'CACHE', 'caching_duration': 'caching_duration_example', 'client_caching_duration': 'client_caching_duration_example', 'criteria': [{'condition': 'URL_IS', 'value': 'value_example'}], 'is_client_caching_enabled': True, 'key': 'key_example', 'name': 'name_example'}], 'captchas': [{'failure_message': 'failure_message_example', 'footer_text': 'footer_text_example', 'header_text': 'header_text_example', 'session_expiration_in_seconds': 56, 'submit_label': 'submit_label_example', 'title': 'title_example', 'url': 'url_example'}], 'custom_protection_rules': [{'action': 'DETECT', 'exclusions': [{'exclusions': [], 'target': 'REQUEST_COOKIES'}], 'id': 'ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx'}], 'device_fingerprint_challenge': {'action': 'DETECT', 'action_expiration_in_seconds': 56, 'challenge_settings': {'block_action': 'SET_RESPONSE_CODE', 'block_error_page_code': 'block_error_page_code_example', 'block_error_page_description': 'block_error_page_description_example', 'block_error_page_message': 'block_error_page_message_example', 'block_response_code': 56, 'captcha_footer': 'captcha_footer_example', 'captcha_header': 'captcha_header_example', 'captcha_submit_label': 'captcha_submit_label_example', 'captcha_title': 'captcha_title_example'}, 'failure_threshold': 56, 'failure_threshold_expiration_in_seconds': 56, 'is_enabled': True, 'max_address_count': 56, 'max_address_count_expiration_in_seconds': 56}, 'good_bots': [{'description': 'description_example', 'is_enabled': True, 'key': 'key_example', 'name': 'name_example'}], 'human_interaction_challenge': {'action': 'DETECT', 'action_expiration_in_seconds': 56, 'challenge_settings': {'block_action': 'SET_RESPONSE_CODE', 'block_error_page_code': 'block_error_page_code_example', 'block_error_page_description': 'block_error_page_description_example', 'block_error_page_message': 'block_error_page_message_example', 'block_response_code': 56, 'captcha_footer': 'captcha_footer_example', 'captcha_header': 'captcha_header_example', 'captcha_submit_label': 'captcha_submit_label_example', 'captcha_title': 'captcha_title_example'}, 'failure_threshold': 56, 'failure_threshold_expiration_in_seconds': 56, 'interaction_threshold': 56, 'is_enabled': True, 'is_nat_enabled': True, 'recording_period_in_seconds': 56, 'set_http_header': {'name': 'name_example', 'value': 'value_example'}}, 'js_challenge': {'action': 'DETECT', 'action_expiration_in_seconds': 56, 'are_redirects_challenged': True, 'challenge_settings': {'block_action': 'SET_RESPONSE_CODE', 'block_error_page_code': 'block_error_page_code_example', 'block_error_page_description': 'block_error_page_description_example', 'block_error_page_message': 'block_error_page_message_example', 'block_response_code': 56, 'captcha_footer': 'captcha_footer_example', 'captcha_header': 'captcha_header_example', 'captcha_submit_label': 'captcha_submit_label_example', 'captcha_title': 'captcha_title_example'}, 'criteria': [{'condition': 'URL_IS', 'is_case_sensitive': True, 'value': 'value_example'}], 'failure_threshold': 56, 'is_enabled': True, 'is_nat_enabled': True, 'set_http_header': {'name': 'name_example', 'value': 'value_example'}}, 'origin': 'origin_example', 'origin_groups': [], 'protection_rules': [{'action': 'OFF', 'description': 'description_example', 'exclusions': [{'exclusions': [], 'target': 'REQUEST_COOKIES'}], 'key': 'key_example', 'labels': [], 'mod_security_rule_ids': [], 'name': 'name_example'}], 'protection_settings': {'allowed_http_methods': [], 'block_action': 'SHOW_ERROR_PAGE', 'block_error_page_code': 'block_error_page_code_example', 'block_error_page_description': 'block_error_page_description_example', 'block_error_page_message': 'block_error_page_message_example', 'block_response_code': 56, 'is_response_inspected': True, 'max_argument_count': 56, 'max_name_length_per_argument': 56, 'max_response_size_in_ki_b': 56, 'max_total_name_length_of_arguments': 56, 'media_types': [], 'recommendations_period_in_days': 56}, 'threat_feeds': [{'action': 'OFF', 'description': 'description_example', 'key': 'key_example', 'name': 'name_example'}], 'whitelists': [{'address_lists': [], 'addresses': [], 'name': 'name_example'}]}}
 
additional_domains
list / elements=string
on success
An array of additional domains for this web application.

 
cname
string
on success
The CNAME record to add to your DNS configuration to route traffic for the domain, and all additional domains, through the WAF.

Sample:
cname_example
 
compartment_id
string
on success
The OCID of the WAAS policy's compartment.

Sample:
ocid1.compartment.oc1..xxxxxxEXAMPLExxxxxx
 
defined_tags
dictionary
on success
Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags.
Example: `{"Operations": {"CostCenter": "42"}}`

Sample:
{'Operations': {'CostCenter': 'US'}}
 
display_name
string
on success
The user-friendly name of the WAAS policy. The name can be changed and does not need to be unique.

Sample:
display_name_example
 
domain
string
on success
The web application domain that the WAAS policy protects.

Sample:
domain_example
 
freeform_tags
dictionary
on success
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags.
Example: `{"Department": "Finance"}`

Sample:
{'Department': 'Finance'}
 
id
string
on success
The OCID of the WAAS policy.

Sample:
ocid1.resource.oc1..xxxxxxEXAMPLExxxxxx
 
lifecycle_state
string
on success
The current lifecycle state of the WAAS policy.

Sample:
CREATING
 
origin_groups
complex
on success
The map of origin groups and their keys used to associate origins to the `wafConfig`. Origin groups allow you to apply weights to groups of origins for load balancing purposes. Origins with higher weights will receive larger proportions of client requests.

   
origins
complex
on success
The list of objects containing origin references and additional properties.

     
origin
string
on success
The IP address or CIDR notation of the origin server.

Sample:
origin_example
     
weight
integer
on success
The weight of the origin used in load balancing. Origins with higher weights will receive larger proportions of client requests.

Sample:
56
 
origins
complex
on success
A map of host servers (origins) and their keys for the web application. Origin keys are used to associate origins to specific protection rules. The key should be a user-friendly name for the host. **Examples:** `primary` or `secondary`.

   
custom_headers
complex
on success
A list of HTTP headers to forward to your origin.

     
name
string
on success
The name of the header.

Sample:
name_example
     
value
string
on success
The value of the header.

Sample:
value_example
   
http_port
integer
on success
The HTTP port on the origin that the web application listens on. If unspecified, defaults to `80`. If `0` is specified - the origin is not used for HTTP traffic.

Sample:
56
   
https_port
integer
on success
The HTTPS port on the origin that the web application listens on. If unspecified, defaults to `443`. If `0` is specified - the origin is not used for HTTPS traffic.

Sample:
56
   
uri
string
on success
The URI of the origin. Does not support paths. Port numbers should be specified in the `httpPort` and `httpsPort` fields.

Sample:
uri_example
 
policy_config
complex
on success

   
certificate_id
string
on success
The OCID of the SSL certificate to use if HTTPS is supported.

Sample:
ocid1.certificate.oc1..xxxxxxEXAMPLExxxxxx
   
cipher_group
string
on success
The set cipher group for the configured TLS protocol. This sets the configuration for the TLS connections between clients and edge nodes only. - **DEFAULT:** Cipher group supports TLS 1.0, TLS 1.1, TLS 1.2, TLS 1.3 protocols. It has the following ciphers enabled: `ECDHE-RSA- AES128-GCM-SHA256:ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES256-GCM-SHA384:DHE-RSA-AES128-GCM- SHA256:DHE-DSS-AES128-GCM-SHA256:kEDH+AESGCM:ECDHE-RSA-AES128-SHA256:ECDHE-ECDSA-AES128-SHA256:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA- AES128-SHA:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-RSA-AES128-SHA256:DHE- RSA-AES128-SHA:DHE-DSS-AES128-SHA256:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:AES128-GCM-SHA256:AES256-GCM- SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA:AES256-SHA:AES:CAMELLIA:!DES- CBC3-SHA:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!aECDH:!EDH-DSS-DES-CBC3-SHA:!EDH-RSA-DES-CBC3-SHA:!KRB5-DES-CBC3-SHA`

Sample:
DEFAULT
   
client_address_header
string
on success
Specifies an HTTP header name which is treated as the connecting client's IP address. Applicable only if `isBehindCdn` is enabled.
The edge node reads this header and its value and sets the client IP address as specified. It does not create the header if the header is not present in the request. If the header is not present, the connecting IP address will be used as the client's true IP address. It uses the last IP address in the header's value as the true IP address.
Example: `X-Client-Ip: 11.1.1.1, 13.3.3.3`
In the case of multiple headers with the same name, only the first header will be used. It is assumed that CDN sets the correct client IP address to prevent spoofing.
- **X_FORWARDED_FOR:** Corresponds to `X-Forwarded-For` header name.
- **X_CLIENT_IP:** Corresponds to `X-Client-Ip` header name.
- **X_REAL_IP:** Corresponds to `X-Real-Ip` header name.
- **CLIENT_IP:** Corresponds to `Client-Ip` header name.
- **TRUE_CLIENT_IP:** Corresponds to `True-Client-Ip` header name.

Sample:
X_FORWARDED_FOR
   
health_checks
complex
on success

     
expected_response_code_group
list / elements=string
on success
The HTTP response codes that signify a healthy state. - **2XX:** Success response code group. - **3XX:** Redirection response code group. - **4XX:** Client errors response code group. - **5XX:** Server errors response code group.

     
expected_response_text
string
on success
Health check will search for the given text in a case-sensitive manner within the response body and will fail if the text is not found.

Sample:
expected_response_text_example
     
headers
dictionary
on success
HTTP header fields to include in health check requests, expressed as `"name": "value"` properties. Because HTTP header field names are case-insensitive, any use of names that are case-insensitive equal to other names will be rejected. If Host is not specified, requests will include a Host header field with value matching the policy's protected domain. If User- Agent is not specified, requests will include a User-Agent header field with value "waf health checks".
**Note:** The only currently-supported header fields are Host and User-Agent.

     
healthy_threshold
integer
on success
Number of successful health checks after which the server is marked up.

Sample:
56
     
interval_in_seconds
integer
on success
Time between health checks of an individual origin server, in seconds.

Sample:
56
     
is_enabled
boolean
on success
Enables or disables the health checks.

Sample:
True
     
is_response_text_check_enabled
boolean
on success
Enables or disables additional check for predefined text in addition to response code.

Sample:
True
     
method
string
on success
An HTTP verb (i.e. HEAD, GET, or POST) to use when performing the health check.

Sample:
GET
     
path
string
on success
Path to visit on your origins when performing the health check.

Sample:
path_example
     
timeout_in_seconds
integer
on success
Response timeout represents wait time until request is considered failed, in seconds.

Sample:
56
     
unhealthy_threshold
integer
on success
Number of failed health checks after which the server is marked down.

Sample:
56
   
is_behind_cdn
boolean
on success
Enabling `isBehindCdn` allows for the collection of IP addresses from client requests if the WAF is connected to a CDN.

Sample:
True
   
is_cache_control_respected
boolean
on success
Enable or disable automatic content caching based on the response `cache-control` header. This feature enables the origin to act as a proxy cache. Caching is usually defined using `cache-control` header. For example `cache-control: max-age=120` means that the returned resource is valid for 120 seconds. Caching rules will overwrite this setting.

Sample:
True
   
is_https_enabled
boolean
on success
Enable or disable HTTPS support. If true, a `certificateId` is required. If unspecified, defaults to `false`.

Sample:
True
   
is_https_forced
boolean
on success
Force HTTP to HTTPS redirection. If unspecified, defaults to `false`.

Sample:
True
   
is_origin_compression_enabled
boolean
on success
Enable or disable GZIP compression of origin responses. If enabled, the header `Accept-Encoding: gzip` is sent to origin, otherwise, the empty `Accept-Encoding:` header is used.

Sample:
True
   
is_response_buffering_enabled
boolean
on success
Enable or disable buffering of responses from the origin. Buffering improves overall stability in case of network issues, but slightly increases Time To First Byte.

Sample:
True
   
is_sni_enabled
boolean
on success
SNI stands for Server Name Indication and is an extension of the TLS protocol. It indicates which hostname is being contacted by the browser at the beginning of the 'handshake'-process. This allows a server to connect multiple SSL Certificates to one IP address and port.

Sample:
True
   
load_balancing_method
complex
on success
An object that represents a load balancing method and its properties.

     
domain
string
on success
The domain for which the cookie is set, defaults to WAAS policy domain.

Sample:
domain_example
     
expiration_time_in_seconds
integer
on success
The time for which a browser should keep the cookie in seconds. Empty value will cause the cookie to expire at the end of a browser session.

Sample:
56
     
method
string
on success
Load balancing methods are algorithms used to efficiently distribute traffic among origin servers.
- **IP_HASH:** All the incoming requests from the same client IP address should go to the same content origination server. IP_HASH load balancing method uses origin weights when choosing which origin should the hash be assigned to initially.
- **ROUND_ROBIN:** Forwards requests sequentially to the available origin servers. The first request - to the first origin server, the second request - to the next origin server, and so on. After it sends a request to the last origin server, it starts again with the first origin server. When using weights on origins, Weighted Round Robin assigns more requests to origins with a greater weight. Over a period of time, origins will receive a number of requests in proportion to their weight.
- **STICKY_COOKIE:** Adds a session cookie to the first response from the origin server and identifies the server that sent the response. The client's next request contains the cookie value, and nginx routes the request to the origin server that responded to the first request. STICKY_COOKIE load balancing method falls back to Round Robin for the first request.

Sample:
IP_HASH
     
name
string
on success
The name of the cookie used to track the persistence. Can contain any US-ASCII character except separator or control character.

Sample: