git.sur5r.net Git - openldap/blob - contrib/slapd-modules/kinit/README

   1 This directory contains the "kinit" slapd module. It is a simple plugin to
   2 have slapd request a Kerberos TGT and keep it renewed as long as slapd is
   3 running.
   4
   5 The current implementation has only been tested against the MIT variant of
   6 the Kerberos libraries. (Heimdal support might come later)
   7
   8 To use the overlay just load it into the slapd process:
   9
  10     moduleload </path/to>/kinit.so <principal> </path/to/key.tab>
  11
  12 The module accepts two arguments. The first one being the principal for which
  13 to request the TGT (it defaults to "ldap/<your hostname>@<DEFAULTREALM>")
  14 and the second one is the path to the keytab file to use for
  15 authentication, defaulting to whatever your system wide kerberos settings
  16 default to).
  17
  18 Use Makefile or the following commands should work to
  19 build it from inside the unpacked slapd sources, provided the required KRB5
  20 header files and libaries are installed on your system:
  21
  22     gcc -fPIC -c -I ../../../include/ -I ../../../servers/slapd kinit.c
  23     gcc -shared -o kinit.so kinit.o -lkrb5
  24
  25 ---
  26 This work is part of OpenLDAP Software <http://www.openldap.org/>.
  27
  28 Copyright 2010-2017 The OpenLDAP Foundation.
  29
  30 Redistribution and use in source and binary forms, with or without
  31 modification, are permitted only as authorized by the OpenLDAP
  32 Public License.
  33
  34 A copy of this license is available in the file LICENSE in the
  35 top-level directory of the distribution or, alternatively, at
  36 <http://www.OpenLDAP.org/license.html>.