bionic (5) firewalld.lockdown-whitelist.5.gz

NAME

       firewalld.lockdown-whitelist - firewalld lockdown whitelist configuration file

SYNOPSIS

       /etc/firewalld/lockdown-whitelists.xml

DESCRIPTION

       The firewalld lockdown-whitelist configuration file contains the selinux contexts, commands, users and
       user ids that are white-listed when firewalld lockdown feature is enabled (see firewalld.conf(5) and
       firewall-cmd(1)).

       This example configuration file shows the structure of an lockdown-whitelist file:

           <?xml version="1.0" encoding="utf-8"?>
           <whitelist>
             <selinux context="selinuxcontext"/>
             <command name="commandline[*]"/>
             <user {name="username|id="userid"}/>
           </whitelist>

OPTIONS

       The config can contain these tags and attributes. Some of them are mandatory, others optional.

   whitelist
       The mandatory whitelist start and end tag defines the lockdown-whitelist. This tag can only be used once
       in a lockdown-whitelist configuration file. There are no attributes for this.

   selinux
       Is an optional empty-element tag and can be used several times to have more than one selinux contexts
       entries. A selinux entry has exactly one attribute:

       context="string"
           The context is the security (SELinux) context of a running application or service.

           To get the context of a running application use ps -e --context and search for the application that
           should be white-listed.

           Warning: If the context of an application is unconfined, then this will open access for more than the
           desired application.

   command
       Is an optional empty-element tag and can be used several times to have more than one command entry. A
       command entry has exactly one attribute:

       name="string"
           The command string is a complete command line including path and also attributes.

           If a command entry ends with an asterisk '*', then all command lines starting with the command will
           match. If the '*' is not there the absolute command inclusive arguments must match.

           Commands for user root and others is not always the same, the used path depends on the use of the
           PATH environment variable.

   user
       Is an optional empty-element tag and can be used several times to white-list more than one user. A user
       entry has exactly one attribute of these:

       name="string"
           The user with the name string will be white-listed.

       id="integer"
           The user with the id userid will be white-listed.

SEE ALSO

       firewall-applet(1), firewalld(1), firewall-cmd(1), firewall-config(1), firewallctl(1), firewalld.conf(5),
       firewalld.direct(5), firewalld.dbus(5), firewalld.icmptype(5), firewalld.lockdown-whitelist(5), firewall-
       offline-cmd(1), firewalld.richlanguage(5), firewalld.service(5), firewalld.zone(5), firewalld.zones(5),
       firewalld.ipset(5), firewalld.helper(5)

NOTES

       firewalld home page:
           http://www.firewalld.org

       More documentation with examples:
           http://fedoraproject.org/wiki/FirewallD

AUTHORS

       Thomas Woerner <twoerner@redhat.com>
           Developer

       Jiri Popelka <jpopelka@redhat.com>
           Developer