imip-agent

Annotated docs/wiki/MailIntegration--Simple

1024:48b37822d2a0
2016-01-29 Paul Boddie Moved common test initialisation into a separate script.
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`.