Postfach Auf Viren Scannen #1

Lesezeit: 4 Minuten
Virenscanner
E-Mails auf Viren scannen

Die Möglichkeit eingehende E-Mails auf Viren zu scannen habe ich hier beschrieben. Dieser Artikel bezieht sich allerdings darauf, den Virenscan mit einer Regel im Mailclient Evolution einzurichten.
Das nachfolgende Python Script scannt allerdings das Postfach auf Viren bevor der Abruf der Mails startet.
Mit einigen Modifikationen lässt sich im Anschluss dann jeder beliebige Mailclient starten. Hierzu mehr im kommenden zweiten Teil.
Das unten stehende Script scannt lediglich das Postfach und legt eine Log Datei an.

Wie immer gilt:
Ich kann nicht garantieren das die beschriebene Vorgehensweise auf allen Linux Distributionen und mit allen Mailanbietern funktioniert. Bei meinem Linux Mint und meinem Hoster gibt es keinerlei Probleme.
Das Ausführen von Scripten und  Befehlen mittels "sudo" geschieht auf eigenes Risiko!
Ob ClamAV wirklich jeden Virus findet kann ich ebenfalls nicht garantieren.

Vorraussetzungen

ClamAV und der ClamAV-Daemon sind installiert.
Ist das nicht der Fall kann das mit dem folgenden Befehl im Terminal nachgeholt werden:
sudo apt update && sudo apt install clamav clamav-daemon

Da wir ein Python Script erstellen, müsst ihr ggf. auch Python3 über die Paketverwaltung installieren.

Das Script

Hinweise:
Der "Quarantine_Folder" sollte in eurem Postfach existieren. Bei mir heißt der Ordner "Virenverdacht".
Die Einstellungen am Beginn des Scripts wie IMAP_HOST etc. müssen mir euren Daten ersetzt werden.

#!/usr/bin/env python3
import email
import imaplib
import logging
import subprocess
import sys

IMAP_HOST = "Name des Imap Servers
IMAP_PORT = 143          # Use 993 for SSL, or 143 for STARTTLS
USE_STARTTLS = True      # Set to False if using port 993 (direct SSL)
EMAIL_USER = "Username für das Imap Postfach"
EMAIL_PASS = "Passwort für das Imap Postfach"
QUARANTINE_FOLDER = "Virenverdacht"
LOG_FILE = "/var/log/mail-clamav-scanner/imap_clamscan.log"

# Configure logging to file and console
logging.basicConfig(
    level=logging.INFO,
    format="%(asctime)s [%(levelname)s] %(message)s",
    datefmt="%Y-%m-%d %H:%M:%S",
    handlers=[
        logging.FileHandler(LOG_FILE),
        logging.StreamHandler(sys.stdout),
    ],
)


def get_subject(raw_bytes):
    """Extract email Subject safely for readable log entries."""
    try:
        msg = email.message_from_bytes(raw_bytes)
        return msg.get("Subject", "(No Subject)")
    except Exception:
        return "(Unreadable Subject)"


def scan_inbox():
    if USE_STARTTLS:
        mail = imaplib.IMAP4(IMAP_HOST, IMAP_PORT)
        mail.starttls()
    else:
        mail = imaplib.IMAP4_SSL(IMAP_HOST, IMAP_PORT)

    mail.login(EMAIL_USER, EMAIL_PASS)

    # Create Quarantine folder if it does not exist yet
    mail.create(QUARANTINE_FOLDER)
    mail.select("INBOX")

    # Search only unread emails
    status, messages = mail.search(None, "UNSEEN")
    if status != "OK" or not messages[0]:
        logging.info("Scan finished: 0 unread messages in INBOX.")
        mail.logout()
        return

    msg_ids = messages[0].split()
    logging.info(f"Scanning {len(msg_ids)} unread message(s)...")

    infected_count = 0
    clean_count = 0

    for num in msg_ids:
        _, msg_data = mail.fetch(num, "(BODY.PEEK[])")
        raw_email = msg_data[0][1]
        subject = get_subject(raw_email)

        # Scan via clamdscan using standard input
        proc = subprocess.run(
            ["clamdscan", "--no-summary", "-"],
            input=raw_email,
            capture_output=True,
        )

        # Exit code 0 = Clean, 1 = Virus detected, 2 = Error
        if proc.returncode == 0:
            clean_count += 1
            logging.info(f"CLEAN | ID {num.decode()} | Subject: {subject}")
        elif proc.returncode == 1:
            infected_count += 1
            virus_info = proc.stdout.decode(errors="ignore").strip()
            logging.warning(
                f"INFECTED ({virus_info}) | ID {num.decode()} | Subject: {subject} -> Moved to {QUARANTINE_FOLDER}"
            )
            mail.copy(num, QUARANTINE_FOLDER)
            mail.store(num, "+FLAGS", "\\Deleted")
        else:
            err_info = proc.stderr.decode(errors="ignore").strip()
            logging.error(f"SCAN ERROR | ID {num.decode()} | {err_info}")

    mail.expunge()
    mail.logout()
    logging.info(
        f"Scan complete: {clean_count} clean, {infected_count} quarantined."
    )


if __name__ == "__main__":
    try:
        scan_inbox()
    except Exception as e:
        logging.error(f"Fatal error scanning IMAP: {e}")
        sys.exit(1)

Das Script speichert ihr als clamav_imap.py in einem Verzeichnis eurer Wahl und gebt dem Script mittels chmod 700 dem Besitzer (also euch) den vollen Zugriff inkl. der Ausführbarkeit.
Im Terminal könnt ihr das Script mit dem folgenden Befehl ausführen:
python3 clamav_imap.py

Log Verzeichnis und Berechtigungen einrichten

Bitte bei den nachfolgenden Befehlen "dein_user" durch den Linux Benutzernamen ersetzen!

Terminal:
sudo mkdir -p /var/log/mail-clamav-scanner
sudo chown dein_user:dein_user /var/log/mail-clamav-scanner

Logrotate Konfiguration

Terminal:
sudo nano /etc/logrotate.d/mail-clamav-scanner

Folgenden Inhalt hinzufügen:
/var/log/mail-clamav-scanner/*.log {
    daily
    rotate 14
    compress
    delaycompress
    missingok
    notifempty
    create 0640 dein_user dein_user
}

Test der Logrotate Konfiguration:

Terminal:
sudo logrotate -d /etc/logrotate.d/mail-clamav-scanner
"-d" führte einen Trockenlauf durch. Mit "-f" würde die Rotation erzwungen.


Wie geht es weiter?

In einem Folgeartikel werde ich beschreiben wie das Script automatisch einen Mailclient startet.
Das Ganze wird dann als desktop Datei angelegt und schon wird automatisiert das Postfach auf E-Mails gescannt und anschließend das Mailprogramm gestartet.

Falls ihr Fragen oder Anregungen habt, dürft ihr gerne die Kommentarfunktion nutzen.

 

 

Kommentare