「脆弱なスクリプト」から「堅牢な自動化基盤」へ: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環境における最強の自動化武器となる。
重要なのは、コードの量ではない。「例外をどう捉え、いかにしてシステムの整合性を保つか」という設計思想の深さだ。このスクリプトを基盤として、君たちの業務自動化を一段上のレベルへと引き上げてほしい。
