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

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

Windowsの「門番」を操る:VBScriptでファイアウォールを自動制御する極限の技術

「新しい業務アプリを導入したのに、なぜか通信が通らない……」
「設定画面を開いて、ポチポチとポートを開けていく作業、もう限界だ……」

現場でそんな声が聞こえてきたら、エンジニアの出番です。

こんにちは。今日は、Windowsのセキュリティの要である「Windows Defender ファイアウォール」を、VBScriptから直接、かつダイナミックに制御する手法についてお話ししましょう。

単に「コードを動かす」だけではありません。オブジェクトがどのようにOSと対話し、どのようなリスクを孕んでいるのか。プロのアーキテクトの視点で、その深淵を覗いてみましょう。ここをクリアすれば、あなたのVBScriptスキルは「単なる自動化」から「システム制御」へと昇華しますよ。

1. 魔法の鍵:`HNetCfg.FwPolicy2` オブジェクトとは何か?

VBScriptそのものには、ファイアウォールを操作する機能は備わっていません。しかし、Windowsには COM (Component Object Model) という、異なるプログラム同士が手を取り合うための強力な仕組みがあります。

今回私たちが使うのが、`HNetCfg.FwPolicy2` というオブジェクトです。これは、Windows ファイアウォールの設定を司る「司令塔」へのアクセス権を、VBScriptに与えてくれる特別な鍵なのです。

なぜ `FwPolicy2` なのか?

古いリファレンスでは `HNetCfg.FwPolicy`(末尾に2がないもの)を見かけることがありますが、それは過去の遺物です。`FwPolicy2` は、現代の高度なセキュリティ設定(プロファイルごとの制御など)に対応した、現役の司令塔です。新しいプロジェクトでは、必ずこの「2」が付いた方を使いましょう。

2. 実践:特定のポートを「開放」する

まずは、最も基本的な「特定のTCPポート(例:8080番)を許可するルールを追加する」コードを見てみましょう。

マクロの記録では決して辿り着けない、オブジェクト指向の真髄がここにあります。

' =================================================================
' 【業務アプリ用】特定ポート開放スクリプト
' 概要: 指定したポート番号のTCP通信を許可するファイアウォールルールを追加する
' =================================================================

Option Explicit

' 変数宣言(プロの基本:型を意識し、スコープを限定する)
Dim objFwPolicy2, objNewRule
Dim strRuleName, strPort, strProtocol

' 設定値
strRuleName = "MyBusinessApp_Port8080_Allow" ' ルール名(一意である必要があります)
strPort     = "8080"                         ' 開放したいポート番号
strProtocol = 6                              ' TCPを指定 (TCP=6, UDP=17)

On Error Resume Next ' エラーハンドリングの準備

' 1. ファイアウォール司令塔(Policy2)を召喚
Set objFwPolicy2 = CreateObject("HNetCfg.FwPolicy2")

If Err.Number <> 0 Then
    WScript.Echo "エラー: ファイアウォールへのアクセスに失敗しました。" & vbCrLf & _
                 "管理者権限で実行しているか確認してください。"
    WScript.Quit
End If

' 2. 新しいルール(Rule)の設計図を作成
Set objNewRule = objFwPolicy2.CreateNewRule()

' 3. ルールの詳細を定義(ここが設計の肝!)
With objNewRule
    .Name = strRuleName                ' ルールに名前を付ける
    .Protocol = strProtocol            ' プロトコル (TCP/UDP)
    .LocalPorts = strPort              ' 対象ポート
    .Direction = 1                     ' 方向: 1 = 受信 (Inbound), 2 = 送信 (Outbound)
    .Action = 1                        ' アクション: 1 = 許可 (Allow), 0 = ブロック (Block)
    .Enabled = True                    ' ルールを有効にする
    .Description = "業務アプリ通信用の一時開放ルール"
End With

' 4. 司令塔に設計図を提出し、ルールを適用
objFwPolicy2.Rules.Add objNewRule

If Err.Number = 0 Then
    WScript.Echo "成功: ルール [" & strRuleName & "] を追加しました。"
Else
    WScript.Echo "エラー: ルールの追加に失敗しました。" & vbCrLf & Err.Description
End If

' 5. 後片付け(オブジェクトのライフサイクル管理)
' 使い終わったオブジェクトは明示的に解放するのが、メモリリークを防ぐ鉄則です
Set objNewRule = Nothing
Set objFwPolicy2 = Nothing

On Error GoTo 0

ここがポイント!

  • `CreateNewRule` の挙動: これは「まだ存在しない、新しいルール」というメモリ上のオブジェクトを生成しているに過ぎません。最後に `objFwPolicy2.Rules.Add` を呼び出した瞬間に、初めてOSのシステム設定に書き込まれます。
  • 方向 (`Direction`) と アクション (`Action`): ここは数値で指定します。マジックナンバー(意味のわからない数字)に見えますが、APIの仕様に基づいた重要な値です。

3. 応用:ルールを「無効化」または「削除」する

ルールを作っただけでは、セキュリティホールが開きっぱなしになります。業務が終わったら、ルールを消すか、無効にする必要があります。

ここでの難所は、「既存のルールの中から、目的のものを探し出す」 というプロセスです。

' =================================================================
' 【業務アプリ用】ルール削除/無効化スクリプト
' 概要: 名前を指定して既存のルールを検索し、削除または無効化する
' =================================================================

Option Explicit

Dim objFwPolicy2, objRules, objRule
Dim strTargetName
Dim foundCount

strTargetName = "MyBusinessApp_Port8080_Allow" ' 削除したいルールの名前

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

' ルールのコレクションをループで回して検索
' 注意: コレクションをループしながら削除する場合、逆順で回すのが定石ですが、
' 今回は「特定の名前」を探すだけなので、通常のループで進めます。
For Each objRule In objRules
    If objRule.Name = strTargetName Then
        ' --- パターンA: ルールを無効化するだけの場合 ---
        ' objRule.Enabled = False
        
        ' --- パターンB: ルールを完全に削除する場合 ---
        objRules.Remove strTargetName
        foundCount = foundCount + 1
        Exit For ' 見つかったらループを抜ける
    End If
Next

If foundCount > 0 Then
    WScript.Echo "完了: ルール [" & strTargetName & "] を削除しました。"
Else
    WScript.Echo "通知: 指定されたルールは見つかりませんでした。"
End If

Set objRules = Nothing
Set objFwPolicy2 = Nothing

4. 伝説のエンジニアが教える「陥りやすい罠」

これだけを知っていても、現場ではトラブルが起きます。回避するための知見を授けましょう。

① 「管理者権限」という高い壁

ファイアウォールの設定変更は、OSの根幹に関わる操作です。そのため、VBScriptを「管理者として実行」していない限り、必ずエラーになります。
「コードは正しいのに動かない!」と嘆く前に、コマンドプロンプトを管理者として開き、そこから `cscript your_script.vbs` と叩いてみてください。

② 「ゾンビ・ルール」の発生

ルールを追加する際、もし「既に同じ名前のルールが存在する」状態で `Add` を実行すると、エラーになるか、あるいは重複して登録されてしまうことがあります。
「追加する前に、同名のルールがないか確認し、あれば削除する」 という、いわゆる「冪等性(べきとうせい)」を意識した設計を心がけてください。これがプロの仕事です。

③ オブジェクトの解放(Lifecycle Management)

VBScriptはメモリ管理を自動で行ってくれますが、COMオブジェクトはOSのリソースを直接掴みます。大規模な自動化ツールを作る際、`Set obj = Nothing` を怠ると、スクリプトが終了してもプロセスが残り続けたり、メモリを食いつぶしたりする原因になります。

まとめ:自動化の先にあるもの

いかがでしたか?
`HNetCfg.FwPolicy2` を使いこなすことは、単にポートを開けることではありません。Windowsという巨大なシステムの「門番」を、あなたのプログラムの手足として従わせることに他なりません。

1. 司令塔 (`Policy2`) を召喚する
2. 設計図 (`NewRule`) を描く
3. 実体化 (`Add`) させる
4. 後始末 (`Remove/Nothing`) を忘れない

このステップをマスターすれば、あなたの自動化の幅は劇的に広がります。
さあ、勇気を持って、このコードを自分の環境で試してみてください。エラーが出ても大丈夫。そのエラーこそが、あなたが成長するための最高の教科書なのですから。

応援していますよ!

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