| Current File : //proc/thread-self/root/kunden/usr/share/selinux/devel/html/httpd_suexec.html |
<!-- Creator : groff version 1.22.4 -->
<!-- CreationDate: Thu Apr 10 20:00:00 2025 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
p { margin-top: 0; margin-bottom: 0; vertical-align: top }
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
h1 { text-align: center }
</style>
<title>httpd_suexec_selinux</title>
</head>
<body>
<h1 align="center">httpd_suexec_selinux</h1>
<a href="#NAME">NAME</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#ENTRYPOINTS">ENTRYPOINTS</a><br>
<a href="#PROCESS TYPES">PROCESS TYPES</a><br>
<a href="#BOOLEANS">BOOLEANS</a><br>
<a href="#MANAGED FILES">MANAGED FILES</a><br>
<a href="#FILE CONTEXTS">FILE CONTEXTS</a><br>
<a href="#COMMANDS">COMMANDS</a><br>
<a href="#AUTHOR">AUTHOR</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<hr>
<h2>NAME
<a name="NAME"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">httpd_suexec_selinux
− Security Enhanced Linux Policy for the httpd_suexec
processes</p>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Security-Enhanced
Linux secures the httpd_suexec processes via flexible
mandatory access control.</p>
<p style="margin-left:11%; margin-top: 1em">The
httpd_suexec processes execute with the httpd_suexec_t
SELinux type. You can check if you have these processes
running by executing the <b>ps</b> command with the
<b>−Z</b> qualifier.</p>
<p style="margin-left:11%; margin-top: 1em">For
example:</p>
<p style="margin-left:11%; margin-top: 1em"><b>ps -eZ |
grep httpd_suexec_t</b></p>
<h2>ENTRYPOINTS
<a name="ENTRYPOINTS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The
httpd_suexec_t SELinux type can be entered via the
<b>httpd_suexec_exec_t</b> file type.</p>
<p style="margin-left:11%; margin-top: 1em">The default
entrypoint paths for the httpd_suexec_t domain are the
following:</p>
<p style="margin-left:11%; margin-top: 1em">/usr/lib/apache(2)?/suexec(2)?,
/usr/lib/cgi-bin/(nph-)?cgiwrap(d)?, /usr/sbin/suexec</p>
<h2>PROCESS TYPES
<a name="PROCESS TYPES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">SELinux defines
process types (domains) for each process running on the
system</p>
<p style="margin-left:11%; margin-top: 1em">You can see the
context of a process using the <b>−Z</b> option to
<b>ps</b></p>
<p style="margin-left:11%; margin-top: 1em">Policy governs
the access confined processes have to files. SELinux
httpd_suexec policy is very flexible allowing users to setup
their httpd_suexec processes in as secure a method as
possible.</p>
<p style="margin-left:11%; margin-top: 1em">The following
process types are defined for httpd_suexec:</p>
<p style="margin-left:11%; margin-top: 1em"><b>httpd_suexec_t</b></p>
<p style="margin-left:11%; margin-top: 1em">Note:
<b>semanage permissive -a httpd_suexec_t</b> can be used to
make the process type httpd_suexec_t permissive. SELinux
does not deny access to permissive process types, but the
AVC (SELinux denials) messages are still generated.</p>
<h2>BOOLEANS
<a name="BOOLEANS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">SELinux policy
is customizable based on least access required. httpd_suexec
policy is extremely flexible and has several booleans that
allow you to manipulate the policy and run httpd_suexec with
the tightest access possible.</p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow all domains to execute in fips_mode, you must turn on
the fips_mode boolean. Enabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
fips_mode 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow httpd to use built in scripting (usually php), you
must turn on the httpd_builtin_scripting boolean. Enabled by
default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
httpd_builtin_scripting 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow HTTPD scripts and modules to connect to the network
using TCP, you must turn on the httpd_can_network_connect
boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
httpd_can_network_connect 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow HTTPD scripts and modules to connect to databases over
the network, you must turn on the
httpd_can_network_connect_db boolean. Disabled by
default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
httpd_can_network_connect_db 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow http daemon to send mail, you must turn on the
httpd_can_sendmail boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
httpd_can_sendmail 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow httpd cgi support, you must turn on the
httpd_enable_cgi boolean. Enabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
httpd_enable_cgi 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow httpd to read home directories, you must turn on the
httpd_enable_homedirs boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
httpd_enable_homedirs 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow httpd scripts and modules execmem/execstack, you must
turn on the httpd_execmem boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
httpd_execmem 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow httpd to read user content, you must turn on the
httpd_read_user_content boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
httpd_read_user_content 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
unify HTTPD to communicate with the terminal. Needed for
entering the passphrase for certificates at the terminal,
you must turn on the httpd_tty_comm boolean. Disabled by
default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
httpd_tty_comm 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
unify HTTPD handling of all content files, you must turn on
the httpd_unified boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
httpd_unified 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow httpd to access cifs file systems, you must turn on
the httpd_use_cifs boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
httpd_use_cifs 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow httpd to access FUSE file systems, you must turn on
the httpd_use_fusefs boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
httpd_use_fusefs 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow httpd to access nfs file systems, you must turn on the
httpd_use_nfs boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
httpd_use_nfs 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow system to run with NIS, you must turn on the
nis_enabled boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
nis_enabled 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
support NFS home directories, you must turn on the
use_nfs_home_dirs boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
use_nfs_home_dirs 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
support SAMBA home directories, you must turn on the
use_samba_home_dirs boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
use_samba_home_dirs 1</b></p>
<h2>MANAGED FILES
<a name="MANAGED FILES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The SELinux
process type httpd_suexec_t can manage files labeled with
the following file types. The paths listed are the default
paths for these file types. Note the processes UID still
need to have DAC permissions.</p>
<p style="margin-left:11%; margin-top: 1em"><b>cifs_t</b></p>
<p style="margin-left:11%; margin-top: 1em"><b>fusefs_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/var/run/user/[0-9]+/gvfs</p>
<p style="margin-left:11%; margin-top: 1em"><b>httpd_suexec_tmp_t</b></p>
<p style="margin-left:11%; margin-top: 1em"><b>krb5_host_rcache_t</b></p>
<p style="margin-left:11%; margin-top: 1em">/var/tmp/krb5_0.rcache2
<br>
/var/cache/krb5rcache(/.*)? <br>
/var/tmp/nfs_0 <br>
/var/tmp/DNS_25 <br>
/var/tmp/host_0 <br>
/var/tmp/imap_0 <br>
/var/tmp/HTTP_23 <br>
/var/tmp/HTTP_48 <br>
/var/tmp/ldap_55 <br>
/var/tmp/ldap_487 <br>
/var/tmp/ldapmap1_0</p>
<p style="margin-left:11%; margin-top: 1em"><b>nfs_t</b></p>
<h2>FILE CONTEXTS
<a name="FILE CONTEXTS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">SELinux
requires files to have an extended attribute to define the
file type.</p>
<p style="margin-left:11%; margin-top: 1em">You can see the
context of a file using the <b>−Z</b> option to
<b>ls</b></p>
<p style="margin-left:11%; margin-top: 1em">Policy governs
the access confined processes have to these files. SELinux
httpd_suexec policy is very flexible allowing users to setup
their httpd_suexec processes in as secure a method as
possible.</p>
<p style="margin-left:11%; margin-top: 1em"><b>STANDARD
FILE CONTEXT</b></p>
<p style="margin-left:11%; margin-top: 1em">SELinux defines
the file context types for the httpd_suexec, if you wanted
to store files with these types in a different paths, you
need to execute the semanage command to specify alternate
labeling and then use restorecon to put the labels on
disk.</p>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
fcontext -a -t httpd_suexec_tmp_t
’/srv/myhttpd_suexec_content(/.*)?’ <br>
restorecon -R -v /srv/myhttpd_suexec_content</b></p>
<p style="margin-left:11%; margin-top: 1em">Note: SELinux
often uses regular expressions to specify labels that match
multiple files.</p>
<p style="margin-left:11%; margin-top: 1em"><i>The
following file types are defined for httpd_suexec:</i></p>
<p style="margin-left:11%; margin-top: 1em"><b>httpd_suexec_exec_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the httpd_suexec_exec_t type, if you want to transition
an executable to the httpd_suexec_t domain. <br>
Paths:</p>
<p style="margin-left:18%;">/usr/lib/apache(2)?/suexec(2)?,
/usr/lib/cgi-bin/(nph-)?cgiwrap(d)?, /usr/sbin/suexec</p>
<p style="margin-left:11%; margin-top: 1em"><b>httpd_suexec_tmp_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the httpd_suexec_tmp_t type, if you want to store httpd
suexec temporary files in the /tmp directories.</p>
<p style="margin-left:11%; margin-top: 1em">Note: File
context can be temporarily modified with the chcon command.
If you want to permanently change the file context you need
to use the <b>semanage fcontext</b> command. This will
modify the SELinux labeling database. You will need to use
<b>restorecon</b> to apply the labels.</p>
<h2>COMMANDS
<a name="COMMANDS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
fcontext</b> can also be used to manipulate default file
context mappings.</p>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
permissive</b> can also be used to manipulate whether or not
a process type is permissive.</p>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
module</b> can also be used to enable/disable/install/remove
policy modules.</p>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
boolean</b> can also be used to manipulate the booleans</p>
<p style="margin-left:11%; margin-top: 1em"><b>system-config-selinux</b>
is a GUI tool available to customize SELinux policy
settings.</p>
<h2>AUTHOR
<a name="AUTHOR"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">This manual
page was auto-generated using <b>sepolicy manpage .</b></p>
<h2>SEE ALSO
<a name="SEE ALSO"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">selinux(8),
httpd_suexec(8), semanage(8), restorecon(8), chcon(1),
sepolicy(8), setsebool(8)</p>
<hr>
</body>
</html>