source: soft/build_system/build_system/repsys/branches/V1_6_X/README.LDAP @ 1

Last change on this file since 1 was 1, checked in by fasma, 12 years ago

Initial Import from Mandriva's soft revision 224062 and package revision 45733

File size: 2.3 KB
Line 
1A Repsys plugin for obtaining users from a LDAP server.
2
3In order to enable the plugin, the user must define the following
4options in the [global] section of repsys.conf:
5
6    ldap-uri [required if ldap-server is unset]
7        the URI of the server, you can refer to more than one server by
8        adding more URIs separated by spaces::
9
10          ldap-uri = ldap://ldap.network/ ldaps://backup.network:22389/
11
12    ldap-server [required if ldap-uri is unset]
13        the host name of the LDAP server
14    ldap-port [optional] [default: 389]
15        the port of the LDAP server
16    ldap-base [required]
17        the base DN where the search will be performed
18    ldap-binddn [optional] [default: empty]
19        the DN used to bind
20    ldap-bindpw [optional] [default: empty]
21        the password used to bind
22    ldap-starttls [optional] [default: no]
23         use "yes" or "no" to enable or disable the use of the STARTTLS
24         LDAP extension
25    ldap-filterformat [optional]
26            [default: (&(objectClass=inetOrgPerson)(uid=$username))]
27        RFC-2254 filter string used in the search of the user entry.
28        Note that this is a python template string and will have the
29        user name as parameter. For example:
30
31           ldap-filterformat = (&(objectClass=inetOrgPerson)(uid=$username))
32
33        Will result in the search filter:
34
35           (&(objectClass=inetOrgPerson)(uid=john))
36
37    ldap-resultformat [optional] [default: $cn <$mail>]
38        This is a python template string. This string will be
39        formatted using one dict object containing the fields
40        returned in the LDAP search, for example:
41
42          >>> format = Template("$cn <$mail>")
43          >>> d = search(basedn, filter)
44          >>> d
45          {"cn": "John Doe", "mail": "john@mandriva.org",
46           "uidNumber": "1290", "loginShell": "/bin/bash",
47            ... many other attributes ... }
48          >>> value = format.substitute(d)
49          >>> print value
50          John Doe <john@mandriva.org>
51
52        Note that only the first value of the attributes will be
53        used.
54
55When the searched option is not found, it will try in repsys.conf. All
56the values found.  (including from repsys.conf) will be cached between
57each configuration access.
58
59This plugin requires the package python-ldap.
60
61For more information, look http://qa.mandriva.com/show_bug.cgi?id=30549
Note: See TracBrowser for help on using the repository browser.