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 2017-01-31 iRule(1)