| Richard Haines | 426d624 | 2011-12-02 10:59:35 +0000 | [diff] [blame] | 1 | .TH "service_seusers" "5" "28-Nov-2011" "Security Enhanced Linux" "SELinux configuration" |
| Richard Haines | 426d624 | 2011-12-02 10:59:35 +0000 | [diff] [blame] | 2 | .SH "NAME" |
| Guillem Jover | 6ef13ee | 2012-11-13 21:15:34 +0100 | [diff] [blame] | 3 | service_seusers \- The SELinux GNU/Linux user and service to SELinux user mapping configuration files |
| 4 | . |
| Richard Haines | 426d624 | 2011-12-02 10:59:35 +0000 | [diff] [blame] | 5 | .SH "DESCRIPTION" |
| 6 | These are optional files that allow services to define an SELinux user when authenticating via SELinux-aware login applications such as |
| 7 | .BR PAM "(8). " |
| 8 | .sp |
| 9 | There is one file for each GNU/Linux user name that will be required to run a service with a specific SELinux user name. |
| 10 | .sp |
| 11 | The path for each configuration file is formed by the path returned by |
| 12 | .BR selinux_policy_root "(3) with " |
| 13 | .IR /logins/username |
| 14 | appended (where \fIusername\fR is a file representing the GNU/Linux user name). The default services directory is located at: |
| 15 | .RS |
| 16 | .I /etc/selinux/{SELINUXTYPE}/logins |
| 17 | .RE |
| 18 | .sp |
| 19 | Where \fI{SELINUXTYPE}\fR is the entry from the selinux configuration file \fIconfig\fR (see \fBselinux_config\fR(5)). |
| 20 | .sp |
| 21 | .BR getseuser "(3) reads this file to map services to an SELinux user. " |
| Guillem Jover | 6ef13ee | 2012-11-13 21:15:34 +0100 | [diff] [blame] | 22 | . |
| Richard Haines | 426d624 | 2011-12-02 10:59:35 +0000 | [diff] [blame] | 23 | .SH "FILE FORMAT" |
| 24 | Each line within the \fIusername\fR file is formatted as follows with each component separated by a colon: |
| 25 | .RS |
| 26 | .IB service : seuser \fR[\fB:\fIrange\fR] |
| 27 | .RE |
| 28 | .sp |
| 29 | Where: |
| 30 | .RS |
| 31 | .I service |
| 32 | .RS |
| 33 | The service name used by the application. |
| 34 | .RE |
| 35 | .I seuser |
| 36 | .RS |
| 37 | The SELinux user name. |
| 38 | .RE |
| 39 | .I range |
| 40 | .RS |
| 41 | The range for MCS/MLS policies. |
| 42 | .RE |
| 43 | .RE |
| Guillem Jover | 6ef13ee | 2012-11-13 21:15:34 +0100 | [diff] [blame] | 44 | . |
| Richard Haines | 426d624 | 2011-12-02 10:59:35 +0000 | [diff] [blame] | 45 | .SH "EXAMPLES" |
| Guillem Jover | 6ef13ee | 2012-11-13 21:15:34 +0100 | [diff] [blame] | 46 | Example 1 - for the 'root' user: |
| Richard Haines | 426d624 | 2011-12-02 10:59:35 +0000 | [diff] [blame] | 47 | .RS |
| 48 | # ./logins/root |
| 49 | .br |
| 50 | ipa:user_u:s0 |
| 51 | .br |
| 52 | this_service:unconfined_u:s0 |
| 53 | .RE |
| 54 | .sp |
| Guillem Jover | 6ef13ee | 2012-11-13 21:15:34 +0100 | [diff] [blame] | 55 | Example 2 - for GNU/Linux user 'rch': |
| Richard Haines | 426d624 | 2011-12-02 10:59:35 +0000 | [diff] [blame] | 56 | .RS |
| 57 | # ./logins/rch |
| 58 | .br |
| 59 | ipa:unconfined_u:s0 |
| 60 | .br |
| 61 | that_service:unconfined_u:s0 |
| 62 | .RE |
| Guillem Jover | 6ef13ee | 2012-11-13 21:15:34 +0100 | [diff] [blame] | 63 | . |
| Richard Haines | 426d624 | 2011-12-02 10:59:35 +0000 | [diff] [blame] | 64 | .SH "SEE ALSO" |
| Guillem Jover | 6ef13ee | 2012-11-13 21:15:34 +0100 | [diff] [blame] | 65 | .ad l |
| 66 | .nh |
| Richard Haines | 426d624 | 2011-12-02 10:59:35 +0000 | [diff] [blame] | 67 | .BR selinux "(8), " PAM "(8), " selinux_policy_root "(3), " getseuser "(3), " selinux_config "(5) " |
