docs-xml/manpages/winbind_krb5_localauth.8.xml

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
   3 <refentry id="winbind_krb5_localauth.8">
   4
   5 <refmeta>
   6         <refentrytitle>winbind_krb5_localauth</refentrytitle>
   7         <manvolnum>8</manvolnum>
   8         <refmiscinfo class="source">Samba</refmiscinfo>
   9         <refmiscinfo class="manual">8</refmiscinfo>
  10         <refmiscinfo class="version">&doc.version;</refmiscinfo>
  11 </refmeta>
  12
  13
  14 <refnamediv>
  15         <refname>winbind_krb5_localauth</refname>
  16         <refpurpose>A plugin for MIT Kerberos for mapping user accounts.</refpurpose>
  17 </refnamediv>
  18
  19
  20 <refsect1>
  21         <title>DESCRIPTION</title>
  22
  23         <para>
  24                 This plugin is part of the
  25                 <citerefentry><refentrytitle>samba</refentrytitle>
  26                 <manvolnum>7</manvolnum></citerefentry> suite.
  27         </para>
  28
  29         <para>
  30                 <command>winbind_krb5_localauth</command> is a plugin that
  31                 permits the MIT Kerberos libraries that Kerberos principals can
  32                 be validated against local user accounts.
  33         </para>
  34 </refsect1>
  35 <refsect1>
  36         <title>PREREQUISITES</title>
  37         <para>
  38                 MIT Kerberos (at least version 1.12) is required.
  39         </para>
  40
  41         <para>
  42                 The plugin queries the <citerefentry><refentrytitle>winbindd</refentrytitle>
  43                 <manvolnum>8</manvolnum></citerefentry> daemon which needs to be configured
  44                 and started separately.
  45         </para>
  46
  47         <para>
  48                 The following sections needs to be added to the
  49                 <filename>krb5.conf</filename> file.
  50
  51                 <programlisting>
  52 [plugins]
  53         localauth = {
  54                 module = winbind:/usr/lib64/samba/krb5/winbind_krb5_localauth.so
  55                 enable_only = winbind
  56         }
  57                 </programlisting>
  58         </para>
  59 </refsect1>
  60
  61 <refsect1>
  62         <title>VERSION</title>
  63
  64         <para>
  65                 This man page is part of version &doc.version; of the Samba
  66                 suite.
  67         </para>
  68 </refsect1>
  69
  70 <refsect1>
  71         <title>AUTHOR</title>
  72
  73         <para>
  74                 The original Samba software and related utilities were created
  75                 by Andrew Tridgell. Samba is now developed by the Samba Team as
  76                 an Open Source project similar to the way the Linux kernel is
  77                 developed.
  78         </para>
  79
  80         <para>
  81                 The winbind_krb5_localauth manpage was written by Andreas
  82                 Schneider.
  83         </para>
  84 </refsect1>
  85
  86 </refentry>