AUTH_FAILURE¶

Description¶

Note: Deprecated in 9.4. It will still work, but is being phased out. Use AUTH_RESULT instead in 9.4 and up.

Triggered when an unsuccessful authorization operation is completed. A default handler for this event is associated with each of the authentication profiles and causes the system to close the connection.

Examples¶

when AUTH_FAILURE {
  HTTP::respond 401
}

Related Information¶

Available Commands:

clone - Causes the system to clone traffic to the specified pool or pool member regardless of monitor status.
forward - Sets the connection to forward IP packets.
HTTP::collect - Collects an amount of HTTP body data that you specify.
HTTP::respond - Generates a response to the client as if it came from the server.
IP::idle_timeout - Returns or sets the idle timeout value.
ip_ttl - Returns the TTL of the latest IP packet received.
lasthop - Sets the lasthop of an IP connection.
listen - Sets up a related ephemeral listener to allow an incoming related connection to be established.
nexthop - Sets the nexthop of an IP connection.
node - Sends the packet directly to the identified server node.
peer - Causes the specified iRule commands to be evaluated under the peer’s (opposite) context.
persist - Causes the system to use the named persistence type to persist the connection.
session - Utilizes the persistence table to store arbitrary information based on the same keys as persistence.

Warning

The links to the sample code below are remnants of the old DevCentral wiki and will result in a 404 error. For best results, please copy the link text and search the codeshare directly on DevCentral.

Sample Code:

Client Auth Using HTML Forms - This iRule illustrates how to use HTML Forms for client authentication.
Client Auth Using HTTP Cookie - This iRule illustrates how to use HTTP Cookies for client based authentcation.
Reverse Proxy With Basic SSO - The iRule implements a authenticated HTTPS reverse proxy.

Introduced: BIGIP-9.0.0

The BIG-IP API Reference documentation contains community-contributed content. F5 does not monitor or control community code contributions. We make no guarantees or warranties regarding the available code, and it may contain errors, defects, bugs, inaccuracies, or security vulnerabilities. Your access to and use of any code available in the BIG-IP API reference guides is solely at your own risk.