| Current File : //proc/self/root/kunden/usr/share/selinux/devel/html/insights_client.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>insights_client_selinux</title>
</head>
<body>
<h1 align="center">insights_client_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">insights_client_selinux
− Security Enhanced Linux Policy for the
insights_client processes</p>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Security-Enhanced
Linux secures the insights_client processes via flexible
mandatory access control.</p>
<p style="margin-left:11%; margin-top: 1em">The
insights_client processes execute with the insights_client_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 insights_client_t</b></p>
<h2>ENTRYPOINTS
<a name="ENTRYPOINTS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The
insights_client_t SELinux type can be entered via the
<b>insights_client_exec_t</b> file type.</p>
<p style="margin-left:11%; margin-top: 1em">The default
entrypoint paths for the insights_client_t domain are the
following:</p>
<p style="margin-left:11%; margin-top: 1em">/usr/bin/insights-client,
/usr/bin/redhat-access-insights</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
insights_client policy is very flexible allowing users to
setup their insights_client processes in as secure a method
as possible.</p>
<p style="margin-left:11%; margin-top: 1em">The following
process types are defined for insights_client:</p>
<p style="margin-left:11%; margin-top: 1em"><b>insights_client_t</b></p>
<p style="margin-left:11%; margin-top: 1em">Note:
<b>semanage permissive -a insights_client_t</b> can be used
to make the process type insights_client_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.
insights_client policy is extremely flexible and has several
booleans that allow you to manipulate the policy and run
insights_client with the tightest access possible.</p>
<p style="margin-left:11%; margin-top: 1em">If you want to
dontaudit all daemons scheduling requests (setsched,
sys_nice), you must turn on the daemons_dontaudit_scheduling
boolean. Enabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
daemons_dontaudit_scheduling 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
deny user domains applications to map a memory region as
both executable and writable, this is dangerous and the
executable should be reported in bugzilla, you must turn on
the deny_execmem boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
deny_execmem 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
control the ability to mmap a low area of the address space,
as configured by /proc/sys/vm/mmap_min_addr, you must turn
on the mmap_low_allowed boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
mmap_low_allowed 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
disable kernel module loading, you must turn on the
secure_mode_insmod boolean. Disabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
secure_mode_insmod 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow unconfined executables to make their heap memory
executable. Doing this is a really bad idea. Probably
indicates a badly coded executable, but could indicate an
attack. This executable should be reported in bugzilla, you
must turn on the selinuxuser_execheap boolean. Disabled by
default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
selinuxuser_execheap 1</b></p>
<p style="margin-left:11%; margin-top: 1em">If you want to
allow unconfined executables to make their stack executable.
This should never, ever be necessary. Probably indicates a
badly coded executable, but could indicate an attack. This
executable should be reported in bugzilla, you must turn on
the selinuxuser_execstack boolean. Enabled by default.</p>
<p style="margin-left:11%; margin-top: 1em"><b>setsebool -P
selinuxuser_execstack 1</b></p>
<h2>MANAGED FILES
<a name="MANAGED FILES"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The SELinux
process type insights_client_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>file_type</b></p>
<p style="margin-left:11%; margin-top: 1em">all files on
the system</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
insights_client policy is very flexible allowing users to
setup their insights_client 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">insights_client
policy stores data with multiple different file context
types under the /var/cache/insights 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/cache/insights /srv/insights <br>
restorecon -R -v /srv/insights</b></p>
<p style="margin-left:11%; margin-top: 1em">insights_client
policy stores data with multiple different file context
types under the /var/tmp/insights-client 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/tmp/insights-client /srv/insights-client
<br>
restorecon -R -v /srv/insights-client</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 insights_client, 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 insights_client_unit_file_t
’/srv/myinsights_client_content(/.*)?’ <br>
restorecon -R -v /srv/myinsights_client_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
insights_client:</i></p>
<p style="margin-left:11%; margin-top: 1em"><b>insights_client_cache_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the insights_client_cache_t type, if you want to store
the files under the /var/cache directory. <br>
Paths:</p>
<p style="margin-left:18%;">/var/cache/insights(/.*)?,
/var/cache/insights-client(/.*)?</p>
<p style="margin-left:11%; margin-top: 1em"><b>insights_client_etc_rw_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the insights_client_etc_rw_t type, if you want to treat
the files as insights client etc read/write content. <br>
Paths:</p>
<p style="margin-left:18%;">/etc/insights-client/machine-id,
/etc/insights-client/.cache.json,
/etc/insights-client/.lastupload,
/etc/insights-client/.registered,
/etc/insights-client/.unregistered,
/etc/insights-client/.cache.json.asc,
/etc/insights-client/.insights-core.etag,
/etc/insights-client/.last-upload.results,
/etc/insights-client/.insights-core-gpg-sig.etag,
/etc/insights-client/insights-client-egg-release</p>
<p style="margin-left:11%; margin-top: 1em"><b>insights_client_etc_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the insights_client_etc_t type, if you want to store
insights client files in the /etc directories. <br>
Paths:</p>
<p style="margin-left:18%;">/etc/insights-client/[^/]+,
/etc/insights-client</p>
<p style="margin-left:11%; margin-top: 1em"><b>insights_client_exec_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the insights_client_exec_t type, if you want to
transition an executable to the insights_client_t domain.
<br>
Paths:</p>
<p style="margin-left:18%;">/usr/bin/insights-client,
/usr/bin/redhat-access-insights</p>
<p style="margin-left:11%; margin-top: 1em"><b>insights_client_tmp_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the insights_client_tmp_t type, if you want to store
insights client temporary files in the /tmp directories.
<br>
Paths:</p>
<p style="margin-left:18%;">/var/tmp/insights-client(/.*)?,
/tmp/insights-client.ppid, /var/tmp/insights-client.ppid</p>
<p style="margin-left:11%; margin-top: 1em"><b>insights_client_tmpfs_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the insights_client_tmpfs_t type, if you want to store
insights client files on a tmpfs file system.</p>
<p style="margin-left:11%; margin-top: 1em"><b>insights_client_unit_file_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the insights_client_unit_file_t type, if you want to
treat the files as insights client unit content.</p>
<p style="margin-left:11%; margin-top: 1em"><b>insights_client_var_lib_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the insights_client_var_lib_t type, if you want to
store the insights client files under the /var/lib
directory.</p>
<p style="margin-left:11%; margin-top: 1em"><b>insights_client_var_lock_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the insights_client_var_lock_t type, if you want to
treat the files as insights client var lock data, stored
under the /var/lock directory</p>
<p style="margin-left:11%; margin-top: 1em"><b>insights_client_var_log_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the insights_client_var_log_t type, if you want to
treat the data as insights client var log data, usually
stored under the /var/log directory.</p>
<p style="margin-left:11%; margin-top: 1em"><b>insights_client_var_run_t</b></p>
<p style="margin-left:11%; margin-top: 1em">- Set files
with the insights_client_var_run_t type, if you want to
store the insights client files under the /run or /var/run
directory.</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),
insights_client(8), semanage(8), restorecon(8), chcon(1),
sepolicy(8), setsebool(8)</p>
<hr>
</body>
</html>