J2EE 整合 Symantec 防毒掃描引擎 (SAV Scan Engine) 實戰指南

前言

企業級應用常需掃描上傳檔案防止惡意程式。Symantec Scan Engine (SSE) 提供高效能防毒掃描服務，支援 ICAP 協定。本文記錄在 J2EE 環境整合 SSE 的步驟與程式碼範例。

環境準備

1. 安裝 SSE：下載試用版 Symantec Scan Engine，安裝 JDK 5、ScanEngine.exe，設定管理埠與授權檔。
2. 授權檔部署：透過 Web Console (https://ip:8004/) 安裝，或複製至 C:\Program Files\Common Files\Symantec Shared\Licenses。
3. 啟用 ICAP：SSE 預設監聽 icap://host:1344/avscan。

Java 客戶端整合

官方提供 virus-scan-connect.jar (內含 VirusScanManager) 封裝 ICAP 通訊細節。

Maven 依賴 (本地安裝)

mvn install:install-file -Dfile=virus-scan-connect.jar -DgroupId=com.symantec -DartifactId=sav-client -Dversion=5.1 -Dpackaging=jar

掃描程式碼範例

import com.symantec.sav.VirusScanManager;
import java.io.*;

public class VirusScanClient {
    private static final String ICAP_URL = "icap://10.225.69.89:1344/avscan";

    public static void main(String[] args) {
        VirusScanManager vsm = new VirusScanManager(ICAP_URL);
        File testFile = new File("./test/eicar.com.txt"); // EICAR 測試病毒檔
        try (InputStream in = new FileInputStream(testFile)) {
            // 檔名、MIME型態、輸入流
            vsm.processScanVirus("eicarTestFile.txt", "text/plain", in);
            System.out.println("掃描完成，未發現病毒。");
        } catch (Exception e) {
            // 捕獲病毒異常或連線錯誤
            System.err.println("掃描失敗或檢測到病毒: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

關鍵類別說明

• VirusScanManager(String icapUrl)：建立與掃描伺服器的連線池。
• processScanVirus(String filename, String mimeType, InputStream content)：同步阻塞式掃描，檢測到病毒會拋出例外。
• 支援多執行緒並發，生產環境建議配合連線池與非同步佇列處理大量檔案。

部署注意事項

• 防火牆需開放應用伺服器至 SSE 的 TCP 1344 埠。
• SSE 掃描耗時與檔案大小成正比，大檔案建議非同步處理並提供進度查詢介面。
• 定期更新病毒碼特徵庫，可透過 SSE 管理主控台排程自動更新。

整合成熟的企業級防毒引擎，能有效降低惡意檔案風險，符合合規需求。