1 = Local SMTP Delivery = 2 3 By employing local SMTP, the burden of routing messages to suitable storage 4 becomes a configuration problem within the mail system itself. 5 6 ######## A diagram summarising SMTP integration. 7 8 {{{#!graphviz 9 //format=svg 10 //transform=notugly 11 digraph local_smtp { 12 node [shape=box,fontsize="13.0",fontname="sans-serif",tooltip="Local SMTP delivery"]; 13 edge [tooltip="Local SMTP delivery"]; 14 rankdir=LR; 15 16 mail [label="Incoming mail",shape=folder,style=filled,fillcolor=cyan, 17 href="../../IncomingMessages"]; 18 19 subgraph { 20 rank=same; 21 personrouter [label="Person router"]; 22 localrouter [label="Local router"]; 23 recipients [label="Recipient database",shape=folder]; 24 } 25 26 subgraph { 27 rank=same; 28 personhandler [label="Person handler",style=filled,fillcolor=gold]; 29 localtransport [label="Local transport"]; 30 } 31 32 mailbox [label="Mailboxes\n(Cyrus, Dovecot, ...)",tooltip="Mailboxes", 33 href="../../MailboxIntegration"]; 34 35 mail -> personrouter -> personhandler; 36 37 recipients -> personrouter; 38 recipients -> localrouter; 39 40 personhandler -> localrouter -> localtransport -> mailbox; 41 } 42 }}} 43 44 ######## 45 46 Here, imip-agent connects to the mail transport agent (MTA) and sends a 47 message to an explicitly-indicated local user. For example: 48 49 {{{ 50 local+vincent.vole@example.com 51 }}} 52 53 == Local System Users == 54 55 With such a local user indicated, the message is then routed to a mail 56 delivery mechanism, perhaps by converting the local address to a local 57 system user identity (a user with an account on the system running the 58 software). For example: 59 60 {{{ 61 vole 62 }}} 63 64 The local delivery mechanism would then deposit the message in the user's 65 mailbox. MTAs typically provide such routing for local system users by 66 default. 67 68 == Mailbox/Virtual Users == 69 70 Alternatively, with a local user having been indicated, a message would be 71 routed for delivery by a mail storage solution which would accept the message 72 for the indicated user and deliver it to that user's mailbox. For example: 73 74 {{{ 75 vincent.vole 76 }}} 77 78 Where such routing is performed to mailbox providers employing LMTP, 79 some additional configuration effort may be required. See the 80 [[../../MailboxIntegration|mailbox integration guide]] for more details. 81 82 Some of the routing for explicitly-indicated local users is dependent on the 83 identification of users and is described in the 84 [[../../MailIntegration/LDAP|LDAP]] and [[../../MailIntegration/Simple|simple]] 85 integration guides.