diff --git a/.env.dist b/.env.dist index ca349df3..a30871a7 100644 --- a/.env.dist +++ b/.env.dist @@ -94,6 +94,20 @@ Enabled by ENABLE_POSTFIX_VIRTUAL_TRANSPORT. Specify the final delivery of postf # etc. POSTFIX_DAGENT= +# Enables a report being sent (created by pflogsumm) on a regular basis. +# **0** => Report emails are disabled +# 1 => Using POSTMASTER_ADDRESS as the recipient +# => Specify the recipient address +REPORT_RECIPIENT=0 + +# Changes the interval in which a report is being sent. +# **daily** => Send a daily report +# weekly => Send a report every week +# monthly => Send a report every month +# +# Note: This Variable actually controls logrotate inside the container and rotates the log depending on this setting. The main log output is still available in its entirety via `docker logs mail` (Or your respective container name). If you want to control logrotation for the docker generated logfile see: [Docker Logging Drivers](https://docs.docker.com/config/containers/logging/configure/) +REPORT_INTERVAL=daily + # ----------------------------------------------------------------------------------------------------------------------------- # --------------------- Spamassassin section ---------------------------------------------------------------------------------- # ----------------------------------------------------------------------------------------------------------------------------- diff --git a/Dockerfile b/Dockerfile index 547f0ca4..0344ece7 100644 --- a/Dockerfile +++ b/Dockerfile @@ -50,6 +50,7 @@ RUN apt-get update -q --fix-missing && \ opendkim-tools \ opendmarc \ pax \ + pflogsumm \ p7zip-full \ postfix-ldap \ postfix-pcre \ @@ -197,6 +198,7 @@ RUN sed -i -r "/^#?compress/c\compress\ncopytruncate" /etc/logrotate.conf && \ sed -i -r 's|UpdateLogFile /var/log/clamav/|UpdateLogFile /var/log/mail/|g' /etc/clamav/freshclam.conf && \ sed -i -r 's|/var/log/clamav|/var/log/mail|g' /etc/logrotate.d/clamav-daemon && \ sed -i -r 's|/var/log/clamav|/var/log/mail|g' /etc/logrotate.d/clamav-freshclam && \ + sed -i -r '/\/var\/log\/mail\/mail.log/d' /etc/logrotate.d/rsyslog && \ sed -i -r 's|/var/log/mail|/var/log/mail/mail|g' /etc/logrotate.d/rsyslog && \ # prevent syslog logrotate warnings \ sed -i -e 's/\(printerror "could not determine current runlevel"\)/#\1/' /usr/sbin/invoke-rc.d && \ diff --git a/Makefile b/Makefile index 434e796a..0e942cfe 100644 --- a/Makefile +++ b/Makefile @@ -25,6 +25,7 @@ run: -e ENABLE_CLAMAV=1 \ -e SPOOF_PROTECTION=1 \ -e ENABLE_SPAMASSASSIN=1 \ + -e REPORT_RECIPIENT=user1@localhost.localdomain \ -e SA_TAG=-5.0 \ -e SA_TAG2=2.0 \ -e SA_KILL=3.0 \ diff --git a/README.md b/README.md index b98cf60f..25430596 100644 --- a/README.md +++ b/README.md @@ -311,6 +311,22 @@ Enabled by ENABLE_POSTFIX_VIRTUAL_TRANSPORT. Specify the final delivery of postf - drop => Drop the connection immediately with a 521 SMTP reply. Repeat this test the next time the client connects. - ignore => Ignore the failure of this test. Allow other tests to complete. Repeat this test the next time the client connects. This option is useful for testing and collecting statistics without blocking mail. +##### REPORT_RECIPIENT + + Enables a report being sent (created by pflogsumm) on a regular basis. + - **0** => Report emails are disabled + - 1 => Using POSTMASTER_ADDRESS as the recipient + - => Specify the recipient address + +##### REPORT_INTERVAL + + changes the interval in which a report is being sent. + - **daily** => Send a daily report + - weekly => Send a report every week + - monthly => Send a report every month + +Note: This Variable actually controls logrotate inside the container and rotates the log depending on this setting. The main log output is still available in its entirety via `docker logs mail` (Or your respective container name). If you want to control logrotation for the docker generated logfile see: [Docker Logging Drivers](https://docs.docker.com/config/containers/logging/configure/) + ## Spamassassin ##### ENABLE_SPAMASSASSIN diff --git a/docker-compose.elk.yml.dist b/docker-compose.elk.yml.dist index ba9e9c3c..40c41523 100644 --- a/docker-compose.elk.yml.dist +++ b/docker-compose.elk.yml.dist @@ -26,6 +26,8 @@ services: - OVERRIDE_HOSTNAME=${OVERRIDE_HOSTNAME} - POSTMASTER_ADDRESS=${POSTMASTER_ADDRESS} - POSTSCREEN_ACTION=${POSTSCREEN_ACTION} + - REPORT_RECIPIENT=${REPORT_RECIPIENT} + - REPORT_INTERVAL=${REPORT_INTERVAL} - SMTP_ONLY=${SMTP_ONLY} - SSL_TYPE=${SSL_TYPE} - PERMIT_DOCKER=${PERMIT_DOCKER} diff --git a/docker-compose.yml.dist b/docker-compose.yml.dist index d5924466..18d17584 100644 --- a/docker-compose.yml.dist +++ b/docker-compose.yml.dist @@ -24,6 +24,8 @@ services: - OVERRIDE_HOSTNAME=${OVERRIDE_HOSTNAME} - POSTMASTER_ADDRESS=${POSTMASTER_ADDRESS} - POSTSCREEN_ACTION=${POSTSCREEN_ACTION} + - REPORT_RECIPIENT=${REPORT_RECIPIENT} + - REPORT_INTERVAL=${REPORT_INTERVAL} - SMTP_ONLY=${SMTP_ONLY} - SSL_TYPE=${SSL_TYPE} - TLS_LEVEL=${TLS_LEVEL} diff --git a/target/bin/postfix-summary b/target/bin/postfix-summary new file mode 100644 index 00000000..b925d380 --- /dev/null +++ b/target/bin/postfix-summary @@ -0,0 +1,18 @@ +#!/bin/bash + +HOSTNAME=$1 +RECIPIENT=$2 + +errex() { + echo -e "$@" 1>&2 + exit 1 +} + +test -x /usr/sbin/pflogsumm || errex "Critical: /usr/sbin/pflogsumm not found" + +BODY="Subject: Postfix Summary for $HOSTNAME\n\n" +# The case that the mail.log.1 file isn't readable shouldn't actually be possible with logrotate not rotating empty files.. But you never know! +[ -r "/var/log/mail/mail.log.1" ] \ + && BODY="$BODY"$(/usr/sbin/pflogsumm /var/log/mail/mail.log.1 --problems-first) \ + || BODY="$BODY Error: Mail log not readable or not found: /var/log/mail/mail.log.1\n\nIn case of mail inactivity since the last report, this might be considered a nuisance warning.\n\nYours faithfully, The $HOSTNAME Mailserver" +echo -e "$BODY" | sendmail -f "mailserver-report@$HOSTNAME" "$RECIPIENT" diff --git a/target/start-mailserver.sh b/target/start-mailserver.sh index da056410..c3c1b917 100644 --- a/target/start-mailserver.sh +++ b/target/start-mailserver.sh @@ -27,6 +27,8 @@ DEFAULT_VARS["POSTMASTER_ADDRESS"]="${POSTMASTER_ADDRESS:="postmaster@domain.com DEFAULT_VARS["POSTSCREEN_ACTION"]="${POSTSCREEN_ACTION:="enforce"}" DEFAULT_VARS["SPOOF_PROTECTION"]="${SPOOF_PROTECTION:="0"}" DEFAULT_VARS["TLS_LEVEL"]="${TLS_LEVEL:="modern"}" +DEFAULT_VARS["REPORT_RECIPIENT"]="${REPORT_RECIPIENT:="0"}" +DEFAULT_VARS["REPORT_INTERVAL"]="${REPORT_INTERVAL:="daily"}" ########################################################################## # << DEFAULT VARS ########################################################################## @@ -135,6 +137,11 @@ function register_functions() { fi _register_setup_function "_setup_environment" + _register_setup_function "_setup_logrotate" + + if [ "$REPORT_RECIPIENT" != 0 ]; then + _register_setup_function "_setup_mail_summary" + fi ################### << setup funcs @@ -1085,6 +1092,34 @@ function _setup_elk_forwarder() { > /etc/filebeat/filebeat.yml } +function _setup_logrotate() { + notify 'inf' "Setting up logrotate" + + LOGROTATE="/var/log/mail/mail.log\n{\n compress\n copytruncate\n delaycompress\n" + case "$REPORT_INTERVAL" in + "daily" ) + notify 'inf' "Setting postfix summary interval to daily" + LOGROTATE="$LOGROTATE rotate 1\n daily\n" + ;; + "weekly" ) + notify 'inf' "Setting postfix summary interval to weekly" + LOGROTATE="$LOGROTATE rotate 1\n weekly\n" + ;; + "monthly" ) + notify 'inf' "Setting postfix summary interval to monthly" + LOGROTATE="$LOGROTATE rotate 1\n monthly\n" + ;; + esac + LOGROTATE="$LOGROTATE}" + echo -e "$LOGROTATE" > /etc/logrotate.d/maillog +} + +function _setup_mail_summary() { + notify 'inf' "Enable postfix summary with recipient $REPORT_RECIPIENT" + [ "$REPORT_RECIPIENT" = 1 ] && REPORT_RECIPIENT=$POSTMASTER_ADDRESS + sed -i "s|}| postrotate\n /usr/local/bin/postfix-summary $HOSTNAME $REPORT_RECIPIENT\n endscript\n}\n|" /etc/logrotate.d/maillog +} + function _setup_environment() { notify 'task' 'Setting up /etc/environment' diff --git a/test/tests.bats b/test/tests.bats index cec75373..6db58ac4 100644 --- a/test/tests.bats +++ b/test/tests.bats @@ -1465,6 +1465,22 @@ load 'test_helper/bats-assert/load' assert_output 1 } +# +# Pflogsumm delivery check +# + +@test "checking pflogsum delivery" { + # checking logrotation working and report being sent + docker exec mail logrotate --force /etc/logrotate.d/maillog + sleep 10 + run docker exec mail grep "Subject: Postfix Summary for " /var/mail/localhost.localdomain/user1/new/ -R + assert_success + # checking default logrotation setup + run docker exec mail_with_ldap grep "daily" /etc/logrotate.d/maillog + assert_success +} + + # # PCI compliance #