imip-agent

Annotated docs/wiki/MailIntegration--Simple

1053:068aa85f0c45
983:dbbff7484fea
2016-02-08 Paul Boddie file changeset files shortlog Made the retraction operation a complete transaction. Tidied up the locking and unlocking function application.
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`.