Show TOC

Procedure documentationSetting Up Access Control Lists (ACL) Locate this document in the navigation structure

 

You can set up an ACL (“access control list”) and use it to control which connections the gateway accepts and which it does not. They are based on the IP addresses of the clients. The same ACL file is used for the “standard” and for the “SNC” gateway port.

Procedure

  1. Create an ACL file using the syntax described below.

  2. In the instance profile of the gateway instance you set parameter gw/acl_file to the file path of the ACL file.

    Caution Caution

    If this parameter is not set, the gateway accepts all connection requests.

    End of the caution.
Syntax of the ACL file:

Lines in the ACL must have the following syntax:

Syntax Syntax

  1. <permit | deny> <ip-address[/mask]> [tracelevel] [# comment]
    
End of the source code.

Where,

  • permit = permits a connection, and deny = denies a connection.

  • <ip address>: The IP address must be an IPv4 or IPv6 address in the following form:

    • IPv4: 4 byte, decimal, '.' separated: e.g. 10.11.12.13

    • IPv6: 16 byte, hexadecimal, ':' separated. '::' is supported

  • <mask>: If a mask is specified, it must be a subnetwork prefix mask:

    • IPv4: 0-32

    • IPv6: 0-128

  • <trace level>: Trace level, with which ACL hits (matches of addresses based on the subnetwork mask) are written to the relevant trace file (default value 2).

  • <# comment>: Comment lines begin with a hash sign (#).

  • The file can contain blank lines.

  • As the last rule a general ban is inserted automatically.

To make it obvious, an explicit deny should be entered anyway as the last rule. The rules are checked sequentially from the “top down”. The first relevant rule determines the result (“first match”).

Example Example

Example of a file

permit 10.1.2.0/24         # permit client network

permit 192.168.7.0/24      # permit server network

permit 10.0.0.0/8 1        # screening rule

                           # (learning mode, trace-level 1)

permit 2001:db8::1428:57ab # permit IPv6 host

deny   0.0.0.0/0           # deny the rest

End of the example.

More Information

For more information about the parameters, see Security Parameters.