| Current File : //usr/share/selinux/devel/html/openshift.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>openshift_selinux</title>
</head>
<body>
<h1 align="center">openshift_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="#MCS Constrained">MCS Constrained</a><br>
<a href="#BOOLEANS">BOOLEANS</a><br>
<a href="#PORT TYPES">PORT TYPES</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">openshift_selinux
− Security Enhanced Linux Policy for the openshift
processes</p>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Security-Enhanced
Linux secures the openshift processes via flexible mandatory
access control.</p>
<p style="margin-left:11%; margin-top: 1em">The openshift
processes execute with the openshift_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 openshift_t</b></p>
<h2>ENTRYPOINTS
<a name="ENTRYPOINTS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The openshift_t
SELinux type can be entered via the <b>crontab_exec_t,
user_cron_spool_t</b> file types.</p>
<p style="margin-left:11%; margin-top: 1em">The default
entrypoint paths for the openshift_t domain are the
following:</p>
<p style="margin-left:11%; margin-top: 1em">/usr/bin/(f)?crontab,
/usr/bin/at, /usr/sbin/fcronsighup,
/usr/libexec/fcronsighup, /var/spool/at(/.*)?,
/var/spool/cron, /var/spool/cron/[^/]+</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
openshift policy is very flexible allowing users to setup
their openshift processes in as secure a method as
possible.</p>
<p style="margin-left:11%; margin-top: 1em">The following
process types are defined for openshift:</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_initrc_t,
openshift_cgroup_read_t, openshift_net_read_t,
openshift_cron_t, openshift_t, openshift_app_t,
openshift_script_t</b></p>
<p style="margin-left:11%; margin-top: 1em">Note:
<b>semanage permissive -a openshift_t</b> can be used to
make the process type openshift_t permissive. SELinux does
not deny access to permissive process types, but the AVC
(SELinux denials) messages are still generated.</p>
<h2>MCS Constrained
<a name="MCS Constrained"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The SELinux
process type openshift_t is an MCS (Multi Category Security)
constrained type. Sometimes this separation is referred to
as sVirt. These types are usually used for securing
multi-tenant environments, such as virtualization,
containers or separation of users. The tools used to launch
MCS types, pick out a different MCS label for each process
group.</p>
<p style="margin-left:11%; margin-top: 1em">For example one
process might be launched with openshift_t:s0:c1,c2, and
another process launched with openshift_t:s0:c3,c4. The
SELinux kernel only allows these processes can only write to
content with a matching MCS label, or a MCS Label of s0. A
process running with the MCS level of s0:c1,c2 is not
allowed to write to content with the MCS label of
s0:c3,c4</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. openshift
policy is extremely flexible and has several booleans that
allow you to manipulate the policy and run openshift with
the tightest access possible.</p>
<p style="margin-left:11%; margin-top: 1em">If you want to
determine whether crond can execute jobs in the user domain
as opposed to the the generic cronjob domain, you must turn
on the cron_userdomain_transition boolean. Enabled by
default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
cron_userdomain_transition 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
deny any process from ptracing or debugging any other
processes, you must turn on the deny_ptrace boolean.
Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
deny_ptrace 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>
<h2>PORT TYPES
<a name="PORT TYPES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">SELinux defines
port types to represent TCP and UDP ports.</p>
<p style="margin-left:11%; margin-top: 1em">You can see the
types associated with a port by using the following
command:</p>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
port -l</b></p>
<p style="margin-left:11%; margin-top: 1em">Policy governs
the access confined processes have to these ports. SELinux
openshift policy is very flexible allowing users to setup
their openshift processes in as secure a method as
possible.</p>
<p style="margin-left:11%; margin-top: 1em">The following
port types are defined for openshift: <b><br>
openshift_port_t</b></p>
<h2>MANAGED FILES
<a name="MANAGED FILES"></a>
</h2>
<p style="margin-left:22%; margin-top: 1em">The SELinux
process type openshift_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:22%; margin-top: 1em"><b>faillog_t</b></p>
<p style="margin-left:22%; margin-top: 1em">/var/log/btmp.*
<br>
/var/log/faillog.* <br>
/var/log/tallylog.* <br>
/var/run/faillock(/.*)?</p>
<p style="margin-left:22%; margin-top: 1em"><b>hugetlbfs_t</b></p>
<p style="margin-left:22%; margin-top: 1em">/dev/hugepages
<br>
/usr/lib/udev/devices/hugepages</p>
<p style="margin-left:22%; margin-top: 1em"><b>krb5_host_rcache_t</b></p>
<p style="margin-left:22%; 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:22%; margin-top: 1em"><b>openshift_tmpfs_t</b></p>
<p style="margin-left:22%; margin-top: 1em"><b>postfix_spool_t</b></p>
<p style="margin-left:22%; margin-top: 1em">/var/spool/postfix.*
<br>
/var/spool/postfix/defer(/.*)? <br>
/var/spool/postfix/flush(/.*)? <br>
/var/spool/postfix/deferred(/.*)? <br>
/var/spool/postfix/maildrop(/.*)?</p>
<p style="margin-left:22%; margin-top: 1em"><b>security_t</b></p>
<p style="margin-left:22%; margin-top: 1em">/selinux</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
openshift policy is very flexible allowing users to setup
their openshift processes in as secure a method as
possible.</p>
<p style="margin-left:11%; margin-top: 1em"><b>EQUIVALENCE
DIRECTORIES</b></p>
<p style="margin-left:11%; margin-top: 1em">openshift
policy stores data with multiple different file context
types under the /var/lib/openshift directory. If you would
like to store the data in a different directory you can use
the semanage command to create an equivalence mapping. If
you wanted to store this data under the /srv directory you
would execute the following command:</p>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
fcontext -a -e /var/lib/openshift /srv/openshift <br>
restorecon -R -v /srv/openshift</b></p>
<p style="margin-left:11%; margin-top: 1em">openshift
policy stores data with multiple different file context
types under the /var/lib/stickshift directory. If you would
like to store the data in a different directory you can use
the semanage command to create an equivalence mapping. If
you wanted to store this data under the /srv directory you
would execute the following command:</p>
<p style="margin-left:11%; margin-top: 1em"><b>semanage
fcontext -a -e /var/lib/stickshift /srv/stickshift <br>
restorecon -R -v /srv/stickshift</b></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 openshift, 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 openshift_ra_content_t
’/srv/myopenshift_content(/.*)?’ <br>
restorecon -R -v /srv/myopenshift_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 openshift:</i></p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_app_tmp_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_app_tmp_t type, if you want to store
openshift app temporary files in the /tmp directories.</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_cgroup_read_exec_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_cgroup_read_exec_t type, if you want to
transition an executable to the openshift_cgroup_read_t
domain.</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_cgroup_read_tmp_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_cgroup_read_tmp_t type, if you want to
store openshift cgroup read temporary files in the /tmp
directories.</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_content_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_content_t type, if you want to treat the
files as openshift content.</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_cron_exec_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_cron_exec_t type, if you want to
transition an executable to the openshift_cron_t domain.</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_cron_tmp_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_cron_tmp_t type, if you want to store
openshift cron temporary files in the /tmp directories.</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_htaccess_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_htaccess_t type, if you want to treat the
file as a openshift access file.</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_initrc_exec_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_initrc_exec_t type, if you want to
transition an executable to the openshift_initrc_t domain.
<br>
Paths:</p>
<p style="margin-left:18%;">/usr/s?bin/mcollectived,
/usr/s?bin/(oo|rhc)-restorer, /usr/s?bin/oo-admin-ctl-gears,
/usr/s?bin/(oo|rhc)-restorer-wrapper.sh,
/etc/rc.d/init.d/libra, /etc/rc.d/init.d/mcollective</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_initrc_tmp_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_initrc_tmp_t type, if you want to store
openshift initrc temporary files in the /tmp
directories.</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_log_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_log_t type, if you want to treat the data
as openshift log data, usually stored under the /var/log
directory. <br>
Paths:</p>
<p style="margin-left:18%;">/var/log/openshift(/.*)?,
/var/log/mcollective.log.*</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_net_read_exec_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_net_read_exec_t type, if you want to
transition an executable to the openshift_net_read_t
domain.</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_ra_content_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_ra_content_t type, if you want to treat
the files as openshift read/append content.</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_rw_content_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_rw_content_t type, if you want to treat
the files as openshift read/write content.</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_rw_file_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_rw_file_t type, if you want to treat the
files as openshift rw content. <br>
Paths:</p>
<p style="margin-left:18%;">/var/lib/openshift/.*/data(/.*)?,
/var/lib/stickshift/.*/data(/.*)?</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_script_exec_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_script_exec_t type, if you want to
transition an executable to the openshift_script_t
domain.</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_tmp_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_tmp_t type, if you want to store
openshift temporary files in the /tmp directories. <br>
Paths:</p>
<p style="margin-left:18%;">/var/lib/openshift/.*/.tmp(/.*)?,
/var/lib/openshift/.*/.sandbox(/.*)?,
/var/lib/stickshift/.*/.tmp(/.*)?,
/var/lib/stickshift/.*/.sandbox(/.*)?</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_tmpfs_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_tmpfs_t type, if you want to store
openshift files on a tmpfs file system.</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_var_lib_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_var_lib_t type, if you want to store the
openshift files under the /var/lib directory. <br>
Paths:</p>
<p style="margin-left:18%;">/var/lib/openshift(/.*)?,
/var/lib/stickshift(/.*)?,
/var/lib/containers/home(/.*)?</p>
<p style="margin-left:11%; margin-top: 1em"><b>openshift_var_run_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the openshift_var_run_t type, if you want to store the
openshift files under the /run or /var/run directory. <br>
Paths:</p>
<p style="margin-left:18%;">/var/run/openshift(/.*)?,
/var/run/stickshift(/.*)?</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
port</b> can also be used to manipulate the port
definitions</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),
openshift(8), semanage(8), restorecon(8), chcon(1),
sepolicy(8), setsebool(8), openshift_app_selinux(8),
openshift_app_selinux(8), openshift_cgroup_read_selinux(8),
openshift_cgroup_read_selinux(8), openshift_cron_selinux(8),
openshift_cron_selinux(8), openshift_initrc_selinux(8),
openshift_initrc_selinux(8), openshift_net_read_selinux(8),
openshift_net_read_selinux(8), openshift_script_selinux(8),
openshift_script_selinux(8)</p>
<hr>
</body>
</html>