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

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

「脆弱なスクリプト」から「堅牢な自動化基盤」へ:HNetCfg.FwPolicy2 を用いたファイアウォール制御の極意

業務自動化の現場において、多くのエンジニアが陥る罠がある。それは「動けばいい」という思考停止だ。

特にWindowsのファイアウォール設定のような、OSのセキュリティ根幹に触れる操作をVBScriptで自動化する場合、その「動けばいい」という甘い考えは、後に致命的なシステム障害やセキュリティホールを招く。重複するルールの乱立、エラー発生時のサイレント失敗、そして管理者権限の考慮漏れ――。これらはすべて、設計思想の欠如から生まれる。

本稿では、`HNetCfg.FwPolicy2` オブジェクトを使いこなし、単なる「ポート開放スクリプト」を超えた、「プロフェッショナルが設計すべき堅牢なファイアウォール制御基盤」の構築手法を伝授する。

1. アーキテクチャの核心:なぜ HNetCfg.FwPolicy2 なのか

Windowsにはファイアウォールを操作する手段がいくつか存在するが、WSH(Windows Script Host)環境において、モダンな「セキュリティが強化されたWindows Defender ファイアウォール」を制御するには、`HNetCfg.FwPolicy2` オブジェクトを選択するのが唯一の正解である。

以前の `HNetCfg.FwPolicy`(末尾に「2」がつかないもの)は旧式であり、現在の高度なセキュリティ設定を完全に反映できない。エンジニアとして、常に「現在、最も信頼に値するインターフェースはどれか」を問い続ける必要がある。

制御対象のオブジェクトモデル

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

  • `FwPolicy2`: ファイアウォール全体のポリシー管理。
  • `Rules`: 作成・削除・検索を行うためのルールコレクション。
  • `FwRule`: 個別のルールオブジェクト。

我々が操作すべきは、この `Rules` コレクションである。

2. プロフェッショナルが守るべき「3つの設計原則」

コードを書く前に、設計指針を脳に刻んでほしい。

① 冪等性(Idempotency)の確保

「スクリプトを2回実行しても、結果が同じであること」。これが自動化における鉄則だ。
単に `Add` メソッドを叩くスクリプトは素人だ。同じ名前のルールが既に存在する場合、重複してルールが生成されるか、エラーで停止する。
「既存ルールをチェックし、必要に応じて削除または更新してから追加する」というロジックを組み込め。

② 権限とエラーハンドリングの分離

ファイアウォールの操作には、管理者権限(Administrator)が不可欠だ。権限が不足している状態でオブジェクトを生成しようとすれば、即座にランタイムエラーが発生する。
また、COMオブジェクトの操作は、OSの状態によって予期せぬエラー(アクセス拒否、リソース不足など)を伴う。`On Error Resume Next` を無秩序に使うことは、バグを闇に葬る行為に等しい。エラーが発生した瞬間、その原因を特定し、適切にログへ吐き出す設計にせよ。

③ 設定の外部化(Configuration-Driven)

ポート番号やプロトコルをコード内にハードコード(直書き)することは、保守性の観点から「罪」である。
実務では、設定値はCSVやXML、あるいはデータベースから取得すべきだ。ロジック(VBScript)とデータ(設定ファイル)を分離することで、プログラムを書き換えることなく、業務要件の変化に対応できる。

3. 実装例:堅牢なファイアウォール制御エンジン

以下に、これら全ての原則を具現化したプロダクションレベルのコードを示す。このコードは、単なる「追加」ではなく、「指定した状態(存在・無効・削除)へ確実に遷移させる」ことを目的としている。

'**
' Module: FirewallAutomationEngine
' Description: HNetCfg.FwPolicy2 を用いた堅牢なファイアウォール制御スクリプト
' Author: Legendary Chief Architect
'**
Option Explicit

' --- 定数定義 ---
Const PROTOCOL_TCP = 6
Const PROTOCOL_UDP = 17
Const ACTION_ALLOW = 1
Const ACTION_BLOCK = 0

' --- メインルーチン ---
Main

Sub Main()
    Dim fwPolicy, err, ruleName, port, protocol
    
    ' 1. オブジェクトの生成と権限チェック
    On Error Resume Next
    Set fwPolicy = CreateObject("HNetCfg.FwPolicy2")
    If Err.Number <> 0 Then
        WScript.Echo "ERROR: ファイアウォールオブジェクトの生成に失敗しました。管理者権限で実行してください。"
        WScript.Quit 1
    End If
    On Error GoTo 0

    ' 2. 操作対象の定義 (本来はCSVやDBから読み込むべき箇所)
    ' 形式: RuleName | Port | Protocol (TCP/UDP) | Action (Enable/Disable/Remove)
    Dim taskList
    taskList = Array( _
        Array("App_Service_TCP_8080", 8080, "TCP", "Enable"), _
        Array("App_Service_UDP_5000", 5000, "UDP", "Enable"), _
        Array("Old_Legacy_Rule", 9999, "TCP", "Remove") _
    )

    ' 3. タスクの実行
    Dim i, task
    For i = 0 To UBound(taskList)
        task = taskList(i)
        ruleName = task(0)
        port     = task(1)
        protocol = task(2)
        
        Select Case task(3)
            Case "Enable"
                UpsertFirewallRule fwPolicy, ruleName, port, protocol
            Case "Remove"
                RemoveFirewallRule fwPolicy, ruleName
        End Select
    Next

    WScript.Echo "すべてのファイアウォール操作が完了しました。"
End Sub

'**
' Function: UpsertFirewallRule
' Purpose: ルールの存在を確認し、なければ作成、あれば更新(冪等性の確保)
'**
Sub UpsertFirewallRule(objPolicy, strName, intPort, strProto)
    Dim objRules, objRule, protoVal
    Set objRules = objPolicy.Rules
    
    ' プロトコルの数値変換
    If UCase(strProto) = "TCP" Then protoVal = PROTOCOL_TCP Else protoVal = PROTOCOL_UDP

    ' 既存ルールの確認
    Set objRule = Nothing
    On Error Resume Next
    Set objRule = objRules.Item(strName)
    On Error GoTo 0

    If IsObject(objRule) Then
        ' 既に存在する場合:設定を上書き(Update)
        WScript.Echo "INFO: ルール [" & strName & "] は既に存在します。更新します。"
        objRule.Protocol = protoVal
        objRule.LocalPorts = CStr(intPort)
        objRule.Enabled = True
        objRule.Action = ACTION_ALLOW
    Else
        ' 存在しない場合:新規作成(Create)
        WScript.Echo "INFO: ルール [" & strName & "] を新規作成します。"
        Set objRule = objRules.CreateNewRule()
        objRule.Name = strName
        objRule.Description = "Automated Rule via VBScript"
        objRule.Protocol = protoVal
        objRule.LocalPorts = CStr(intPort)
        objRule.Direction = 1 ' Inbound
        objRule.Action = ACTION_ALLOW
        objRule.Enabled = True
    End If
    
    ' 設定の確定(オブジェクトのプロパティ変更は即座に反映されるが、エラー監視は必須)
    If Err.Number <> 0 Then
        WScript.Echo "ERROR: ルール [" & strName & "] の適用中にエラーが発生しました: " & Err.Description
        Err.Clear
    End If
End Sub

'**
' Function: RemoveFirewallRule
' Purpose: 指定した名前のルールを削除
'**
Sub RemoveFirewallRule(objPolicy, strName)
    Dim objRules, objRule
    Set objRules = objPolicy.Rules
    
    On Error Resume Next
    Set objRule = objRules.Item(strName)
    On Error GoTo 0

    If IsObject(objRule) Then
        objRules.Remove strName
        WScript.Echo "INFO: ルール [" & strName & "] を削除しました。"
    Else
        WScript.Echo "INFO: ルール [" & strName & "] は存在しないため、削除をスキップします。"
    End If
End Sub

4. 実務における注意点と高度な知見

ファイル・データベース連携時の落とし穴

もし、このスクリプトを外部ファイル(CSV等)と連携させるなら、「文字コード」と「不正な入力値」に細心の注意を払え。

  • VBScriptの `FileSystemObject` でファイルを読み込む際、UTF-8(BOMなし)を扱うと文字化けや読み込みエラーが発生しやすい。業務ツールとしては、Shift-JIS(ANSI)で管理するか、ADODB.Stream を用いて明示的に文字コードを指定する設計にせよ。
  • 設定ファイルに `Port: “ABC”` のような文字列が紛れ込んだ場合、型不一致(Type Mismatch)でスクリプトは即死する。必ず `IsNumeric()` によるバリデーションを挟め。

パフォーマンスの重み

`Rules` コレクションへのアクセスは、ルール数が増えるほどコストがかかる。ループの中で毎回 `CreateObject` を行うような愚かな真似はするな。オブジェクトの生成は最小限にし、一度生成した `fwPolicy` インスタンスを使い回すのが、プロフェッショナルの作法だ。

結論

VBScriptは古い言語だ。しかし、その枯れた特性と `HNetCfg.FwPolicy2` のような強力なCOMインターフェースを組み合わせれば、Windows環境における最強の自動化武器となる。

重要なのは、コードの量ではない。「例外をどう捉え、いかにしてシステムの整合性を保つか」という設計思想の深さだ。このスクリプトを基盤として、君たちの業務自動化を一段上のレベルへと引き上げてほしい。

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