ファイアウォール制御の真髄: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.*
