Ldap_spare_N MTA options

From Messaging Server Technical Reference Wiki
Jump to: navigation, search

Direct LDAP attribute name MTA options: ldap_spare_N (LDAP attribute name)

The ldap_spare_N, N=1,...,18, MTA options may be used to name LDAP attributes intended for site-customizable purposes, to be made known to the MTA (and hence be more easily accessible in MTA LDAP URLs and certain MTA mapping tables, etc.). ldap_spare_6 was new in Messaging Server 7.0-3.01; ldap_spare_N for N=7,...,18 were new in Messaging Server 7.2-7.02.

When a ldap_spare_N option has been set to the name of an LDAP attribute, then the value of the named attribute may be substituted in MTA LDAP URLs via the $NE substitution sequence.

For N=1,...,6, the value of the named attribute may optionally (see the include_spares1 MTA option) be included in various recipient access mapping table probes and FROM_ACCESS mapping table probes. And as of 8.0, such named LDAP attribute values may also be included (see the include_spares2 MTA option) in FORWARD mapping table probes.

ldap_spare_4, ldap_spare_5, and ldap_spare_6 will be included in SIEVE_EXTLISTS mapping table probes. And as of MS 6.3, the MTA supports the use of multiple, language-tagged values for these (ldap_spare_4, ldap_spare_5, and ldap_spare_6) attributes. When multiple, language-tagged values are present, the MTA will preferentially use the value tagged as being in the language preference expressed in a header line such as Accept-Language:, or in the absence of such header lines will use the value tagged as being in the language of the envelope From user's ldap_preferred_language (normally preferredLanguage) attribute's value.

See the respective spare_N_separator MTA options for configuration of whether a ldap_spare_N LDAP attribute is allowed to have multiple values and if so, how to handle the multiple values.

For aliases defined in the alias file (legacy configuration), or via alias options (Unified Configuration), see the [SPARE*] alias file named parameters or alias_spare* alias options, respectively.

See also: