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

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

Outlook VBAにおける「ゼロトラスト」の実装:外部コマンド連携による添付ファイル強制スキャン・アーキテクチャ

自動化エンジニアが陥りがちな致命的な慢心がある。それは「Outlookの添付ファイルを保存するコードを書いたから、そのプロセスは安全である」という誤認だ。

エンタープライズ環境において、メール添付ファイルは常に「潜在的なペイロード(攻撃コード)」である。VBAによって添付ファイルを自動保存する仕組みを構築するということは、外部からシステム内部へファイルを運び込む「パイプライン」を構築することと同義だ。そのパイプラインに、検証プロセス(検疫)を組み込まない設計は、セキュリティホールを自ら設計しているに等しい。

本稿では、単なるファイルの保存に留まらず、Windows Defender等のアンチウイルスエンジンをコマンドライン経由で強制的に呼び出し、「スキャンが完了し、安全が確認されたファイルのみを正規のディレクトリへ移動する」という、ゼロトラストに基づいた堅牢なアーキテクチャを解説する。

1. アーキテクチャ設計:Quarantine-Scan-Promote パターン

我々が目指すべきは、直接的な保存ではない。以下の3段階のライフサイクルを持つ「Quarantine-Scan-Promote(検疫・スキャン・昇格)」パターンである。

1. Quarantine(検疫): 添付ファイルを、一旦「隔離用テンポラリディレクトリ」へ保存する。この時点では、システム上の重要領域には一切配置しない。
2. Scan(スキャン): 外部プロセス(アンチウイルスエンジン)を同期実行し、スキャン完了を待機する。
3. Promote/Purge(昇格または破棄):

  • スキャン結果(Exit Code)が「安全」を示した場合のみ、ファイルを正規の保存先へ移動する。
  • 「脅威」が検出された場合は、即座にファイルを物理削除し、ログを記録する。

この設計の肝は、「非同期処理によるレースコンディション(競合状態)」を排除することにある。VBAの`Shell`関数は非同期で実行されるため、スキャンが終わる前に次の処理が進んでしまうリスクがある。これを防ぐため、`WScript.Shell`の同期実行オプションを駆使する。

2. 実装:堅牢なスキャン・エンジン

以下に、Windows Defenderのコマンドラインツール(`MpCmdRun.exe`)を例にとった、プロフェッショナル仕様の実装を示す。

Option Explicit

' --- 定数定義 ---
' 隔離ディレクトリと正規ディレクトリの分離は鉄則
Private Const DIR_QUARANTINE As String = "C:\Automation\Quarantine\"
Private Const DIR_FINAL      As String = "C:\Automation\SafeFiles\"
' Windows Defenderのパス(環境に合わせて調整が必要)
Private Const SCANNER_EXE    As String = "C:\Program Files\Windows Defender\MpCmdRun.exe"

' スキャン結果のExitCode定義(環境により異なるため検証が必要)
Private Const SCAN_SUCCESS   As Long = 0
Private Const SCAN_THREAT    As Long = 2 ' 仮定:脅威検出時のコード

''' <summary>
''' 添付ファイルを安全に処理するメインルーチン
''' </summary>
Public Sub ProcessAttachmentsSecurely(ByRef objMail As Outlook.MailItem)
    Dim objAttachment As Outlook.Attachment
    Dim strTempPath As String
    Dim strFinalPath As String
    Dim shellApp As Object
    Dim intExitCode As Long
    Dim strCommand As String
    
    ' 1. オブジェクトの生存期間を管理するための変数
    Set shellApp = CreateObject("WScript.Shell")
    
    On Error GoTo ErrorHandler

    For Each objAttachment In objMail.Attachments
        ' ファイル名の正規化(パスインジェクション対策)
        Dim strFileName As String
        strFileName = SanitizeFileName(objAttachment.FileName)
        
        strTempPath = DIR_QUARANTINE & strFileName
        strFinalPath = DIR_FINAL & strFileName

        ' --- Phase 1: Quarantine ---
        ' 隔離ディレクトリへ保存
        objAttachment.SaveAsFile strTempPath
        
        ' --- Phase 2: Scan (Synchronous) ---
        ' コマンドライン引数の構築
        ' MpCmdRun.exe -Scan -File <path>
        strCommand = """" & SCANNER_EXE & """ -Scan -File """ & strTempPath & """"
        
        ' WScript.Shell.Run(command, windowStyle, waitOnReturn)
        ' 第3引数を True にすることで、スキャン完了までVBAの実行をブロック(同期実行)する
        intExitCode = shellApp.Run(strCommand, 0, True)
        
        ' --- Phase 3: Promote or Purge ---
        If intExitCode = SCAN_SUCCESS Then
            ' 安全な場合のみ正規ディレクトリへ移動(FileSystemObjectを使用)
            Dim fso As Object
            Set fso = CreateObject("Scripting.FileSystemObject")
            
            ' 同名ファイルが存在する場合の処理(上書き禁止、またはタイムスタンプ付与)
            If fso.FileExists(strFinalPath) Then
                strFinalPath = DIR_FINAL & Format(Now, "yyyymmddhhmmss_") & strFileName
            End If
            
            fso.MoveFile strTempPath, strFinalPath
            Debug.Print "SUCCESS: " & strFileName & " has been promoted."
        Else
            ' 脅威検出、あるいはスキャンエラーの場合
            HandleThreat strTempPath, intExitCode
        End If
        
        ' メモリ解放の徹底
        Set fso = Nothing
    Next objAttachment

CleanExit:
    Set shellApp = Nothing
    Exit Sub

ErrorHandler:
    ' ログ出力、管理者への通知などのロジックをここに実装
    Debug.Print "CRITICAL ERROR: " & Err.Description
    Resume CleanExit
End Sub

''' <summary>
''' ファイル名から不正な文字を除去し、パスインジェクションを防ぐ
''' </summary>
Private Function SanitizeFileName(ByVal strName As String) As String
    Dim i As Integer
    Dim invalidChars As Variant
    invalidChars = Array("/", "\", ":", "*", "?", """", "<", ">", "|")
    
    For i = LBound(invalidChars) To UBound(invalidChars)
        strName = Replace(strName, invalidChars(i), "_")
    Next i
    SanitizeFileName = strName
End Function

''' <summary>
''' 脅威検知時の処理。ファイルを物理削除し、証跡を残す。
''' </summary>
Private Sub HandleThreat(ByVal strPath As String, ByVal intCode As Long)
    Dim fso As Object
    Set fso = CreateObject("Scripting.FileSystemObject")
    
    If fso.FileExists(strPath) Then
        fso.DeleteFile strPath, True
    End If
    
    ' ここでシステム管理者にアラートを飛ばす(Event Logへの書き込み等)
    Debug.Print "ALERT: Threat detected! ExitCode: " & intCode & " File deleted: " & strPath
    Set fso = Nothing
End Sub

3. 伝説的アーキテクトの視点:極限の知見

このコードを単なる「動くスクリプト」から「エンタープライズ・グレードの資産」へと昇華させるために、以下の3点に留意せよ。

3.1. オブジェクトのライフサイクルとメモリ管理

VBAにおいて、`For Each` ループ内で大量の `Attachment` オブジェクトを扱う際、COMオブジェクトの参照カウンタが適切に制御されないと、メモリリークを引き起こし、Outlookのプロセスが不安定化する。
本実装では、`Set fso = Nothing` のように、ループ内で生成したオブジェクトを明示的に解放している。また、`shellApp` もループの外で生成し、最後に一括で解放する。これは、オブジェクト生成のオーバーヘッドを最小化し、メモリの断片化を防ぐための定石である。

3.2. 同期実行(Synchronous Blocking)の重要性

`Shell` 関数(VBA標準)を使用するのは素人のすることだ。`Shell` はプロセスを起動した直後に制御をVBAに戻してしまう。スキャンが終わる前に `MoveFile` が走れば、ファイルロックエラーが発生するか、あるいは「スキャン前のファイル」を移動させてしまうという、セキュリティ上の致命的な欠陥を招く。
`WScript.Shell.Run` の第3引数 `waitOnReturn = True` を利用することで、OSレベルでプロセスが終了するまでスレッドを待機させる。これが「安全を確認してから次へ進む」という論理的な整合性を担保する唯一の方法だ。

3.3. パスインジェクションへの防御

`strTempPath = DIR_QUARANTINE & objAttachment.FileName` といった記述は、悪意あるユーザーがファイル名に `..\..\Windows\System32\cmd.exe` といった文字列を含めて送ってきた場合、ディレクトリトラバーサル攻撃を許してしまう。
`SanitizeFileName` 関数によって、ファイル名に含まれる制御文字やパス区切り文字を徹底的に排除することは、自動化エンジニアにとっての「義務」である。

結論

自動化は効率をもたらすが、同時に攻撃の表面積(Attack Surface)を拡大させる。
「動くものを作る」フェーズを卒業し、「壊れないもの、そして悪用されないものを作る」フェーズへ移行せよ。この「検疫・同期スキャン・昇格」のアーキテクチャは、そのための第一歩となる。

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