【実務・中級編】【上級者向け】添付ファイル保存時に「ウイルススキャン」を強制的に実行させる外部コマンド連携 – Outlook VBA解析バイブル

スポンサーリンク
スポンサーリンク

信頼をコードに刻め:Outlook VBAにおける「ゼロトラスト」添付ファイル処理アーキテクチャ

自動化エンジニアの諸君、現場で「とりあえずファイルを保存して、その後に別のプログラムで処理する」といった、設計の甘いコードを書いていないだろうか?

もし君が、企業の基幹システムや機密情報を扱う業務フローを設計しているのなら、その考えは極めて危険だ。添付ファイルは、組織のセキュリティ境界を突破するための最も古典的かつ強力な武器だ。単に「保存する」だけでは、そのファイルがマルウェアである可能性を排除できていない。

本稿では、Outlook VBAを用いて、添付ファイルを保存する瞬間に外部のアンチウイルスエンジンによるスキャンを強制的に同期実行させる、極めて堅牢な「サンドボックス型パイプライン」の設計手法を伝授する。

これは単なる「便利ツール」の作り方ではない。プロフェッショナルとして、「安全が確認されるまで、後続のプロセスに一切の権限を与えない」という、ゼロトラストの思想を実装するための技術論だ。

1. 凡庸な設計と、プロフェッショナルの設計

まず、多くの開発者が陥る「非効率で脆弱な設計」を提示しよう。

【アンチパターン:逐次実行モデル】

1. Outlookでメール受信。
2. 添付ファイルを直接、共有フォルダや作業ディレクトリに保存。
3. 保存完了後、別のバッチ処理やPythonスクリプトがそのファイルを読み込む。

なぜこれがダメなのか?
保存された瞬間に、そのファイルは「汚染された状態」でシステム内に存在してしまう。もし後続の処理がファイルを開いた瞬間に感染が拡大すれば、自動化ツールそのものが攻撃の踏み台となる。また、スキャンが完了する前に後続処理が走る「レースコンディション(競合状態)」も防げない。

【推奨設計:サンドボックス・プロモーション・モデル】

我々が実装すべきは、以下のステートマシンだ。

1. 隔離(Quarantine): 添付ファイルを、まず「隔離用の一時ディレクトリ」へ保存する。
2. 検証(Verification): 外部CLI(コマンドラインインターフェース)を用いて、アンチウイルスソフトでスキャンを実行。スキャンの終了を待機(Synchronous Wait)する。
3. 昇格(Promotion): スキャン結果(Exit Code)を確認し、`SAFE` であれば「正規の保存先」へ移動。`INFECTED` であれば即座に破棄し、管理者へ警告。

2. 実装の核心:WScript.Shellによる同期実行と終了コードの捕捉

VBAの標準的な `Shell` 関数は、コマンドを実行した直後に制御をVBAに戻してしまう(非同期)。これでは、スキャンが終わる前に次の処理に進んでしまう。

我々が使うべきは `WScript.Shell` オブジェクトの `Run` メソッドだ。このメソッドの第3引数に `True` を渡すことで、「コマンドの終了を待機し、その終了コード(Exit Code)を返す」という、堅牢な同期制御が可能になる。

3. プロダクションレベルのコード・テンプレート

以下に、実務に投入可能なレベルまで作り込んだコード例を示す。ここでは、仮のウイルススキャンエンジンとして、コマンドラインから実行可能な `scanner.exe` が存在すると想定する。

' ======================================================================================
' Module: modAttachmentProcessor
' Description: 添付ファイルの隔離保存、外部スキャン、および安全確認後の移動処理
' Author: Chief Architect
' ======================================================================================

Option Explicit

' 定数の定義(環境に合わせて変更すること)
Private Const SCANNER_PATH As String = "C:\Program Files\SecurityTool\scanner.exe"
Private Const QUARANTINE_DIR As String = "C:\Temp\Quarantine\" ' 隔離用ディレクトリ
Private Const FINAL_DEST_DIR As String = "C:\Data\Incoming\"    ' 正規の保存先
Private Const LOG_FILE_PATH As String = "C:\Logs\AttachmentProc.log"

' スキャン結果の定数
Private Const SCAN_RESULT_SAFE As Integer = 0
Private Const SCAN_RESULT_INFECTED As Integer = 1
Private Const SCAN_RESULT_ERROR As Integer = 99

''' <summary>
''' メインエントリーポイント:添付ファイルを安全に処理する
''' </summary>
''' <param name="Attachment">Outlook.Attachmentオブジェクト</param>
Public Sub ProcessAttachmentSecurely(ByRef Attachment As Outlook.Attachment)
    Dim fso As Object
    Set fso = CreateObject("Scripting.FileSystemObject")
    
    Dim tempFilePath As String
    Dim finalFilePath As String
    Dim fileName As String
    
    fileName = Attachment.FileName
    tempFilePath = QUARANTINE_DIR & fileName
    finalFilePath = FINAL_DEST_DIR & fileName
    
    On Error GoTo ErrorHandler

    ' 1. 隔離ディレクトリの存在確認
    If Not fso.FolderExists(QUARANTINE_DIR) Then
        Err.Raise 513, , "隔離ディレクトリが存在しません: " & QUARANTINE_DIR
    End If

    ' 2. 添付ファイルを隔離ディレクトリへ保存
    ' ※いきなり最終目的地に保存しないことが、設計の肝である
    Attachment.SaveAsFile tempFilePath
    WriteLog "INFO: 添付ファイルを隔離保存しました: " & fileName

    ' 3. 外部コマンドによるウイルススキャン実行
    Dim exitCode As Integer
    exitCode = ExecuteVirusScan(tempFilePath)

    ' 4. スキャン結果に基づく条件分岐(State Management)
    Select Case exitCode
        Case SCAN_RESULT_SAFE
            ' 安全な場合:正規のディレクトリへ「昇格」させる
            If fso.FileExists(finalFilePath) Then fso.DeleteFile finalFilePath
            fso.MoveFile tempFilePath, finalFilePath
            WriteLog "SUCCESS: ファイルが安全であることを確認。正規ディレクトリへ移動: " & fileName
            
        Case SCAN_RESULT_INFECTED
            ' 感染している場合:即座に破棄
            fso.DeleteFile tempFilePath
            WriteLog "CRITICAL: ウイルスを検出!ファイルを破棄しました: " & fileName
            ' ここで管理者へのメール通知などのロジックを呼ぶのがプロの仕事だ
            Call NotifyAdministrator(fileName, "Infection Detected")

        Case Else
            ' スキャナ自体のエラー、または不明な戻り値
            Err.Raise 514, , "スキャンエンジンが異常な終了コードを返しました: " & exitCode
    End Select

    Set fso = Nothing
    Exit Sub

ErrorHandler:
    WriteLog "ERROR: " & Err.Description
    ' 異常時は隔離ファイルを残すか、あるいは安全のために削除するか、ポリシーに基づき決定せよ
    If Not fso Is Nothing Then
        If fso.FileExists(tempFilePath) Then fso.DeleteFile tempFilePath
    End If
    MsgBox "添付ファイルの処理中に致命的なエラーが発生しました。ログを確認してください。", vbCritical
End Sub

''' <summary>
''' 外部スキャナを同期実行し、終了コードを取得する
''' </summary>
Private Function ExecuteVirusScan(ByVal filePath As String) As Integer
    Dim shell As Object
    Set shell = CreateObject("WScript.Shell")
    
    Dim command As String
    ' パスにスペースが含まれる場合を考慮し、ダブルクォーテーションで囲む
    command = """" & SCANNER_PATH & """ """ & filePath & """"
    
    On Error GoTo ScanError
    ' Runメソッドの第3引数を True にすることで、終了まで待機する
    ' 第4引数はウィンドウを表示するかどうか (0 = 非表示)
    ExecuteVirusScan = shell.Run(command, 0, True)
    Exit Function

ScanError:
    ExecuteVirusScan = SCAN_RESULT_ERROR
End Function

''' <summary>
''' ログ出力(実務ではデータベースやEvent Logへの書き込みも検討せよ)
''' </summary>
Private Sub WriteLog(ByVal message As String)
    Dim fso As Object
    Dim ts As Object
    Set fso = CreateObject("Scripting.FileSystemObject")
    
    On Error Resume Next
    Set ts = fso.OpenTextFile(LOG_FILE_PATH, 8, True) ' 8 = ForAppending
    ts.WriteLine Now & " | " & message
    ts.Close
    On Error GoTo 0
End Sub

Private Sub NotifyAdministrator(ByVal fileName As String, ByVal reason As String)
    ' 管理者への通知ロジック(メール送信、Teams連携、DB更新など)をここに実装
    WriteLog "ALERT: 管理者へ通知を送信しました。対象: " & fileName & " 原因: " & reason
End Sub

4. アーキテクトの視点:運用のための「極限の注意点」

このコードをプロダクション環境に投入する際、君が考慮すべき「重み」が3つある。

① ファイルロックの競合(Race Condition)

Outlookがファイルを書き込み終わる直前に、スキャナがファイルにアクセスしようとすると「ファイルが別のプロセスで使用されています」というエラーで死ぬ。
もし実環境でこのエラーが多発するなら、`SaveAsFile` の直後に `DoEvents` を入れるか、ファイルが解放されるまで数ミリ秒待機するリトライループを実装せよ。

② パスの長さと特殊文字のハンドリング

添付ファイル名には、スペース、`&`、あるいは極端に長い文字列が含まれることがある。
私のコード例では、コマンドライン引数を `”””` (ダブルクォーテーション) で囲むことで、このリスクを最小化している。これを怠ることは、シェルインジェクションの脆弱性を自ら作り出すに等しい。

③ Exit Code の定義への依存

外部スキャナ(ClamAV, Windows Defender CLI, Symantecなど)によって、`0` が「安全」を意味するかどうかは製品ごとに異なる。
「仕様書を盲信せず、実際にコマンドを叩いて戻り値を自分の目で確認すること」。これが、バグを生まない唯一の道だ。

結論

自動化とは、単に「手作業を減らすこと」ではない。「人間が行うべき判断(このファイルは安全か?)を、より高精度かつ高速に、システムとして保証すること」だ。

隔離、検証、昇格。この3ステップを徹底することで、君の作成するツールは、単なるスクリプトから「信頼に値する業務基盤」へと昇華する。

健闘を祈る。

タイトルとURLをコピーしました