modules/pam_sepermit/README

   1 pam_sepermit — PAM module to allow/deny login depending on SELinux enforcement
   2 state
   3
   4 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   5
   6 DESCRIPTION
   7
   8 The pam_sepermit module allows or denies login depending on SELinux enforcement
   9 state.
  10
  11 When the user which is logging in matches an entry in the config file he is
  12 allowed access only when the SELinux is in enforcing mode. Otherwise he is
  13 denied access. For users not matching any entry in the config file the
  14 pam_sepermit module returns PAM_IGNORE return value.
  15
  16 The config file contains a list of user names one per line with optional
  17 arguments. If the name is prefixed with @ character it means that all users in
  18 the group name match. If it is prefixed with a % character the SELinux user is
  19 used to match against the name instead of the account name. Note that when
  20 SELinux is disabled the SELinux user assigned to the account cannot be
  21 determined. This means that such entries are never matched when SELinux is
  22 disabled and pam_sepermit will return PAM_IGNORE.
  23
  24 See sepermit.conf(5) for details.
  25
  26 OPTIONS
  27
  28 debug
  29
  30     Turns on debugging via syslog(3).
  31
  32 conf=/path/to/config/file
  33
  34     Path to alternative config file overriding the default.
  35
  36 EXAMPLES
  37
  38 auth     [success=done ignore=ignore default=bad] pam_sepermit.so
  39 auth     required  pam_unix.so
  40 account  required  pam_unix.so
  41 session  required  pam_permit.so
  42
  43
  44 AUTHOR
  45
  46 pam_sepermit and this manual page were written by Tomas Mraz
  47 <tmraz@redhat.com>.
  48