【入門編】【上級】ステンシル内のマスターシェイプを「暗号化」して配布し、実行時に復号する – Visio VBA解析バイブル

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

知的財産を守り抜く:Visio VBAで実現する「ステンシル暗号化配布」の極意

こんにちは。技術の深淵へようこそ。

「マクロの記録」を卒業し、自分でコードを書き始めたあなた。今、Visio VBAを使って「業務を自動化するツール」を作り上げていることでしょう。それは素晴らしい一歩です。しかし、プロフェッショナルなエンジニアとして、一つの大きな壁にぶつかる時が来ます。

それは、「自分が苦労して作り上げた、秘伝のマスターシェイプ(ステンシル)を、どうやって守るか?」という問題です。

せっかく高度なロジックを組み込んだシェイプを作っても、ステンシルファイル(.vssx)をそのまま渡してしまえば、中身の構造や設定は誰でも簡単に覗けてしまいます。これは、エンジニアとしての「知的財産」が丸裸にされることを意味します。

今日は、一歩上のステージへ進むために、「ステンシルを暗号化して配布し、実行時にメモリ(または一時ファイル)上で復号して読み込む」という、極めて実践的かつ高度なアーキテクチャを解説します。

難しく感じるかもしれませんが、大丈夫。仕組みさえ理解すれば、決して不可能ではありません。一緒に解き明かしていきましょう。

1. なぜ「そのまま配布」ではいけないのか?

まず、私たちが直面している問題の正体を整理しましょう。

通常のVisio運用では、以下のような流れになります。
1. マスターシェイプを作成する(`.vssx`)
2. ユーザーにそのファイルを渡す
3. ユーザーがVisioでそのステンシルを開いて使う

この流れの弱点は、「ファイルが物理的に存在している限り、解析可能である」という点です。Visioのファイルは実態としてXMLの集合体です。中身のプロパティや、シェイプに仕込んだ隠れたロジックは、専門知識があれば容易に読み取れてしまいます。

そこで、私たちが実装するのは「動的な展開(Dynamic Deployment)」という考え方です。

理想的なワークフロー

1. 開発時: ステンシルを暗号化し、拡張子を変えた「暗号化データファイル(例: `.dat`)」として保存。
2. 配布時: 暗号化されたファイルのみを配布。
3. 実行時(VBA):

  • VBAが暗号化ファイルを読み込む。
  • メモリ上で復号し、一時的な `.vssx` として書き出す。
  • その一時ファイルをVisioにロードする。
  • 【重要】 使い終わったら、痕跡を消すために即座に削除する。

2. 実装の設計図:オブジェクトのライフサイクルを制御する

この仕組みを作る上で最も重要なのは、「ファイルの寿命(ライフサイクル)」を管理することです。

もし復号したファイルを消し忘れたらどうなるでしょう? ユーザーのPCに、生(なま)のステンシルが残り続けてしまいます。これはセキュリティ対策として失敗です。

制御フローの図解

graph TD
    A[暗号化済みファイル .dat] -->|VBAが読み込み| B{復号処理}
    B -->|一時ファイル作成| C[一時的な .vssx]
    C -->|Visioでオープン| D[ステンシル利用開始]
    D -->|利用終了/エラー発生| E[一時ファイルを削除]
    E --> F[クリーンな状態へ]

3. 実践:暗号化・復号エンジンの実装

それでは、具体的なコードを見ていきましょう。
ここでは、初心者の方でも仕組みが理解しやすいよう、今回は「Base64エンコード+簡易的なXOR演算」を組み合わせた暗号化ロジックを使用します。
(※実務で極めて高い機密性を求める場合は、Windows APIを用いたAES暗号化を検討してください。しかし、基礎を学ぶにはこの方法が最適です)

ステップ1:暗号化ユーティリティ

まずは、配布用のファイルを作るための「暗号化関数」を用意します。

' --- 暗号化用モジュール ---
Option Explicit

' 簡易的なXOR暗号化関数
' key: 暗号化に使用するパスワード(文字列)
' inputData: 暗号化したいバイナリデータ
Public Function EncryptData(ByVal inputData() As Byte, ByVal key As String) As Byte()
    Dim i As Long
    Dim keyBytes() As Byte
    Dim result() As Byte
    Dim keyLen As Long
    
    keyBytes = StrConv(key, vbFromUnicode)
    keyLen = UBound(keyBytes)
    ReDim result(UBound(inputData))
    
    ' XOR演算による暗号化(データの各バイトに対してキーを適用)
    For i = 0 To UBound(inputData)
        result(i) = inputData(i) Xor keyBytes(i Mod (keyLen + 1))
    Next i
    
    EncryptData = result
End Function

' ファイルを暗号化して保存するサブプロシージャ(開発時に一度だけ実行)
Public Sub CreateSecureStencil(ByVal sourcePath As String, ByVal destPath As String, ByVal key As String)
    Dim fileNum As Integer
    Dim fileData() As Byte
    
    ' 1. 元のステンシルをバイナリとして読み込む
    fileNum = FreeFile
    Open sourcePath For Binary Access Read As #fileNum
        ReDim fileData(LOF(fileNum) - 1)
        Get #fileNum, , fileData
    Close #fileNum
    
    ' 2. 暗号化を実行
    Dim encryptedData() As Byte
    encryptedData = EncryptData(fileData, key)
    
    ' 3. 暗号化データを保存
    fileNum = FreeFile
    Open destPath For Binary Access Write As #fileNum
        Put #fileNum, , encryptedData
    Close #fileNum
    
    MsgBox "暗号化ファイルの作成が完了しました!: " & destPath
End Sub

ステップ2:実行時の復号・ロード・自動消去

次に、ユーザーがVisioを開いたときに動く「メインエンジン」です。ここが、プロフェッショナルな設計の肝となります。

' --- メイン実行モジュール ---
Option Explicit

Private Const SECRET_KEY As String = "MySuperSecretKey123" ' ここが鍵
Private m_tempStencilPath As String ' 一時ファイルのパスを保持

' ステンシルを安全にロードするメイン関数
Public Sub LoadSecureStencil()
    Dim encryptedFilePath As String
    Dim fso As Object
    Set fso = CreateObject("Scripting.FileSystemObject")
    
    ' 配布されている暗号化ファイルのパス
    encryptedFilePath = ThisDocument.Path & "\MasterShapes.dat"
    
    ' 一時ファイルのパスを生成(ユーザーのTempフォルダを利用)
    m_tempStencilPath = Environ("TEMP") & "\vba_temp_stencil_" & Format(Now, "yyyymmddhhmmss") & ".vssx"
    
    On Error GoTo ErrorHandler
    
    ' 1. 暗号化ファイルの読み込み
    Dim fileNum As Integer
    Dim encryptedData() As Byte
    fileNum = FreeFile
    Open encryptedFilePath For Binary Access Read As #fileNum
        ReDim encryptedData(LOF(fileNum) - 1)
        Get #fileNum, , encryptedData
    Close #fileNum
    
    ' 2. 復号処理(暗号化と同じXORをもう一度かけると元に戻ります)
    Dim decryptedData() As Byte
    decryptedData = EncryptData(encryptedData, SECRET_KEY)
    
    ' 3. 一時ファイルとして書き出し
    fileNum = FreeFile
    Open m_tempStencilPath For Binary Access Write As #fileNum
        Put #fileNum, , decryptedData
    Close #fileNum
    
    ' 4. Visioでステンシルを開く
    Dim stenc As Visio.Document
    Set stenc = Application.Documents.OpenEx(m_tempStencilPath, visOpenDockable, visOpenReadOnly)
    
    MsgBox "セキュア・ステンシルをロードしました。"
    Exit Sub

ErrorHandler:
    MsgBox "エラーが発生しました: " & Err.Description, vbCritical
    CleanupTempFile
End Sub

' 一時ファイルを削除するクリーンアップ処理
Public Sub CleanupTempFile()
    Dim fso As Object
    Set fso = CreateObject("Scripting.FileSystemObject")
    
    ' ファイルが存在し、かつVisioで開かれていない場合のみ削除を試みる
    ' (実際にはドキュメントをCloseしてから行う必要がある)
    On Error Resume Next
    If m_tempStencilPath <> "" Then
        If fso.FileExists(m_tempStencilPath) Then
            Kill m_tempStencilPath
        End If
    End If
    On Error GoTo 0
End Sub

4. 陥りやすいエラーと「エンジニアの心得」

このコードを動かす際、初心者が必ずと言っていいほど躓くポイントが3つあります。ここをクリアすれば、あなたはもう「ただのマクロ使い」ではありません。

① ファイルのロック問題

`Kill` コマンド(ファイル削除)を実行しようとしたとき、「ファイルが別のプロセスで使用されているため、アクセスできません」というエラーが出ることがあります。これは、Visioがまだそのファイルを「開いている」と認識しているからです。

  • 対策: ステンシルを使い終わったら、必ず `stenc.Close` を呼び出し、オブジェクトを解放してから削除処理へ移るよう設計してください。

② エラーハンドリングの欠如

復号の途中でエラーが起きたり、ユーザーが途中でマクロを強制終了したりした場合、一時ファイルがPCの中に残り続けてしまいます。

  • 対策: `On Error GoTo ErrorHandler` を使い、どのようなエラーが起きても必ず `CleanupTempFile` を通るような「防衛的プログラミング」を徹底しましょう。

③ パフォーマンスの重み

毎回、起動のたびに大きなファイルを復号して書き出すのは、ユーザー体験(UX)を損なう可能性があります。

  • 対策: もしステンシルが非常に巨大な場合は、一度復号したものをメモリ上にキャッシュするか、あるいは「セッション中のみ有効な一時的な場所」に展開する工夫が必要です。

最後に

いかがでしたか?
「暗号化して配布する」という行為は、単なるテクニックではありません。それは、「自分が作った価値を、どのように守り、どのようにユーザーに届けるか」という、プロダクト設計の思想そのものです。

最初はエラーに苦しむかもしれません。しかし、オブジェクトの寿命をコントロールし、例外処理を丁寧に書き込む経験こそが、あなたを「伝説のアーキテクト」へと押し上げる糧になります。

ここをクリアすれば、Visio VBAの基本はバッチリですよ。
さあ、次のコードを書きに行きましょう!応援しています。

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