83 lines
2.6 KiB
Groff
83 lines
2.6 KiB
Groff
.TH "user_contexts" "5" "28-Nov-2011" "Security Enhanced Linux" "SELinux configuration"
|
|
.SH "NAME"
|
|
user_contexts \- The SELinux user contexts configuration files
|
|
.
|
|
.SH "DESCRIPTION"
|
|
These optional user context configuration files contain entries that allow SELinux-aware login applications such as
|
|
.BR PAM (8)
|
|
(running in their own process context), to determine the context that a users login session should run under.
|
|
.sp
|
|
SELinux-aware login applications generally use one or more of the following libselinux functions that read these files from the active policy path:
|
|
.RS
|
|
.BR get_default_context (3)
|
|
.br
|
|
.BR get_ordered_context_list (3)
|
|
.br
|
|
.BR get_ordered_context_list_with_level (3)
|
|
.br
|
|
.BR get_default_context_with_level (3)
|
|
.br
|
|
.BR get_default_context_with_role (3)
|
|
.br
|
|
.BR get_default_context_with_rolelevel (3)
|
|
.br
|
|
.BR query_user_context (3)
|
|
.br
|
|
.BR manual_user_enter_context (3)
|
|
.RE
|
|
.sp
|
|
There can be one file for each SELinux user configured on the system. The file path is formed using the path returned by
|
|
.BR \%selinux_user_contexts_path (3)
|
|
for the active policy, with the SELinux user name appended, for example:
|
|
.RS
|
|
.I /etc/selinux/{SELINUXTYPE}/contexts/users/unconfined_u
|
|
.br
|
|
.I /etc/selinux/{SELINUXTYPE}/contexts/users/xguest_u
|
|
.RE
|
|
.sp
|
|
Where \fI{SELINUXTYPE}\fR is the entry from the selinux configuration file \fIconfig\fR (see \fBselinux_config\fR(5)).
|
|
.sp
|
|
These files contain context information as described in the
|
|
.B FILE FORMAT
|
|
section.
|
|
.
|
|
.SH "FILE FORMAT"
|
|
Each line in the user context configuration file consists of the following:
|
|
.RS
|
|
.I login_process user_login_process
|
|
.RE
|
|
.sp
|
|
Where:
|
|
.RS
|
|
.I login_process
|
|
.RS
|
|
This consists of a \fIrole\fB:\fItype\fR[\fB:\fIrange\fR] entry that represents the login process context.
|
|
.RE
|
|
.I user_login_process
|
|
.RS
|
|
This consists of a \fIrole\fB:\fItype\fR[\fB:\fIrange\fR] entry that represents the user login process context.
|
|
.RE
|
|
.RE
|
|
.
|
|
.SH "EXAMPLE"
|
|
# Example for xguest_u at /etc/selinux/targeted/contexts/users/xguest_u
|
|
.br
|
|
system_r:crond_t:s0 xguest_r:xguest_t:s0
|
|
.br
|
|
system_r:initrc_t:s0 xguest_r:xguest_t:s0
|
|
.br
|
|
system_r:local_login_t:s0 xguest_r:xguest_t:s0
|
|
.br
|
|
system_r:remote_login_t:s0 xguest_r:xguest_t:s0
|
|
.br
|
|
system_r:sshd_t:s0 xguest_r:xguest_t:s0
|
|
.br
|
|
system_r:xdm_t:s0 xguest_r:xguest_t:s0
|
|
.br
|
|
xguest_r:xguest_t:s0 xguest_r:xguest_t:s0
|
|
.
|
|
.SH "SEE ALSO"
|
|
.ad l
|
|
.nh
|
|
.BR selinux "(8), " selinux_user_contexts_path "(3), " PAM "(8), " get_ordered_context_list "(3), " get_ordered_context_list_with_level "(3), " get_default_context_with_level "(3), " get_default_context_with_role "(3), " get_default_context_with_rolelevel "(3), " query_user_context "(3), " manual_user_enter_context "(3), " selinux_config "(5) "
|