Postfix

There's one way (till now) to integrate Spider with Postfix, more options will be offered in future release.

The Always BCC Approch

Spider Email Archiver has a builtin SMTP server that listens on port 25 by default, Postfix can be configured to forward a copy of all received and sent emails to this port with the always_bcc parameter.

REQUIRED: Add parameter always_bcc in Postfix config file /etc/postfix/main.cf, set its value to the Archiving Address.
```
always_bcc = archive@archive.mydomain.com
```
REQUIRED: Update parameter transport_maps, insert a hash map file /etc/postfix/transport:
```
transport_maps = hash:/etc/postfix/transport, ...
```
REQUIRED: Create (or open existing) /etc/postfix/transport file, append transport for Spider server hostname archive.mydomain.com:
```
archive.mydomain.com smtp:[192.168.1.1]:25
```
If you use host IP address as archiving domain name, it's required to add transport for host IP (Spider server) too. For example:
```
# - IP address must be surrounded by [ and ].
# - 192.168.1.1 is the IP address of Spider server.
[192.168.1.1] smtp:[192.168.1.1]:25
```
REQUIRED: Run command:
```
postmap hash:/etc/postfix/transport
```
OPTIONAL BUT HIGHLY RECOMMENDED: Update smtpd_recipient_restrictions to add a check_recipient_access rule to always prepend X-Envelope-To: header with the final delivery address:

WARNING:

Spider collects final recipient addresses from X-Envelope-To: header, if it doesn't exist, To:, Cc:, Bcc: are used instead, this causes Spider considers email alias/forwarding addresses as a mailbox and counts in license.
```
smtpd_recipient_restrictions =
    ...
    reject_non_fqdn_recipient
    reject_unlisted_recipient
    check_recipient_access pcre:/etc/postfix/recipient_access.pcre
    ...
```
Create file /etc/postfix/recipient_access.pcre with content below:
```
/(.*)/  prepend X-Envelope-To: $1
```
OPTIONAL: If you choose to enable SMTP authentiction in Spider, you must configure Postfix to perform smtp authentiction.
- Add or append below settings in Postfix config file /etc/postfix/main.cf:
```
smtp_sasl_password_maps = hash:/etc/postfix/sasl_password
smtp_sasl_auth_enable = yes
smtp_sasl_mechanism_filter = plain login
smtp_sasl_security_options = noanonymous
```
- Write the smtp username and password in /etc/postfix/sasl_password (Note: repleace user:password by the ones you set in Spider settings: SMTP Listener):
```
archiving.mydomain.com user:password
```
- Run shell commands:
```
postmap hash:/etc/postfix/sasl_password
```
Restart postfix service to load modified config files:
```
service postfix restart
```