modules/pam_rhosts/README

   1 pam_rhosts — The rhosts PAM module
   2
   3 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   4
   5 DESCRIPTION
   6
   7 This module performs the standard network authentication for services, as used
   8 by traditional implementations of rlogin and rsh etc.
   9
  10 The authentication mechanism of this module is based on the contents of two
  11 files; /etc/hosts.equiv (or and ~/.rhosts. Firstly, hosts listed in the former
  12 file are treated as equivalent to the localhost. Secondly, entries in the
  13 user's own copy of the latter file is used to map "remote-host remote-user"
  14 pairs to that user's account on the current host. Access is granted to the user
  15 if their host is present in /etc/hosts.equiv and their remote account is
  16 identical to their local one, or if their remote account has an entry in their
  17 personal configuration file.
  18
  19 The module authenticates a remote user (internally specified by the item
  20 PAM_RUSER connecting from the remote host (internally specified by the item
  21 PAM_RHOST). Accordingly, for applications to be compatible this authentication
  22 module they must set these items prior to calling pam_authenticate(). The
  23 module is not capable of independently probing the network connection for such
  24 information.
  25
  26 OPTIONS
  27
  28 debug
  29
  30     Print debug information.
  31
  32 silent
  33
  34     Don't print informative messages.
  35
  36 superuser=account
  37
  38     Handle account as root.
  39
  40 EXAMPLES
  41
  42 To grant a remote user access by /etc/hosts.equiv or .rhosts for rsh add the
  43 following lines to /etc/pam.d/rsh:
  44
  45 #%PAM-1.0
  46 #
  47 auth     required       pam_rhosts.so
  48 auth     required       pam_nologin.so
  49 auth     required       pam_env.so
  50 auth     required       pam_unix.so
  51
  52
  53 AUTHOR
  54
  55 pam_rhosts was written by Thorsten Kukuk <kukuk@thkukuk.de>
  56