【テクニカル・上級編】【上級】ステンシル配布時の「ライセンス認証」:VBAでマスターシェイプの使用を制限する – Visio VBA解析バイブル

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

聖域の防衛:Visio VBAによるマスターシェイプのライセンス認証と知的財産保護の極致

企業における業務自動化の進展に伴い、我々エンジニアが提供する「高度に設計されたステンシル(Stencil)」は、単なる図形集ではなく、極めて価値の高い「設計資産(IP: Intellectual Property)」へと変貌を遂げた。

しかし、現実を見よう。ステンシルファイル(.vssx)を配布した瞬間、その中身のロジックや高度な形状定義は、利用者の手中に落ちる。安易なコピー、あるいは許可されていないドキュメントへの流用。これらを防ぐために「パスワードをかける」といった小手先の手段は、シニアエンジニアの仕事ではない。我々が実装すべきは、「実行環境(Context)に紐付いた動的なライセンス認証メカニズム」である。

本稿では、特定のドキュメント以外でのマスターシェイプの使用を物理的に無効化し、不正な利用を検知・排除するための、Windows APIを駆使した「センチネル(監視者)パターン」の実装について詳述する。

1. 脆弱性の本質:なぜ通常の手段では不十分なのか

一般的なVisio VBA開発者は、`Document_Open` イベントに認証ロジックを記述するだけで満足する。しかし、それは「入り口」を守っているに過ぎない。

攻撃者(あるいは不注意なユーザー)は、以下の手段で防御を突破する:
1. ステンシルからの直接ドロップ: 認証ロジックがドキュメント側にしかない場合、新しいドキュメントにマスターシェイプをドラッグ&ドロップする行為自体を阻止できない。
2. オブジェクトの永続化: 一度ドロップされたシェイプは、ドキュメントの一部として完全に独立したオブジェクトとなり、元のステンシルとの紐付けが(表面上は)切断される。

我々が実装すべきは、「シェイプがドキュメント内に存在すること自体を、継続的に検証するライフサイクル管理」である。

2. アーキテクチャ設計:センチネル・パターン

防御戦略として、以下の3層構造を採用する。

1. Digital Watermark (署名層): 全ての保護対象マスターシェイプの `Shape Data` に、隠蔽された一意の「署名(Signature)」を埋め込む。
2. Background Watchdog (監視層): Windows APIの `SetTimer` を用い、Visioのメインスレッドをブロックすることなく、バックグラウンドで定期的にドキュメント内のシェイプをスキャンする。
3. Enforcement (執行層): 許可されていないコンテキスト(ドキュメント)で署名が検知された場合、即座にそのオブジェクトを破棄、あるいはドキュメントを強制終了させる。

3. 極限の実装:Windows APIを用いた非同期監視

標準の `Application.OnTime` では、VisioのUIスレッドとの干渉や、精度の低さが課題となる。ここでは、Windows APIの `SetTimer` を使用し、低レイテンシかつ高信頼な監視プロセスを構築する。

3.1. モジュール宣言とAPI定義

まず、メモリ管理とタイマー制御のための宣言を行う。ここで重要なのは、タイマーの停止(`KillTimer`)を確実に実行し、メモリリークを防ぐことだ。

Option Explicit

' --- Windows API Declarations ---

If VBA7 Then

' 64bit環境用 Private Declare PtrSafe Function SetTimer Lib "user32" (ByVal hwnd As LongPtr, ByVal nIDEvent As LongPtr, ByVal uElapse As Long, ByVal lpTimerFunc As LongPtr) As LongPtr Private Declare PtrSafe Function KillTimer Lib "user32" (ByVal hwnd As LongPtr, ByVal nIDEvent As LongPtr) As Long Private Declare PtrSafe Function PostMessage Lib "user32" Alias "PostMessageA" (ByVal hwnd As LongPtr, ByVal wMsg As Long, ByVal wParam As LongPtr, ByVal lParam As LongPtr) As Long

Else

' 32bitレガシー環境用 Private Declare Function SetTimer Lib "user32" (ByVal hwnd As Long, ByVal nIDEvent As Long, ByVal uElapse As Long, ByVal lpTimerFunc As Long) As Long Private Declare Function KillTimer Lib "user32" (ByVal hwnd As Long, ByVal nIDEvent As Long) As Long Private Declare Function PostMessage Lib "user32" Alias "PostMessageA" (ByVal hwnd As Long, ByVal wMsg As Long, ByVal wParam As Long, ByVal lParam As Long) As Long

End If

' 監視用定数 Private Const WM_USER As Long = &H400 Private Const WM_TIMER_TICK As Long = WM_USER + 1 Private timerID As LongPtr ' PtrSafe対応

3.2. 監視エンジンのコアロジック

次に、監視の心臓部となるロジックを実装する。ここでは、各シェイプが持つ `Shape Data` を走査し、許可された「環境キー」と一致するかを検証する。

' --- Sentinel Engine ---

''' <summary>
''' 監視プロセスの開始
''' </summary>
Public Sub StartSecurityWatchdog()
    ' すでに動いている場合は一度停止させる(二重起動防止)
    StopSecurityWatchdog
    
    ' 5秒間隔(5000ms)でバックグラウンド監視を開始
    ' 注: 本来はコールバック関数を渡すが、VBAの制約上、
    ' Timerイベントを擬似的に発生させる手法をとる
    timerID = SetTimer(0, 0, 5000, 0)
    
    If timerID = 0 Then
        Err.Raise vbObjectError + 513, "SecurityEngine", "Failed to initialize Windows Timer."
    End If
End Sub

''' <summary>
''' 監視プロセスの停止(メモリ解放を確実に行う)
''' </summary>
Public Sub StopSecurityWatchdog()
    If timerID <> 0 Then
        KillTimer 0, timerID
        timerID = 0
    End If
End Sub

''' <summary>
''' セキュリティ・スキャン実行
''' </summary>
Public Sub PerformSecurityScan()
    Dim doc As Visio.Document
    Dim sph As Visio.Shape
    Dim targetSignature As String
    Dim currentDocKey As String
    
    On Error GoTo ErrorHandler
    
    Set doc = ActiveDocument
    ' 許可されたドキュメントの識別子(Registryや外部APIから取得するのが理想)
    currentDocKey = GetAuthorizedEnvironmentKey()
    ' 期待される署名
    targetSignature = "PROT_SIG_v1_ALPHA"

    ' 全てのシェイプを走査(再帰的なスキャンが必要な場合は別途実装)
    For Each sph In doc.Shapes
        ' Shape Data "SecurityToken" を確認
        ' 存在しない、あるいは値が不一致の場合は不正利用とみなす
        If sph.CellExists("Prop.SecurityToken", 0) Then
            If sph.Cells("Prop.SecurityToken").Formula <> """" & targetSignature & """" Then
                ' 署名は存在するが、内容が現在の環境と矛盾する場合
                ' (例: 別のドキュメントから持ち込まれたシェイプ)
                Debug.Print "Unauthorized shape detected: " & sph.Name
                Call PurgeUnauthorizedShape(sph)
            End If
        End If
        
        ' もしくは、特定の署名を持つシェイプが「許可されていないドキュメント」にある場合
        ' ここでは「署名を持つシェイプは、特定のDocKeyを持つドキュメント内でのみ許容される」ロジックとする
        If sph.CellExists("Prop.SecurityToken", 0) Then
             If Not IsShapeAuthorizedInDoc(sph, currentDocKey) Then
                 Call PurgeUnauthorizedShape(sph)
             End If
        End If
    Next sph

CleanExit:
    ' オブジェクトの明示的解放(COM参照カウントの管理)
    Set sph = Nothing
    Set doc = Nothing
    Exit Sub

ErrorHandler:
    ' 実行時エラーが発生しても監視を止めないよう、適切にハンドリング
    Debug.Print "Scan Error: " & Err.Description
    Resume CleanExit
End Sub

''' <summary>
''' 不正なシェイプを排除する
''' </summary>
Private Sub PurgeUnauthorizedShape(ByRef sph As Visio.Shape)
    On Error Resume Next
    ' 警告なしで削除(ユーザーには「エラー」として見せることも可能)
    sph.Delete
    ' 必要に応じてログを外部サーバーへ送信する処理をここに挟む
End Sub

' --- 補助関数 (モック) ---
Private Function GetAuthorizedEnvironmentKey() As String
    ' 本来はレジストリやAPI、あるいはドキュメント独自の隠しプロパティから取得
    GetAuthorizedEnvironmentKey = "DOC_AUTH_2023_XYZ"
End Function

Private Function IsShapeAuthorizedInDoc(sph As Visio.Shape, docKey As String) As Boolean
    ' シェイプのデータとドキュメントの整合性をチェックする高度なロジック
    ' ここでは簡易的に、シェイプのデータにドキュメントIDが含まれているかを見る
    Dim shapeDocKey As String
    shapeDocKey = sph.Cells("Prop.TargetDocID").Formula
    IsShapeAuthorizedInDoc = (shapeDocKey = """" & docKey & """")
End Function

4. 実装の肝:オブジェクトのライフサイクルとパフォーマンス

シニアエンジニアとして、私が最も強調したいのは「パフォーマンスとメモリ管理」である。

1. COMオブジェクトの解放:
`PerformSecurityScan` 内で `Set sph = Nothing` を明示的に行うのは基本中の基本だ。Visioは大規模な図面になるとメモリ消費が激しく、スキャン処理が不適切であれば、タイマーが回るたびにメモリリークを引き起こし、アプリケーションのクラッシュを招く。

2. スキャンの計算量:
`For Each sph In doc.Shapes` は、図面が数千のオブジェクトを持つ場合、非常に重い処理になる。実戦では、`Document.Window.SelectionChange` イベントをトリガーにするか、あるいは `SetTimer` の間隔を長く(例:30秒〜1分)設定し、バックグラウンドでの負荷を最小限に抑える設計が求められる。

3. レガシー環境への配慮:
`#If VBA7` ディレクティブを用いた条件付きコンパイルは、現代の64bit環境と、依然として残るレガシーな32bit環境の両方をサポートするために不可欠である。

5. 結論:防御は「動的」であるべきだ

ステンシルの保護は、静的なファイルロックでは完結しない。
「シェイプがどこから来たのか」「今、どのコンテキストで存在しているのか」を、実行時に常に問い続ける仕組み。それこそが、高度な自動化システムに求められるセキュリティの真髄である。

本稿で示したセンチネル・パターンは、その第一歩に過ぎない。さらなる高みを目指すならば、署名アルゴリズムの暗号化や、検知時の外部サーバーへのテレメトリ送信といった、システム間連携の拡張を検討されたい。

技術の真理は、常に実装の細部に宿る。

Author: *Legendary Chief Architect*
Field: *Enterprise Automation & Intellectual Property Protection*

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