ltm rule command BOTDEFENSE cookie status

iRule(1)		      BIG-IP TMSH Manual		      iRule(1)



BOTDEFENSE::cookie_status
       Returns the status of the Bot Defense cookie.

SYNOPSIS
       BOTDEFENSE::cookie_status

DESCRIPTION
       Returns the status of the Bot Defense cookie that is received on the
       request. The returned value is one of the following strings:
	   * not_received - the cookie did not appear in the request
	   * valid - the cookie is valid and not expired
	   * invalid - the cookie cannot be parsed; this could mean that it
       was modified by an attacker, or that it is older than two days, or due
       to a configuration change
	   * expired - the cookie is valid, but is expired
	   * valid_redirect_challenge - the cookie of the redirect was
       validated

       Syntax

       BOTDEFENSE::cookie_status

RETURN VALUE
       A string signifying the status of the Bot Defense cookie.

VALID DURING
       BOTDEFENSE_REQUEST, BOTDEFENSE_ACTION

EXAMPLES
	# EXAMPLE: In case of an invalid cookie, send a message to High Speed Logging
	when BOTDEFENSE_REQUEST {
	    if {[BOTDEFENSE::cookie_status] eq "invalid"} {
		HSL::send $hsl "invalid botdefense cookie from IP [IP::client_addr]"
	    }
	}

HINTS
SEE ALSO
CHANGE LOG
       @BIGIP-12.1 --First introduced the command.



BIG-IP				  2018-07-19			      iRule(1)