imip-agent

Annotated docs/wiki/MailIntegration--Simple

1122:2003934ef901
983:dbbff7484fea
2016-04-19 Paul Boddie file changeset files shortlog Support replies from attendees that refer to specific recurrences before the organiser does so, thus allowing attendees to selectively accept and decline recurrences. Allowed the test handler to refer to recurrences that have not been explicitly separated from their parent objects. Added a docstring for the Object initialiser as a reminder of how to use it. freebusy-collections
paul@951 1 
= Simple Mail Integration =
paul@951 2 
 
 paul@951      3 
Since the use of [[../LDAP|LDAP]] can be somewhat challenging and also excessive
 
 paul@951      4 
in some situations, examples of maintaining recipient information are provided
 
 paul@951      5 
that use an approach involving simple textual lists of identities.
 
 paul@951      6 
 
 paul@951      7 
In this simpler environment, recipient details must be manually edited in the
 
 paul@951      8 
virtual identity files, but this permits a very transparent way of
 
 paul@951      9 
administering the system.
 
 paul@951     10 
 
 paul@951     11 
== Using Lists with Exim ==
 
 paul@951     12 
 
 paul@963     13 
Example configuration files for Exim are distributed in `conf/exim/simple`:
 
 paul@951     14 
 
 paul@951     15 
{{{#!table
 
 paul@951     16 
'''File''' || '''Purpose'''
 
 paul@951     17 
==
 
 paul@951     18 
`010_exim4-config_people_outgoing`
 
 paul@951     19 
||<rowspan="4"> Defines recipients and outgoing mail routing
 
 paul@951     20 
==
 
 paul@951     21 
`020_exim4-config_people`
 
 paul@951     22 
==
 
 paul@951     23 
`020_exim4-config_resources`
 
 paul@951     24 
==
 
 paul@951     25 
`020_exim4-config_people_outgoing_recipients`
 
 paul@951     26 
==
 
 paul@951     27 
`virtual_people`
 
 paul@976     28 
||<rowspan="2"> Defines recipient identities belonging to known domains
 
 paul@951     29 
==
 
 paul@951     30 
`virtual_resources`
 
 paul@951     31 
==
 
 paul@951     32 
`virtual_domains`
 
 paul@951     33 
|| Defines recipient domains
 
 paul@971     34 
}}}
 
 paul@971     35 
 
 paul@975     36 
Where [[../LocalSMTP|local SMTP routing]] is being performed ''and'' the
 
 paul@975     37 
recipients are local system users, the following files are also useful:
 
 paul@971     38 
 
 paul@971     39 
{{{#!table
 
 paul@971     40 
'''File''' || '''Purpose'''
 
 paul@971     41 
==
 
 paul@975     42 
`020_exim4-config_people_local_system`
 
 paul@975     43 
|| Defines routing for local recipients for delivery to mailboxes for local
 
 paul@975     44 
.. system users
 
 paul@951     45 
==
 
 paul@975     46 
`virtual_people_local_system`
 
 paul@974     47 
|| Defines recipients for delivery to mailboxes for local system users
 
 paul@951     48 
}}}
 
 paul@951     49 
 
 paul@955     50 
These files can be incorporated into the Exim configuration. On Debian
 
 paul@955     51 
systems, the numbered files can be copied into `/etc/exim4/conf.d/router`,
 
 paul@971     52 
whereas the `virtual` files can be copied into `/etc/exim4`.
 
 paul@955     53 
 
 paul@951     54 
== Using Lists with Postfix ==
 
 paul@951     55 
 
 paul@963     56 
Example configuration files for Postfix are distributed in `conf/postfix/simple`:
 
 paul@951     57 
 
 paul@951     58 
{{{#!table
 
 paul@951     59 
'''File''' || '''Purpose'''
 
 paul@951     60 
==
 
 paul@951     61 
`main.cf.example`
 
 paul@951     62 
|| Defines recipients and outgoing mail routing (for inclusion in `main.cf`)
 
 paul@951     63 
==
 
 paul@951     64 
`virtual_alias_maps`
 
 paul@951     65 
||<rowspan="2"> Defines recipients and outgoing mail routing
 
 paul@951     66 
==
 
 paul@951     67 
`virtual_alias_maps_people_outgoing`
 
 paul@971     68 
}}}
 
 paul@971     69 
 
 paul@980     70 
Where [[../LocalSMTP|local SMTP routing]] is being performed, the following
 
 paul@983     71 
file is also useful:
 
 paul@971     72 
 
 paul@971     73 
{{{#!table
 
 paul@971     74 
'''File''' || '''Purpose'''
 
 paul@951     75 
==
 
 paul@976     76 
`virtual_alias_maps_local_system`
 
 paul@976     77 
|| Defines recipients for delivery to mailboxes for local system users
 
 paul@983     78 
.. (installed into `/etc/postfix/simple`)
 
 paul@951     79 
}}}
 
 paul@955     80 
 
 paul@978     81 
The following files are common to [[../LDAP|LDAP]] and simple integration
 
 paul@978     82 
and are found in `conf/postfix`:
 
 paul@978     83 
 
 paul@978     84 
{{{#!table
 
 paul@978     85 
'''File''' || '''Purpose'''
 
 paul@978     86 
==
 
 paul@978     87 
`master.cf.items`
 
 paul@978     88 
|| Mail handler definitions for the imip-agent transports
 
 paul@978     89 
==
 
 paul@978     90 
`transport`
 
 paul@978     91 
|| Transport definitions for `/etc/postfix/transport`
 
 paul@978     92 
==
 
 paul@978     93 
`virtual`
 
 paul@978     94 
|| Outgoing message routing for `/etc/postfix/virtual`
 
 paul@978     95 
}}}
 
 paul@978     96 
 
 paul@978     97 
These files can be incorporated into the Postfix configuration. On Debian
 
 paul@978     98 
systems, `master.cf.items` can be merged into `/etc/postfix/master.cf`,
 
 paul@978     99 
whereas the other files can be merged into any existing files of the same
 
 paul@978    100 
names in `/etc/postfix`.