ltm rule command sha256

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



sha256
       Returns the Secure Hash Algorithm (SHA2) 256-bit message digest of the
       specified string.

SYNOPSIS
       sha256 ANY_CHARS

DESCRIPTION
       Returns the Secure Hash Algorithm (SHA2) 256-bit message digest of the
       specified string. If an error occurs, an empty string is returned. Used
       to ensure data integrity.

RETURN VALUE
       sha256 
	   Returns the Secure Hash Algorithm version 2.0 (SHA2) message digest
       of the specified string using 256 bit digest length. If an error
       occurs, an empty string is returned.

VALID DURING
       RULE_INIT

EXAMPLES
	when HTTP_REQUEST {
	    binary scan [sha256 [HTTP::host]] w1 key

	    set key [expr {$key & 1}]
	    switch $key {
		0 { pool my_pool member 1.2.3.4:80 }
		1 { pool my_pool member 5.6.7.8:80 }
	    }
	}

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



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