Keine Abwesenheiten eingetragen.
+| Wer | Vertretung | Zeitraum | Stand | Tickets | Die Vertretung sieht | |
|---|---|---|---|---|---|---|
| + | + | – | ++ | + | + | + + + + | +
| Wer | Vertretung | Zeitraum | Ergebnis | Weitergegeben |
|---|---|---|---|---|
| – | Tickets |
Der Anhang ' . e($name) . ' in Ticket #' . e($number) . ' wurde gesperrt (' . e($detail) . ').
Er liegt in der Quarantäne. Prüfen oder löschen kannst du ihn unter VirusTotal im Mitarbeiterbereich.
'); + } catch (Throwable $e) { + // Mailfehler dürfen das Sperren nie verhindern + } +} + +/** Löscht eine zurückgehaltene oder gesperrte Datei endgültig (der Anhang bleibt als „gelöscht“ im Ticket vermerkt). */ +function vt_delete(PDO $pdo, int $rowId): bool +{ + $row = vt_row($pdo, $rowId); + if (!$row || !in_array($row['status'], ['bad', 'unknown', 'error', 'pending', 'analyzing'], true)) return false; + $file = vt_hold_dir() . '/' . basename((string) $row['stored_name']); + if (is_file($file)) @unlink($file); + $pdo->prepare('UPDATE ticket_attachments SET original_name = ? WHERE id = ?')->execute([mb_substr('[GELÖSCHT] ' . $row['original_name'], 0, 255), (int) $row['attachment_id']]); + $pdo->prepare("UPDATE plugin_virustotal_files SET status = 'deleted', detail = ?, checked_at = ? WHERE id = ?")->execute(['Gelöscht am ' . db_now(), db_now(), $rowId]); + return true; +} + +/** Von Hand freigeben (zum Beispiel bei Fehlalarm oder unbekannter Datei). */ +function vt_release_manual(PDO $pdo, int $rowId): bool +{ + $row = vt_row($pdo, $rowId); + if (!$row || !in_array($row['status'], ['bad', 'unknown', 'error', 'pending', 'analyzing'], true)) return false; + return vt_release($pdo, $row, 'released', 'Von Hand freigegeben am ' . db_now()); +} + +/** Noch einmal prüfen lassen (zum Beispiel nach einem Fehler). */ +function vt_recheck(PDO $pdo, int $rowId): bool +{ + $row = vt_row($pdo, $rowId); + if (!$row || !in_array($row['status'], ['unknown', 'error'], true)) return false; + $pdo->prepare("UPDATE plugin_virustotal_files SET status = 'pending', tries = 0, next_try = ?, detail = NULL, analysis_id = NULL WHERE id = ?")->execute([db_now(), $rowId]); + return true; +} + +// ── Hintergrundlauf ──────────────────────────────────────────────────────── + +function vt_day_used(): int +{ + $today = date('Y-m-d'); + if (plugin_setting(VT, 'day', '') !== $today) { plugin_set_setting(VT, 'day', $today); plugin_set_setting(VT, 'day_count', '0'); } + return (int) plugin_setting(VT, 'day_count', '0'); +} + +function vt_day_add(int $n = 1): void +{ + plugin_set_setting(VT, 'day_count', (string) (vt_day_used() + $n)); +} + +/** + * Entscheidung nach einer Abfrage. @return bool false = Lauf beenden (Tageslimit, Minutenlimit oder Schlüsselproblem) + */ +function vt_apply(PDO $pdo, array $row, array $res, array $cfg): bool +{ + $soon = fn(int $sec) => date('Y-m-d H:i:s', time() + $sec); + switch ($res['result']) { + case 'limit': + $pdo->prepare('UPDATE plugin_virustotal_files SET next_try = ? WHERE id = ?')->execute([$soon(60), $row['id']]); + return false; + case 'key': + plugin_set_setting(VT, 'last_error', db_now() . ': ' . $res['detail']); + return false; + case 'error': + plugin_set_setting(VT, 'last_error', db_now() . ': ' . $res['detail']); + $tries = (int) $row['tries'] + 1; + if ($tries >= 6) { + if ($cfg['on_error'] === 'allow') vt_release($pdo, $row, 'released', 'VirusTotal nicht erreichbar, freigegeben (Einstellung)'); + else $pdo->prepare("UPDATE plugin_virustotal_files SET status = 'error', detail = ?, tries = ?, checked_at = ? WHERE id = ?")->execute([mb_substr((string) $res['detail'], 0, 250), $tries, db_now(), $row['id']]); + } else { + $pdo->prepare('UPDATE plugin_virustotal_files SET tries = ?, next_try = ?, detail = ? WHERE id = ?')->execute([$tries, $soon(min(3600, 60 * (2 ** $tries))), mb_substr((string) $res['detail'], 0, 250), $row['id']]); + } + return true; + case 'bad': + plugin_set_setting(VT, 'last_error', ''); + vt_block($pdo, $row, (string) $res['detail'], (int) $res['malicious'], (int) $res['engines']); + return true; + case 'clean': + plugin_set_setting(VT, 'last_error', ''); + vt_release($pdo, $row, 'clean', (string) ($res['detail'] ?? 'VirusTotal: keine Funde')); + $pdo->prepare('UPDATE plugin_virustotal_files SET malicious = ?, engines = ? WHERE id = ?')->execute([(int) $res['malicious'], (int) $res['engines'], $row['id']]); + return true; + case 'wait': + if (time() - (int) strtotime((string) $row['created_at']) > 3600) { + $pdo->prepare("UPDATE plugin_virustotal_files SET status = 'error', detail = ?, checked_at = ? WHERE id = ?")->execute(['Die Analyse bei VirusTotal wurde nicht rechtzeitig fertig.', db_now(), $row['id']]); + } else { + $pdo->prepare('UPDATE plugin_virustotal_files SET next_try = ? WHERE id = ?')->execute([$soon(60), $row['id']]); + } + return true; + default: // unknown oder none: VirusTotal kennt die Datei (noch) nicht + $path = vt_hold_dir() . '/' . basename((string) $row['stored_name']); + $size = is_file($path) ? (int) filesize($path) : 0; + if ($cfg['upload'] && $size > 0 && $size <= VT_UPLOAD_MAX && $row['status'] === 'pending') { + $up = vt_upload($path, (string) $row['original_name'], $cfg['key']); + vt_day_add(); + if (!$up['ok']) { + if ($up['detail'] === 'limit') { $pdo->prepare('UPDATE plugin_virustotal_files SET next_try = ? WHERE id = ?')->execute([$soon(60), $row['id']]); return false; } + return vt_apply($pdo, $row, ['result' => 'error', 'detail' => $up['detail'], 'malicious' => 0, 'engines' => 0], $cfg); + } + $pdo->prepare("UPDATE plugin_virustotal_files SET status = 'analyzing', analysis_id = ?, next_try = ?, detail = 'Zur Analyse bei VirusTotal hochgeladen' WHERE id = ?")->execute([$up['id'], $soon(60), $row['id']]); + return true; + } + if ($cfg['unknown'] === 'allow') { + vt_release($pdo, $row, 'released', 'Bei VirusTotal unbekannt, freigegeben (Einstellung)'); + return true; + } + $why = $cfg['upload'] && $size > VT_UPLOAD_MAX ? 'Bei VirusTotal unbekannt und zu groß für den Upload (über 32 MB).' : 'Bei VirusTotal unbekannt: bitte selbst prüfen und freigeben oder löschen.'; + $pdo->prepare("UPDATE plugin_virustotal_files SET status = 'unknown', detail = ?, checked_at = ? WHERE id = ?")->execute([$why, db_now(), $row['id']]); + if ((int) $row['ticket_id'] > 0) log_activity($pdo, (int) $row['ticket_id'], null, 'VirusTotal: Anhang bleibt gesperrt (unbekannt): ' . $row['original_name']); + return true; + } +} + +/** + * Hintergrundlauf (jede Minute oder alle 5 Minuten): zurückgehaltene Anhänge abfragen, höchstens 4 pro Lauf (Grenze des kostenlosen + * Schlüssels) und 480 pro Tag. @return int Zahl der Abfragen + */ +function vt_tick(PDO $pdo): int +{ + $cfg = vt_config(); + if ($cfg['key'] === '') return 0; + // Zwei Auslöser (jede Minute und alle 5 Minuten) sollen sich nicht überlappen + if (time() - (int) plugin_setting(VT, 'tick_at', '0') < 25) return 0; + plugin_set_setting(VT, 'tick_at', (string) time()); + // Anhänge, die kein Ereignis gemeldet hat (zum Beispiel aus E-Mails), nachträglich zurückhalten + foreach (vt_unseen($pdo, 25) as $att) vt_hold($pdo, $att); + $rows = $pdo->prepare("SELECT * FROM plugin_virustotal_files WHERE status IN ('pending','analyzing') AND next_try <= ? ORDER BY id LIMIT 4"); + $rows->execute([db_now()]); + $done = 0; + foreach ($rows->fetchAll() as $row) { + if (vt_day_used() >= VT_DAY_LIMIT) { plugin_set_setting(VT, 'last_error', db_now() . ': Das Tageslimit des VirusTotal-Schlüssels ist erreicht, es geht morgen weiter.'); break; } + $res = $row['status'] === 'analyzing' && $row['analysis_id'] + ? vt_analysis((string) $row['analysis_id'], $cfg['key'], $cfg['threshold']) + : vt_lookup((string) $row['sha256'], $cfg['key'], $cfg['threshold']); + vt_day_add(); + $done++; + $pdo->prepare('UPDATE plugin_virustotal_files SET checked_at = ? WHERE id = ?')->execute([db_now(), $row['id']]); + if (!vt_apply($pdo, $row, $res, $cfg)) break; + } + if ($done > 0) plugin_set_setting(VT, 'last_run', db_now()); + return $done; +} + +/** Zahlen für die Seite. @return arrayNoch kein Schlüssel. Ohne VirusTotal-Schlüssel werden Anhänge nicht zurückgehalten und nicht geprüft. Einen kostenlosen Schlüssel gibt es nach der Anmeldung bei virustotal.com im Profil unter „API Key“.
+ +✓ Aktiv. Neue Anhänge sind gesperrt, bis VirusTotal sie geprüft hat.
+ ++ warten · + gesperrt · + unbekannt · + mit Fehler · + freigegeben +
+Abfragen heute: von (der kostenlose Schlüssel erlaubt 4 pro Minute und 500 pro Tag). Letzter Lauf: .
+ +Vorgehen: Jeder neue Anhang wird sofort zurückgehalten (nicht herunterladbar). Dann fragt das Plugin bei VirusTotal nur den Fingerabdruck (SHA-256) der Datei ab. Ist die Datei bekannt und sauber, wird sie freigegeben; melden mindestens Scanner Schadsoftware, bleibt sie gesperrt. Anhänge, die schon vor dem Einschalten da waren, bleiben unberührt.
+Nichts zurückgehalten.
+ +| Datei | Ticket | Größe | Zustand | Hinweis | |
|---|---|---|---|---|---|
| + | # | ++ | + | + | + + + + | +
Noch nichts geprüft.
+ +| Datei | Zustand | Ergebnis | Wann |
|---|---|---|---|