ltm rule command BOTDEFENSE cs attribute

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



BOTDEFENSE::cs_attribute
       Queries for or sets attributes for the client-side challenge.

SYNOPSIS
       BOTDEFENSE::cs_attribute 'device_id' (BOOLEAN)?

DESCRIPTION
       Queries for or sets attributes for the client-side challenge. These
       attributes are only effective if a client-side action is taken on the
       current request. Otherwise, these attributes are silently ignored.

       Syntax

       BOTDEFENSE::cs_attribute device_id [enable | disable]

	   * Sets or gets the value of the "device_id" attribute. When enabled, the client-side challenge will collect data from the client and attempt to retrieve the device_id.

RETURN VALUE
       * When called without any arguments, returns the value of the requested
       attribute.  * When called with an argument, the requested attribute is
       overridden, and no value is returned.

VALID DURING
       BOTDEFENSE_REQUEST, BOTDEFENSE_ACTION

EXAMPLES
	# EXAMPLE: Make sure that the data for the device_id is always collected when taking a client-side action.
	when BOTDEFENSE_REQUEST {
	    BOTDEFENSE::cs_attribute device_id enable
	}

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



BIG-IP				  2017-01-31			      iRule(1)