1.1 --- a/docs/wiki/MailIntegration Tue Oct 27 21:16:26 2015 +0100
1.2 +++ b/docs/wiki/MailIntegration Tue Oct 27 21:17:11 2015 +0100
1.3 @@ -46,9 +46,9 @@
1.4 {{{#!table
1.5 '''Identification Mechanisms''' || '''Tested with...'''
1.6 ==
1.7 -LDAP || Exim, Postfix
1.8 +[[/LDAP|LDAP]] || Exim, Postfix
1.9 ==
1.10 -Simple (list-based identification) || Exim, Postfix
1.11 +[[/Simple|Simple (list-based identification)]] || Exim, Postfix
1.12 }}}
1.13
1.14 == Delivery ==
2.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
2.2 +++ b/docs/wiki/MailIntegration--LDAP Tue Oct 27 21:17:11 2015 +0100
2.3 @@ -0,0 +1,88 @@
2.4 += LDAP Mail Integration =
2.5 +
2.6 +LDAP can be used to identify mail recipients by configuring the mail transport
2.7 +agent (MTA) to issue queries to a suitable service. Where necessary, the
2.8 +following definitions need to be incorporated into the example configuration
2.9 +files given below:
2.10 +
2.11 +|| '''Definition''' || '''Purpose''' ||
2.12 +|| `LDAP_SERVICE_BIND_DN` || LDAP user identity to connect to the service ||
2.13 +|| `LDAP_SERVICE_PASSWORD` || LDAP user password for connection ||
2.14 +|| `LDAP_HOST` || The host providing the LDAP service ||
2.15 +|| `LDAP_PORT` || The port number of the LDAP service ||
2.16 +|| `LDAP_BASE_DN` || The section of the database to search ||
2.17 +
2.18 +== Using LDAP with Exim ==
2.19 +
2.20 +Example configuration files for Exim are distributed in `conf/exim/ldap`:
2.21 +
2.22 +{{{#!table
2.23 +'''File''' || '''Purpose'''
2.24 +==
2.25 +`010_exim4-config_ldap_people_outgoing`
2.26 +||<rowspan="4"> Defines recipients and outgoing mail routing
2.27 +==
2.28 +`020_exim4-config_ldap_people`
2.29 +==
2.30 +`020_exim4-config_ldap_resources`
2.31 +==
2.32 +`020_exim4-config_ldap_people_outgoing_recipients`
2.33 +}}}
2.34 +
2.35 +These files can be incorporated into the Exim configuration. On Debian
2.36 +systems, they can be copied into `/etc/exim4/conf.d/router`.
2.37 +
2.38 +== Using LDAP with Postfix ==
2.39 +
2.40 +Example configuration files for Postfix are distributed in `conf/postfix/ldap`:
2.41 +
2.42 +{{{#!table
2.43 +'''File''' || '''Purpose'''
2.44 +==
2.45 +`main.cf.example`
2.46 +|| Defines recipients and outgoing mail routing (for inclusion in `main.cf`)
2.47 +==
2.48 +`virtual_alias_maps_people.cf`
2.49 +||<rowspan="3"> Defines recipients and outgoing mail routing
2.50 +==
2.51 +`virtual_alias_maps_people_outgoing.cf`
2.52 +==
2.53 +`virtual_alias_maps_resources.cf`
2.54 +}}}
2.55 +
2.56 +These files can be incorporated into the Postfix configuration. On Debian
2.57 +systems, `main.cf.example` can be merged into `/etc/postfix/main.cf`,
2.58 +whereas the remaining files would be installed into `/etc/postfix/ldap`.
2.59 +
2.60 +== LDAP Representations for Mail Recipients ==
2.61 +
2.62 +Relevant LDAP resources for structuring recipient information include the
2.63 +following:
2.64 +
2.65 +{{{#!table
2.66 +'''RFC''' || '''Relevance'''
2.67 +==
2.68 +[[http://tools.ietf.org/html/rfc4524|RFC 4524]]
2.69 +|| Defines the `mail` attribute
2.70 +==
2.71 +[[http://tools.ietf.org/html/rfc2798|RFC 2798]]
2.72 +|| Defines the `inetOrgPerson` object class
2.73 +==
2.74 +[[https://tools.ietf.org/html/rfc2739|RFC 2739]]
2.75 +|| Defines the `calEntry` object class supporting `calFBURL`
2.76 +}}}
2.77 +
2.78 +An additional draft RFC describes the `mailRecipient` object class:
2.79 +
2.80 + * https://tools.ietf.org/html/draft-lachman-ldap-mail-routing-03
2.81 +
2.82 +Resource schemas for LDAP are not effectively standardised for the purposes of
2.83 +this software. A useful object class, `inetResource`, was defined for the
2.84 +iPlanet Calendar Server:
2.85 +
2.86 + * http://docs.oracle.com/cd/E19566-01/819-4437/6n6jckqrf/index.html#anocg
2.87 + * http://docs.oracle.com/cd/E19566-01/819-4437/6n6jckqr8/index.html
2.88 +
2.89 +Although Kolab maintains notions of resources, they are tied up with the
2.90 +notion of a shared folder and the `kolabSharedFolder` object class, although the
2.91 +`mailRecipient` object class is employed by resources in Kolab.
3.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
3.2 +++ b/docs/wiki/MailIntegration--Simple Tue Oct 27 21:17:11 2015 +0100
3.3 @@ -0,0 +1,58 @@
3.4 += Simple Mail Integration =
3.5 +
3.6 +Since the use of [[../LDAP|LDAP]] can be somewhat challenging and also excessive
3.7 +in some situations, examples of maintaining recipient information are provided
3.8 +that use an approach involving simple textual lists of identities.
3.9 +
3.10 +In this simpler environment, recipient details must be manually edited in the
3.11 +virtual identity files, but this permits a very transparent way of
3.12 +administering the system.
3.13 +
3.14 +== Using Lists with Exim ==
3.15 +
3.16 +Example configuration file for Exim are distributed in `conf/exim/simple`:
3.17 +
3.18 +{{{#!table
3.19 +'''File''' || '''Purpose'''
3.20 +==
3.21 +`010_exim4-config_people_outgoing`
3.22 +||<rowspan="4"> Defines recipients and outgoing mail routing
3.23 +==
3.24 +`020_exim4-config_people`
3.25 +==
3.26 +`020_exim4-config_resources`
3.27 +==
3.28 +`020_exim4-config_people_outgoing_recipients`
3.29 +==
3.30 +`virtual_people`
3.31 +||<rowspan="3"> Defines recipient identities belonging to known domains
3.32 +==
3.33 +`virtual_people_outgoing_recipients`
3.34 +==
3.35 +`virtual_resources`
3.36 +==
3.37 +`virtual_domains`
3.38 +|| Defines recipient domains
3.39 +==
3.40 +`virtual_people_local`
3.41 +|| Defines recipients and local users for delivery to local mailboxes
3.42 +}}}
3.43 +
3.44 +== Using Lists with Postfix ==
3.45 +
3.46 +Example configuration file for Postfix are distributed in `conf/postfix/simple`:
3.47 +
3.48 +{{{#!table
3.49 +'''File''' || '''Purpose'''
3.50 +==
3.51 +`main.cf.example`
3.52 +|| Defines recipients and outgoing mail routing (for inclusion in `main.cf`)
3.53 +==
3.54 +`virtual_alias_maps`
3.55 +||<rowspan="2"> Defines recipients and outgoing mail routing
3.56 +==
3.57 +`virtual_alias_maps_people_outgoing`
3.58 +==
3.59 +`virtual_alias_maps_local`
3.60 +|| Defines recipients and local users for delivery to local mailboxes
3.61 +}}}