doc/html/_sources/user/user_config/k5login.txt

   1 .. _.k5login(5):
   2
   3 .k5login
   4 ========
   5
   6 DESCRIPTION
   7 -----------
   8
   9 The .k5login file, which resides in a user's home directory, contains
  10 a list of the Kerberos principals.  Anyone with valid tickets for a
  11 principal in the file is allowed host access with the UID of the user
  12 in whose home directory the file resides.  One common use is to place
  13 a .k5login file in root's home directory, thereby granting system
  14 administrators remote root access to the host via Kerberos.
  15
  16
  17 EXAMPLES
  18 --------
  19
  20 Suppose the user ``alice`` had a .k5login file in her home directory
  21 containing just the following line::
  22
  23     bob@FOOBAR.ORG
  24
  25 This would allow ``bob`` to use Kerberos network applications, such as
  26 ssh(1), to access ``alice``'s account, using ``bob``'s Kerberos
  27 tickets.  In a default configuration (with **k5login_authoritative** set
  28 to true in :ref:`krb5.conf(5)`), this .k5login file would not let
  29 ``alice`` use those network applications to access her account, since
  30 she is not listed!  With no .k5login file, or with **k5login_authoritative**
  31 set to false, a default rule would permit the principal ``alice`` in the
  32 machine's default realm to access the ``alice`` account.
  33
  34 Let us further suppose that ``alice`` is a system administrator.
  35 Alice and the other system administrators would have their principals
  36 in root's .k5login file on each host::
  37
  38     alice@BLEEP.COM
  39
  40     joeadmin/root@BLEEP.COM
  41
  42 This would allow either system administrator to log in to these hosts
  43 using their Kerberos tickets instead of having to type the root
  44 password.  Note that because ``bob`` retains the Kerberos tickets for
  45 his own principal, ``bob@FOOBAR.ORG``, he would not have any of the
  46 privileges that require ``alice``'s tickets, such as root access to
  47 any of the site's hosts, or the ability to change ``alice``'s
  48 password.
  49
  50
  51 SEE ALSO
  52 --------
  53
  54 kerberos(1)