1 .TH SLAPD-RELAY 5 "RELEASEDATE" "OpenLDAP LDVERSION"
3 slapd-relay \- relay backend to slapd
7 The primary purpose of this
9 backend is to map a naming context defined in a database
12 instance into a virtual naming context, with attributeType
13 and objectClass manipulation, if required.
18 This backend and the above mentioned overlay are experimental.
22 options apply to the relay backend database.
23 That is, they must follow a "database relay" line and come before any
24 subsequent "backend" or "database" lines.
25 Other database options are described in the
29 .B relay <real naming context> [massage]
30 The naming context of the database that is presented
31 under a virtual naming context.
32 The presence of the directive implies that one single database
33 will be presented under a virtual naming context.
34 This directive automatically instantiates the
39 keyword is present, the suffix massaging is automatically
46 directive is given, the
48 database does not refer to any specific database, but the most
49 appropriate one is looked-up after rewriting the request DN
50 for the operation that is being handled.
52 This allows to write carefully crafted rewrite rules that
53 cause some of the requests to be directed to one database, and
54 some to another; e.g., authentication can be mapped to one
55 database, and searches to another and so.
57 Another possibility is to map the same operation to different
58 databases based on details of the virtual naming context,
59 e.g. groups on one database and persons on another.
67 To implement a plain virtual naming context mapping
68 that refers to a single database, use
72 suffix "dc=virtual,dc=naming,dc=context"
73 relay "dc=real,dc=naming,dc=context" massage
76 To implement a plain virtual naming context mapping
77 that looks up the real naming context for each operation, use
81 suffix "dc=virtual,dc=naming,dc=context"
83 suffixmassage "dc=virtual,dc=naming,dc=context"
84 "dc=real,dc=naming,dc=context"
87 To implement the old-fashioned suffixalias, e.g. mapping
88 the virtual to the real naming context, but not the results
89 back from the real to the virtual naming context, use
93 suffix "dc=virtual,dc=naming,dc=context"
94 relay "dc=real,dc=naming,dc=context"
96 rewriteContext default
97 rewriteRule "dc=virtual,dc=naming,dc=context"
98 "dc=real,dc=naming,dc=context" ":"
99 rewriteRule searchFilter
100 rewriteRule searchResult
101 rewriteRule searchResultAttrDN
102 rewriteRule matchedDN
105 Note that the virtual database is bound to a single real database,
108 is automatically instantiated, but the rewrite rules
109 are written explicitly to map all the virtual to real
110 naming context data flow, but none of the real to virtual.
114 default slapd configuration file