apm acl

apm acl(1)						BIG-IP TMSH Manual						apm acl(1)

NAME
       acl - Manages an access control list (ACL).

MODULE
       apm

SYNTAX
       Configure the acl component within the apm module using the syntax shown in the following sections.

   CREATE/MODIFY
	create acl [name]
	modify acl [name]
	  options:
	    acl-order [integer]
	    app-service [[string] | none]
	    description [[string] | none]
	    entries {
	      {
		options:
		  action [allow | continue | discard | reject | unspec]
		  dst-end-port [[service] | none]
		  dst-start-port [[service] | none]
		  dst-subnet [[ip addr] | [[ip addr] [mask]]
		  host [[string] | none]
		  log [config | none | packet | summary | verbose]
		  paths [[string] | none]
		  protocol [integer]
		  scheme [any | http | https}
		  src-end-port [[service] | none]
		  src-start-port [[service] | none]
		  src-subnet [[ip addr] | [[ip addr] [mask]]
	      }
	    }
	    location-specific [true | false]
	    path-match-case [false | true]
	    type [dynamic | static]

   DISPLAY
	list acl
	list acl [ [ [name] | [glob] | [regex] ] ... ]
	   options:
	     all-properties
	     non-default-properties
	     partition

	show acl
	show acl [ [ [name] | [regex] ] ... ]
	  options:
	    (default | exa | gig | kil | meg | peta | raw | tera | yotta | zetta)
	    field-fmt

   DELETE
	delete acl [name]

DESCRIPTION
       You can use the acl component to configure a set of restrictions associated with a resource or favorite that defines access
       for users and groups.

EXAMPLES
       create acl MyACL { acl-order 3 entries src-start-port ip default inet dst-end-port ip default inet action allow }
	    Creates the static access control list named MyACL that is the third ACL in the list of ACLs in the visual policy
	    editor, and adds an access control entry that allows traffic using the default source IP address and the default
	    destination IP address.

       list acl all-properties
	    Displays a list of ACLs that includes the attributes of each ACL.

       delete acl MyACL
	    Deletes the MyACL access control list.

OPTIONS
       acl-order
	    Specifies the order of the access control entries in this access control list. This option is required.

       app-service
	    Specifies the name of the application service to which the object belongs. The default value is none. Note: If the
	    strict-updates option is enabled on the application service that owns the object, you cannot modify or delete the
	    object. Only the application service can modify or delete the object.

       description
	    Describes the access control list.

       entries
	    Configures an entry for an access control list.

	    action
		 Specifies the action that an access control list takes when this access control list entry is encountered.  This
		 option is required. You can specify one of the following actions:

		 allow
		      Allows traffic.

		 continue
		      Skips checking against the remaining access control list entries in this access control list, and continues
		      evaluation at the next access control list.

		 discard
		      Drops packets silently.

		 reject
		      Drops a packet and sends TCP RST on TCP flows or proper ICMP messages on UDP flows. Silently drops a packet
		      on other protocols.

	    dst-end-port
		 Specifies the destination IP address and network mask of the access control list entry. The default is 0.

	    dst-start-port
		 Specifies the source port or range of ports of the access control list entry.

	    dst-subnet
		 Specifies the destination subnet.

	    host Specifies the host name of the access control list entry.

	    location-specific
		 Specifies whether or not this object contains one or more attributes with values that are specific to the
		 location where the BIG-IP device resides. The location-specific attribute is either true or false. When using
		 policy sync, mark an object as location-specific to prevent errors that can occur when policies reference
		 objects, such as authentication servers, that are specific to a certain location.

	    log  Specifies the log level that is logged when actions of this type occur. Your options are:

		 config
		      Logs the configuration of a matched entry.

		 none Logs nothing. This is the default value.

		 packet
		      Logs a matched packet.

		 summary
		      Logs the name and entry number of a matched access control list and access control list entry.

		 verbose
		      Logs everything.

	    paths
		 Specifies an L7 access control list of matching URL paths.

	    protocol
		 Specifies the protocol number (TCP=6, UDP=17) of the access control list entry. The default is 0.

	    src-end-port
		 Specifies the source IP address and network mask of the access control list entry.

	    src-start-port
		 Specifies the source port or range of ports of the access control list entry.

	    src-subnet
		 Specifies the source subnet.

       [name]
	    Specifies the name of the access control list. This setting is required.

       partition
	    Displays the partition within which the object resides. The default is Common.

       path-match-case
	    Indicates whether the path is case sensitive. The default is true.

       type Specifies the type of access control list. The default is static.  The available types are static and dynamic.

SEE ALSO
COPYRIGHT
       No part of this program may be reproduced or transmitted in any form or by any means, electronic or mechanical, including
       photocopying, recording, or information storage and retrieval systems, for any purpose other than the purchaser's personal
       use, without the express written permission of F5 Networks, Inc.

       F5 Networks and BIG-IP (c) Copyright 2011-2012. All rights reserved.

BIG-IP							    2016-08-12							apm acl(1)