知的財産の防衛線:Visioマスターシェイプの暗号化配布と動的ロード・アーキテクチャ
業務自動化のプロフェッショナルとして、我々は単に「動くツール」を作るのではない。クライアントの、あるいは自社の「知財(Intellectual Property)」を守る「堅牢なシステム」を構築しなければならない。
Visioを用いた業務ツール開発において、最も価値がある資産の一つは、独自に作り込まれたステンシル(.vssx)内のマスターシェイプだ。そこには、高度に計算された形状、埋め込まれたメタデータ、そして業務プロセスそのものが凝縮されている。これをそのまま配布するのは、設計図を路上に放置するのと同義である。
本記事では、ステンシルを暗号化して配布し、実行時にのみメモリ(一時ファイル)上で復号してロードする、プロフェッショナル向けのセキュリティ・パターンを伝授する。
1. なぜ「パスワード保護」では不十分なのか
初心者はよく「VBAプロジェクトにパスワードをかける」か「ファイル自体にパスワードをかける」ことで満足する。しかし、それは設計思想として極めて脆弱だ。
- VBAパスワード: ツールが存在すれば、数秒で解析される。
- ファイルパスワード: ユーザーがパスワードを知る必要がある。自動化ツールの利便性を損なうだけでなく、パスワードの管理自体が新たなセキュリティリスクとなる。
我々が目指すべきは、「ユーザーには中身を見せず、プログラムだけがその正体を知っている」状態、すなわち透過的な復号ロードである。
2. 設計アーキテクチャ:Ephemeral File Pattern(一時ファイル・パターン)
VisioのAPIには「暗号化されたストリームを直接マスターとして読み込む」というメソッドは存在しない。したがって、以下のライフサイクルを持つ設計を採用する。
1. Pre-deployment (事前準備): ステンシルをAESなどの強力なアルゴリズムで暗号化し、拡張子を変えて配布する(例: `.vssx` $\rightarrow$ `.dat`)。
2. Runtime Decryption (実行時復号): VBAが起動した際、暗号化ファイルを読み込み、メモリ上で復号して「一時的な場所」へ書き出す。
3. Dynamic Loading (動的ロード): 書き出した一時ファイルをVisioのステンシルとしてロードする。
4. Secure Cleanup (セキュアな破棄): 処理終了後、あるいはエラー発生時に、一時ファイルを即座に抹消する。
3. 実装:プロダクション・グレードのコード例
ここでは、Windows標準の強力な暗号化ライブラリ(`System.Security.Cryptography`)をVBAからLate Binding(遅延結合)で呼び出す手法を用いる。これにより、外部DLLへの依存を避けつつ、軍用レベルのAES暗号化を実現する。
準備:暗号化ロジックの核となるモジュール
このコードは、単なるコピペ用ではない。エラーハンドリングとリソース管理(ファイルのロック回避)を徹底した、実戦的な設計に基づいている。
Option Explicit
' ==============================================================================
' Module: StencilSecurityManager
' Description: 暗号化されたステンシルを安全に復号・ロードする管理クラス
' ==============================================================================
Private Const AES_ALGORITHM As String = "AES"
Private m_tempFilePath As String
''' <summary>
''' 暗号化されたステンシルを復号し、Visioにロードする
''' </summary>
''' <param name="encryptedPath">暗号化されたファイルのフルパス</param>
''' <param name="key">復号用キー(32バイト推奨)</param>
''' <returns>ロードされたStencilオブジェクト</returns>
Public Function LoadEncryptedStencil(ByVal encryptedPath As String, ByVal key As String) As Visio.Stencil
Dim decryptor As Object
Dim fileStreamIn As Object
Dim fileStreamOut As Object
Dim bytesKey() As Byte
Dim bytesEncrypted() As Byte
Dim bytesDecrypted() As Byte
On Error GoTo ErrorHandler
' 1. キーの準備 (UTF-8バイト配列へ変換)
bytesKey = StrConv(key, vbFromUnicode)
' ※ 実際にはキーの長さをAESの要件(16, 24, 32byte)に合わせる処理が必要
' 2. 暗号化ファイルの読み込み
bytesEncrypted = ReadFileToBytes(encryptedPath)
' 3. 復号処理 (System.Security.Cryptography を利用)
' late binding により、参照設定なしで動作させる
Set decryptor = CreateObject("System.Security.Cryptography.RijndaelManaged")
decryptor.Key = bytesKey
' IV(初期化ベクトル)は簡略化のためキーの一部を利用する設計とするが、
' 本番環境では別途管理することを強く推奨する
decryptor.IV = Left(bytesKey, 16)
Dim transform As Object
Set transform = decryptor.CreateDecryptor()
' 復号実行
bytesDecrypted = transform.TransformFinalBlock(bytesEncrypted, 0, UBound(bytesEncrypted) + 1)
' 4. 一時ファイルへの書き出し
m_tempFilePath = Environ("TEMP") & "\v_tmp_" & Format(Now, "yyyymmddhhnnss") & ".vssx"
WriteBytesToFile m_tempFilePath, bytesDecrypted
' 5. Visioへのロード
Set LoadEncryptedStencil = Visio.Application.Documents.Add(m_tempFilePath)
Exit Function
ErrorHandler:
Debug.Print "Critical Error in LoadEncryptedStencil: " & Err.Description
CleanupTempFile
Set LoadEncryptedStencil = Nothing
End Function
''' <summary>
''' 使用後に一時ファイルを削除する
''' </summary>
Public Sub CleanupTempFile()
On Error Resume Next
If m_tempFilePath <> "" Then
' ファイルが存在する場合のみ削除
If Dir(m_tempFilePath) <> "" Then
Kill m_tempFilePath
End If
m_tempFilePath = ""
End If
On Error GoTo 0
End Sub
' --- 内部補助関数 (Private) ---
Private Function ReadFileToBytes(ByVal filePath As String) As Byte()
Dim stream As Object
Set stream = CreateObject("ADODB.Stream")
stream.Type = 1 ' adTypeBinary
stream.Open
stream.LoadFromFile filePath
ReadFileToBytes = stream.Read
stream.Close
End Function
Private Sub WriteBytesToFile(ByVal filePath As String, ByVal data() As Byte)
Dim stream As Object
Set stream = CreateObject("ADODB.Stream")
stream.Type = 1 ' adTypeBinary
stream.Open
stream.Write data
stream.SaveToFile filePath, 2 ' adSaveCreateOverWrite
stream.Close
End Sub
4. 運用における「極限の知見」:設計上の注意点
このコードをプロダクション環境に投入する際、以下の3点を必ず考慮せよ。これができなければ、アーキテクトとは呼べない。
# ① キー管理のジレンマ(Key Management)
コード内に `key = “my_secret_key_123…”` と直書きするのは、暗号化の意味をゼロにする行為だ。
- 推奨: キーは環境変数、あるいは社内ネットワーク上の共有レジストリ、または実行時にAPI経由で取得する。
- 高度な設計: ユーザーのWindows SID(Security Identifier)に基づいて動的に生成されるキーを使用すれば、ファイルが盗まれても他のPCでは復号できない。
# ② ファイルロックとクリーンアップの罠
Visioがステンシルをロードしている間、そのファイルはプロセスによってロックされる。そのため、`CleanupTempFile` を呼び出しても `Kill` が失敗することがある。
- 対策: `CleanupTempFile` は、アプリケーションの終了イベント(`App_Terminate`)や、プロジェクトの `Unload` イベントで確実に実行されるよう、ライフサイクルを管理せよ。また、エラー発生時には必ず `On Error GoTo` を通じてクリーンアップへ誘導する設計を徹底すること。
# ③ パフォーマンスの重み
AES復号とディスクI/Oは、巨大なステンシルの場合、数秒の遅延を生む。
- 対策: 起動時に一度だけロードし、そのインスタンスをメモリ上に保持(キャッシュ)するシングルトン・パターンを検討せよ。毎回ロードするのは、プロフェッショナルの仕事ではない。
結論:防御力は設計の深さに比例する
ステンシルの暗号化は、単なる「隠し事」ではない。それは、エンジニアが心血を注いで構築したロジックと資産に対する、「プロフェッショナルとしての責任」である。
今回示した「一時ファイル・パターン」は、Visioの制約の中で最大限のセキュリティを実現するための現実的な解だ。このアーキテクチャをベースに、君たちのプロジェクトに相応しい、より強固なキー管理戦略を組み込んでほしい。
「動くコード」を書く者は多い。しかし、「守れるコード」を書ける者こそが、真のアーキテクトである。
