【テクニカル・上級編】【ファイアウォール自動化】HNetCfg.FwPolicy2 オブジェクトを用いた Windows ファイアウォールの特定ポート開放とルール無効化の制御 – VBScript (Visual Basic Scripting Edition)解析バイブル

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

ファイアウォール制御の真髄:HNetCfg.FwPolicy2 を用いた VBScript による極限の自動化

レガシーな環境からモダンなクラウドネイティブなインフラまで、システム管理の現場において「自動化」は単なる効率化の手段ではない。それは、ヒューマンエラーという名の「致命的な脆弱性」を排除するための、エンジニアとしての責務である。

特に、Windows Defender Firewall の制御は、セキュリティと業務継続性のトレードオフが最も顕著に現れる領域だ。多くの者は、PowerShell や GUI を介した操作に逃げる。しかし、極限まで軽量なエージェント、あるいは既存の VBScript ベースの資産が動くレガシー環境において、COM オブジェクトを直接操作し、OS の深層にアクセスする手法は、今なお圧倒的な価値を持つ。

本稿では、`HNetCfg.FwPolicy2` オブジェクトを解剖し、特定のポート開放とルールの動的な制御を、プロフェッショナルの流儀で行うための知見を提示する。

1. COM オブジェクト・モデルの解剖:HNetCfg.FwPolicy2

Windows ファイアウォールの制御において、我々が扱うのは `HNetCfg.FwPolicy2` という COM インターフェースである。かつての `FwPolicy` は旧世代であり、現代のネットワーク機能(プロファイル管理や詳細なルール定義)を完全にカバーするには不十分だ。

`FwPolicy2` オブジェクトは、以下の階層構造を持っている。

1. FwPolicy2: ファイアウォール全体のポリシー管理。
2. Rules Collection: 設定されている全ルールの集合体。
3. INetFwRule: 個別のルールを定義するインターフェース。

ここで重要なのは、ルールを追加するという行為は、単に「設定を書き込む」ことではない。既存のルールとの衝突を回避し、参照カウント(Reference Counting)を意識したオブジェクトのライフサイクル管理を行うことである。

2. 実装における極限の規律:メモリとエラーハンドリング

VBScript はガベージコレクションを内包しているが、COM オブジェクトを扱う際には、明示的な破棄(`Set obj = Nothing`)が不可欠である。特に、OS の低レイヤーに干渉するオブジェクトにおいて、オブジェクトの解放が遅延することは、リソースリークのみならず、予期せぬロックを引き起こし、次なる自動化プロセスを阻害する原因となる。

また、ファイアウォールの操作には管理者権限(Administrator Privileges)が必須である。権限不足による `0x80070005 (E_ACCESSDENIED)` は、現場で遭遇する最も一般的な、しかし最も回避すべきエラーだ。

3. 実装コード:堅牢なポート制御エンジン

以下に、特定のポートを開放し、既存の重複ルールを排除する、実戦投入レベルのスクリプトを示す。

' ==============================================================================
' Firewall Automation Engine (HNetCfg.FwPolicy2 Implementation)
' Purpose: Dynamically manage inbound firewall rules for specific business apps.
' Author: Chief Architect
' ==============================================================================

Option Explicit

' 定数定義
Const RULE_ACTION_ALLOW = 1
Const RULE_ACTION_BLOCK = 0
Const PROTOCOL_TCP = 6
Const PROTOCOL_UDP = 17

' メイン実行ルーチン
Main()

Sub Main()
    Dim strRuleName, intPort, strProtocol
    
    ' 設定値(本来は外部引数や設定ファイルから取得すべき)
    strRuleName = "Business_App_TCP_8080_Inbound"
    intPort = 8080
    strProtocol = "TCP"

    On Error Resume Next
    
    WScript.Echo "--- Firewall Automation Started ---"
    
    ' 1. ルールの適用
    If SetFirewallRule(strRuleName, intPort, strProtocol, RULE_ACTION_ALLOW) Then
        WScript.Echo "SUCCESS: Rule '" & strRuleName & "' applied."
    Else
        WScript.Echo "ERROR: Failed to apply rule."
        WScript.Quit 1
    End If

    ' 2. ルールの無効化テスト (実運用ではコメントアウト)
    ' If DisableFirewallRule(strRuleName) Then
    '     WScript.Echo "SUCCESS: Rule '" & strRuleName & "' disabled."
    ' End If

    WScript.Echo "--- Operation Completed ---"
    On Error GoTo 0
End Sub

''' <summary>
''' 特定のポートに対するルールを設定する。既存の同名ルールがある場合は上書きする。
''' </summary>
Function SetFirewallRule(ruleName, port, protocol, action)
    Dim objFwPolicy2, objFwRule, objRules, objExistingRule
    Dim intProtoNum
    Set SetFirewallRule = False

    ' プロトコルの数値変換
    If UCase(protocol) = "TCP" Then
        intProtoNum = PROTOCOL_TCP
    ElseIf UCase(protocol) = "UDP" Then
        intProtoNum = PROTOCOL_UDP
    Else
        WScript.Echo "Invalid Protocol: " & protocol
        Exit Function
    End If

    ' COMオブジェクトの生成
    Set objFwPolicy2 = CreateObject("HNetCfg.FwPolicy2")
    If Err.Number <> 0 Then
        WScript.Echo "Critical Error: Failed to instantiate FwPolicy2. (Run as Admin?)"
        Exit Function
    End If

    Set objRules = objFwPolicy2.Rules

    ' --- 重複排除ロジック (Rule Bloat Prevention) ---
    ' 同名のルールが既に存在する場合、古いルールを削除してクリーンな状態を作る
    For Each objExistingRule In objRules
        If objExistingRule.Name = ruleName Then
            objRules.Remove objExistingRule.Name
            WScript.Echo "Note: Existing rule '" & ruleName & "' removed to prevent duplication."
            Exit For
        End If
    Next

    ' --- 新規ルールの構築 ---
    Set objFwRule = CreateObject("HNetCfg.FwRule")
    With objFwRule
        .Name = ruleName
        .Description = "Automated rule for business application access."
        .Protocol = intProtoNum
        .LocalPorts = CStr(port)
        .Direction = 1 ' 1 = Inbound (受信)
        .Action = action
        .Enabled = True
        .Profiles = 255 ' 255 = All profiles (Domain, Private, Public)
    End With

    ' ルールの追加
    objRules.Add objFwRule
    
    ' ライフサイクル管理: 明示的なオブジェクト解放
    Set objFwRule = Nothing
    Set objRules = Nothing
    Set objFwPolicy2 = Nothing

    Set SetFirewallRule = True
End Function

''' <summary>
''' 指定した名前のルールを無効化する(削除ではなく、Enabledプロパティの制御)
''' </summary>
Function DisableFirewallRule(ruleName)
    Dim objFwPolicy2, objRules, objRule
    Set DisableFirewallRule = False

    Set objFwPolicy2 = CreateObject("HNetCfg.FwPolicy2")
    Set objRules = objFwPolicy2.Rules

    On Error Resume Next
    Set objRule = objRules.Item(ruleName)
    
    If Err.Number = 0 Then
        objRule.Enabled = False
        WScript.Echo "Rule '" & ruleName & "' has been disabled."
        Set DisableFirewallRule = True
    Else
        WScript.Echo "Rule '" & ruleName & "' not found."
    End If
    On Error GoTo 0

    Set objRule = Nothing
    Set objRules = Nothing
    Set objFwPolicy2 = Nothing
End Function

4. アーキテクトの視点:運用上の要諦

このスクリプトを実戦で運用する際、シニアエンジニアが留意すべきは以下の3点である。

A. 「Rule Bloat(ルールの肥大化)」の回避

自動化スクリプトが「追加」のみを行い、「削除」や「更新」を怠ると、ファイアウォールのルールセットは膨大な数に膨れ上がる。これはファイアウォールエンジン(`mpssvc`)のパケットフィルタリング・レイテンシを増大させ、システムのパフォーマンスを低下させる。コード内の「重複排除ロジック」は、単なる親切心ではなく、システムの健全性を維持するための防衛策である。

B. プロファイル管理の戦略的選択

上記のコードでは `.Profiles = 255` とし、すべてのネットワークプロファイル(Domain, Private, Public)を対象としている。しかし、極めて高いセキュリティが要求される環境では、これを `1` (Domain) や `2` (Private) に限定し、Public プロファイルでの露出を最小限に抑える設計にすべきである。

C. 冪等性(Idempotency)の確保

優れた自動化スクリプトは、「何度実行しても、最終的な状態が同じであること」を保証しなければならない。本スクリプトは、既存ルールの確認と削除を行い、常に意図した通りの単一ルールが存在する状態を作ることで、この冪等性を担保している。

結言

VBScript はレガシーな言語と揶揄されることもある。しかし、Windows の COM 基盤を正確に理解し、オブジェクトのライフサイクルを制御下に置いたとき、それは極めて強力で、かつ環境を選ばない武器へと昇華する。

技術の真髄は、新しい言語を追うことだけにあるのではない。既存のアーキテクチャの深層を理解し、それを制御する術を知ることにある。

*Copyright © 2024 Legendary Chief Architect. All rights reserved.*

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