知的財産を死守せよ:Visio VBAによるステンシル・ライセンス認証の実装アーキテクチャ
業務自動化のプロフェッショナルとして、我々はしばしば「魔法の杖」をクライアントに提供する。それは、複雑なプロセスを一瞬で図式化する高度にカスタマイズされたステンシル(Stencil)である。
しかし、ここでエンジニアとしての倫理とビジネスの現実が衝突する。「作成したマスターシェイプのロジックやデザインは、誰のものか?」
一度配布したステンシルは、簡単にコピーされ、意図しないドキュメントで流用される。安価なツールとして提供したはずのものが、ライセンスを無視して広範囲に拡散される。これは、開発者の知的財産(IP)に対する侵害であり、ビジネスモデルの崩壊を意味する。
本稿では、単なる「ファイル名のチェック」のような素人工作ではない。「ドキュメントの指紋(Fingerprint)」を用いた、堅牢なライセンス認証メカニズムの設計思想と、実戦投入可能なプロダクションコードを伝授する。
1. なぜ、一般的な「制限」は失敗するのか
多くの開発者が陥る罠がある。それは、`If ActiveDocument.Name = “Target.vsdx” Then` といった、表面的なプロパティへの依存だ。
これには致命的な欠陥が3つある。
1. 偽装の容易さ: ファイル名を書き換えるだけで突破される。
2. ライフサイクルの無視: ステンシルが開かれた瞬間ではなく、シェイプがドロップされた瞬間の挙動を制御できていない。
3. 保守性の欠如: 許可するドキュメントが増えるたびに、VBAコードを書き換え、再配布しなければならない。
プロフェッショナルな設計では、「検証ロジック」と「許可リスト(ホワイトリスト)」を分離し、ドキュメントそのものに「正当性の証明」を埋め込む必要がある。
2. アーキテクチャ設計:指紋(Fingerprint)と検証エンジン
我々が実装すべきは、以下の3層構造を持つアーキテクチャである。
Layer 1: Document Fingerprinting (識別層)
ドキュメントのファイル名ではなく、ドキュメント内の「隠しプロパティ」または「ファイル内容のハッシュ値」を識別子とする。これにより、ファイル名変更による回避を封じる。
Layer 2: Centralized Validation (検証層)
検証ロジックをステンシル内に直接書かず、外部ファイル(JSON/Encrypted Text)またはデータベース(SQL Server/SQLite)に問い合わせる。これにより、コードを改変せずにライセンスの更新が可能になる。
Layer 3: Interceptor (介入層)
Visioのイベントモデル(`DocumentEvents`)を利用し、ステンシルがアクティブになった際、あるいはシェイプが操作された際に、バックグラウンドで「心拍(Heartbeat)」チェックを行う。
3. プロダクション・コード実装
以下に、実務レベルで動作するライセンス管理モジュールの実装例を示す。ここでは、ドキュメントのカスタムプロパティに埋め込まれた「ライセンスキー」を、外部の暗号化されたリストと照合する手法をとる。
3.1 LicenseManager モジュール
このモジュールは、認証のコアロジックを担当する。
' MODULE: LicenseManager
Option Explicit
' ライセンス状態を保持する定数
Public Const LICENSE_STATUS_VALID As Integer = 1
Public Const LICENSE_STATUS_INVALID As Integer = 0
''' <summary>
''' ドキュメントの正当性を検証する。
''' </summary>
''' <param name="doc">検証対象のDocumentオブジェクト</param>
''' <returns>検証結果 (1: OK, 0: NG)</returns>
Public Function ValidateDocumentLicense(ByRef doc As Visio.Document) As Integer
On Error GoTo ErrorHandler
Dim licenseKey As String
Dim isValid As Boolean
' 1. ドキュメントのカスタムプロパティから隠しキーを取得
' ※ プロパティ名は難読化しておくことが推奨される
On Error Resume Next
licenseKey = doc.CustomProperties("X_Auth_Token").Result
On Error GoTo ErrorHandler
If licenseKey = "" Then
Debug.Print "Error: License token missing."
ValidateDocumentLicense = LICENSE_STATUS_INVALID
Exit Function
End If
' 2. 外部の「正当なキーリスト」と照合
' 本来はAPI経由や暗号化ファイルから読み込むべきだが、ここでは概念を示す
isValid = CheckAgainstMasterList(licenseKey)
If isValid Then
ValidateDocumentLicense = LICENSE_STATUS_VALID
Else
ValidateDocumentLicense = LICENSE_STATUS_INVALID
End If
Exit Function
ErrorHandler:
Debug.Print "Critical Error in License Validation: " & Err.Description
ValidateDocumentLicense = LICENSE_STATUS_INVALID
End Function
''' <summary>
''' 外部マスターリスト(DBまたは暗号化ファイル)との照合ロジック
''' </summary>
Private Function CheckAgainstMasterList(ByVal key As String) As Boolean
' 【実務上の注意点】
' ここで直接ハードコードするのは厳禁。
' 実際には、HTTPS通信によるAPIコール、あるいは
' AES暗号化されたテキストファイルとの照合を行う。
Dim allowedKeys As Variant
' サンプルとしての許可リスト(本来は外部から取得)
allowedKeys = Array("TOKEN_PROJ_A_2023", "TOKEN_CORP_B_999")
Dim i As Long
For i = LBound(allowedKeys) To UBound(allowedKeys)
If key = allowedKeys(i) Then
CheckAgainstMasterList = True
Exit Function
End If
Next i
CheckAgainstMasterList = False
End Function
3.2 Application Event Interceptor
ステンシルが読み込まれた際、あるいはドキュメントが切り替わった際に自動的に実行されるガードレールだ。
' MODULE: ThisDocument (または Applicationレベルのイベントハンドラ)
Option Explicit
' ステンシルが開かれた際のイベント
Private Sub Document_Open()
Dim authStatus As Integer
' 認証実行
authStatus = LicenseManager.ValidateDocumentLicense(ThisDocument)
If authStatus = LicenseManager.LICENSE_STATUS_INVALID Then
' 認証失敗時の致命的な処置
MsgBox "Unauthorized Document. " & vbCrLf & _
"This stencil is not licensed for use in this file.", _
vbCritical, "License Violation"
' ユーザーへの警告後、ステンシルを閉じる、あるいは機能を無効化する
' ここでは、強制終了に近い挙動をとる
ThisDocument.Close
Else
Debug.Print "License Verified. Welcome."
End If
End Sub
4. 運用における「極限の知見」:エンジニアが守るべき鉄則
コードを書いただけで満足してはいけない。真のアーキテクトは、以下の「攻撃ベクトル」を考慮して設計を仕上げる。
1. オブジェクトのライフサイクルとメモリ管理
VBAのイベントハンドラ内で重いAPI通信(HTTPリクエストなど)を行うと、VisioのUIスレッドがブロックされ、ユーザー体験を著しく損なう。
- 対策: 認証は「ドキュメントが開いた瞬間」に非同期的に行うか、あるいは「重要なシェイプがドロップされた瞬間」に、キャッシュされた認証結果を参照する形にする。
2. 「隠しプロパティ」の難読化
`X_Auth_Token` という名前では、ユーザーがVisioのプロパティ画面から簡単に書き換えられる。
- 対策: プロパティ名は `_sys_id_ref` のような、システム的に見えて、かつ意味を持たない名称にする。また、キー自体は `SHA-256` 等でハッシュ化された値を格納せよ。
3. データベース連携の堅牢性
外部DBに依存する場合、ネットワーク切断が「ライセンスエラー」として誤検知されるリスクがある。
- 対策: 「Fail-Safe(安全側への失敗)」をどう設計するか。オフライン環境での利用を許容する場合、有効期限付きの「ローカル・オフライン・トークン」を発行する仕組みを組み込むのがプロの仕事だ。
4. 最終的な防衛線:VSTOへの移行
正直に言おう。VBAは、メモリを覗き見られる(Memory Dumping)ことに対して無防備だ。
もし、あなたの提供するステンシルが数千万円規模の価値を持つIPであるなら、VBAを卒業し、C#によるVSTO (Visual Studio Tools for Office) アドインへ移行せよ。コンパイルされたDLLは、VBAのコードよりも遥かに解析が困難であり、より高度な暗号化ライブラリを直接利用できる。
結論
ライセンス認証の実装は、単なる「制限」ではない。それは、あなたの技術力と、クライアントに対する「プロフェッショナルとしての規律」の証明である。
「動けばいい」コードを書く者と、「破られない設計」を書く者。
その差は、オブジェクトのライフサイクル、エラーハンドリング、そして攻撃者の視点を持っているかどうかに集約される。
次回のプロジェクトでは、ぜひこの「指紋認証アーキテクチャ」を検討してほしい。
