One Hat Cyber Team

Edit File: gitosis.html

<!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>gitosis_selinux</title>

</head>
<body>

<h1 align="center">gitosis_selinux</h1>

<a href="#NAME">NAME</a> 
<a href="#DESCRIPTION">DESCRIPTION</a> 
<a href="#ENTRYPOINTS">ENTRYPOINTS</a> 
<a href="#PROCESS TYPES">PROCESS TYPES</a> 
<a href="#BOOLEANS">BOOLEANS</a> 
<a href="#MANAGED FILES">MANAGED FILES</a> 
<a href="#FILE CONTEXTS">FILE CONTEXTS</a> 
<a href="#COMMANDS">COMMANDS</a> 
<a href="#AUTHOR">AUTHOR</a> 
<a href="#SEE ALSO">SEE ALSO</a>

<hr>

gitosis_selinux
&minus; Security Enhanced Linux Policy for the gitosis
processes

<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>

Security-Enhanced
Linux secures the gitosis processes via flexible mandatory
access control.

The gitosis
processes execute with the gitosis_t SELinux type. You can
check if you have these processes running by executing the
ps command with the &minus;Z qualifier.

For
example:

ps -eZ |
grep gitosis_t

<h2>ENTRYPOINTS
<a name="ENTRYPOINTS"></a>
</h2>

The gitosis_t
SELinux type can be entered via the gitosis_exec_t
file type.

The default
entrypoint paths for the gitosis_t domain are the
following:

/usr/bin/gitosis-serve,
/usr/bin/gl-auth-command

<h2>PROCESS TYPES
<a name="PROCESS TYPES"></a>
</h2>

SELinux defines
process types (domains) for each process running on the
system

You can see the
context of a process using the &minus;Z option to
ps

Policy governs
the access confined processes have to files. SELinux gitosis
policy is very flexible allowing users to setup their
gitosis processes in as secure a method as possible.

The following
process types are defined for gitosis:

gitosis_t

Note:
semanage permissive -a gitosis_t can be used to make
the process type gitosis_t permissive. SELinux does not deny
access to permissive process types, but the AVC (SELinux
denials) messages are still generated.

<h2>BOOLEANS
<a name="BOOLEANS"></a>
</h2>

SELinux policy
is customizable based on least access required. gitosis
policy is extremely flexible and has several booleans that
allow you to manipulate the policy and run gitosis with the
tightest access possible.

If you want to
determine whether Gitosis can send mail, you must turn on
the gitosis_can_sendmail boolean. Disabled by default.

setsebool -P
gitosis_can_sendmail 1

If you want to
deny any process from ptracing or debugging any other
processes, you must turn on the deny_ptrace boolean. Enabled
by default.

setsebool -P
deny_ptrace 1

If you want to
allow all domains to use other domains file descriptors, you
must turn on the domain_fd_use boolean. Enabled by
default.

setsebool -P
domain_fd_use 1

If you want to
allow all domains to have the kernel load modules, you must
turn on the domain_kernel_load_modules boolean. Disabled by
default.

setsebool -P
domain_kernel_load_modules 1

If you want to
allow all domains to execute in fips_mode, you must turn on
the fips_mode boolean. Enabled by default.

setsebool -P
fips_mode 1

If you want to
enable reading of urandom for all domains, you must turn on
the global_ssp boolean. Disabled by default.

setsebool -P
global_ssp 1

<h2>MANAGED FILES
<a name="MANAGED FILES"></a>
</h2>

The SELinux
process type gitosis_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.

gitosis_var_lib_t

/srv/lib/gitosis(/.*)?
 
/var/lib/gitosis(/.*)? 
/var/lib/gitolite(3)?(/.*)?

<h2>FILE CONTEXTS
<a name="FILE CONTEXTS"></a>
</h2>

SELinux
requires files to have an extended attribute to define the
file type.

You can see the
context of a file using the &minus;Z option to
ls

Policy governs
the access confined processes have to these files. SELinux
gitosis policy is very flexible allowing users to setup
their gitosis processes in as secure a method as
possible.

STANDARD
FILE CONTEXT

SELinux defines
the file context types for the gitosis, if you wanted to
store files with these types in a diffent paths, you need to
execute the semanage command to sepecify alternate labeling
and then use restorecon to put the labels on disk.

semanage
fcontext -a -t gitosis_var_lib_t
&rsquo;/srv/mygitosis_content(/.*)?&rsquo; 
restorecon -R -v /srv/mygitosis_content

Note: SELinux
often uses regular expressions to specify labels that match
multiple files.

The
following file types are defined for gitosis:

gitosis_exec_t

- Set files
with the gitosis_exec_t type, if you want to transition an
executable to the gitosis_t domain. 
Paths:

/usr/bin/gitosis-serve,
/usr/bin/gl-auth-command

gitosis_var_lib_t

- Set files
with the gitosis_var_lib_t type, if you want to store the
gitosis files under the /var/lib directory. 
Paths:

/srv/lib/gitosis(/.*)?,
/var/lib/gitosis(/.*)?, /var/lib/gitolite(3)?(/.*)?

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 semanage fcontext command. This will
modify the SELinux labeling database. You will need to use
restorecon to apply the labels.

<h2>COMMANDS
<a name="COMMANDS"></a>
</h2>

semanage
fcontext can also be used to manipulate default file
context mappings.

semanage
permissive can also be used to manipulate whether or not
a process type is permissive.

semanage
module can also be used to enable/disable/install/remove
policy modules.

semanage
boolean can also be used to manipulate the booleans

system-config-selinux
is a GUI tool available to customize SELinux policy
settings.

<h2>AUTHOR
<a name="AUTHOR"></a>
</h2>

This manual
page was auto-generated using sepolicy manpage .

selinux(8),
gitosis(8), semanage(8), restorecon(8), chcon(1),
sepolicy(8) , setsebool(8)
<hr>
</body>
</html>