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

   1 Copyright 2005-2008 The OpenLDAP Foundation. All rights reserved.
   2
   3 Redistribution and use in source and binary forms, with or without
   4 modification, are permitted only as authorized by the OpenLDAP
   5 Public License.
   6
   7 This directory contains native slapd plugins that implement access rules.
   8
   9 posixgroup.c contains a simple example that implements access control
  10 based on posixGroup membership, loosely inspired by ITS#3849.  It should
  11 be made clear that this access control policy does not reflect any
  12 standard track model of handling access control, and should be
  13 essentially viewed as an illustration of the use of the dynamic
  14 extension of access control within slapd.
  15
  16 To use the acl-posixgroup plugin, add:
  17
  18 moduleload acl-posixgroup.so
  19
  20 to your slapd configuration file; it requires "nis.schema" to be loaded.
  21 It is configured using
  22
  23 access to <what>
  24         by dynacl/posixGroup[.{exact,expand}]=<dnpat> {<level>|<priv(s)}
  25
  26 The default is "exact"; in case of "expand", "<dnpat>" results from
  27 the expansion of submatches in the "<what>" portion.  "<level>|<priv(s)>"
  28 describe the level of privilege this rule can assume.
  29
  30 No Makefile is provided. Use a command line similar to:
  31
  32 gcc -shared -I../../../include -I../../../servers/slapd -Wall -g \
  33         -o acl-posixgroup.so posixgroup.c
  34
  35 to compile the posixGroup ACL plugin.
  36