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

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

【上級】ステンシル配布時の「ライセンス認証」:VBAでマスターシェイプの使用を制限する

こんにちは。現場の最前線でアーキテクチャを設計している、あなたの「少し先を行く先輩」です。

Visioで独自の図形集(ステンシル)を作り上げ、業務効率化のツールとして完成させたとき、ふとこんな不安がよぎることはありませんか?

「この素晴らしい図形セットをクライアントに渡したとき、勝手に他の図面にもコピーして使い回されたらどうしよう……」

あなたが心血を注いで作り上げたマスターシェイプは、立派な知的財産です。単に「ファイルを渡す」だけでは、その価値を守ることはできません。

今日は、マクロの記録レベルを卒業し、「オブジェクトの挙動を制御する」という、プロフェッショナルな領域への第一歩を踏み出しましょう。テーマは「VBAによるステンシル使用のライセンス制限」です。

1. なぜ「ファイル名チェック」では足りないのか?

初学者の皆さんが最初に思いつく制限方法は、おそらくこうです。
「もしファイル名が『契約書.vsdx』じゃなかったら、エラーを出す」

' 💡 惜しい!これでは不十分な理由
If ActiveDocument.Name <> "Contract.vsdx" Then
    MsgBox "許可されていないドキュメントです。"
End If

しかし、これでは不十分です。ユーザーがファイル名を「Contract_backup.vsdx」と書き換えた瞬間に、あなたのセキュリティは無力化されます。

プロのエンジニアは、ファイル名のような「表面的な属性」ではなく、「ドキュメントのアイデンティティ(一意のID)」や「ドロップというイベントの発生」に着目します。

今回は、「図形がページにドロップされた瞬間を検知し、許可されたドキュメント以外なら即座に消去する」という、より強固なガードマン(イベントハンドラ)を実装する方法を学びます。

2. アーキテクチャの設計図:イベントハンドラの仕組み

Visio VBAで「何かが起きたとき(ドロップされたときなど)」に自動で処理を走らせるには、「イベントハンドラ」という仕組みを使います。

ここが最大の難所です。通常のモジュールにコードを書くだけでは、Visioは「ドロップされた」という通知をあなたに送ってくれません。

実装の全体像

1. クラスモジュール: 「ドロップされた」というイベントを待ち構える「耳」の役割。
2. 標準モジュール: プログラムを開始し、「耳」を起動させる「スイッチ」の役割。
3. 認証ロジック: 許可されたドキュメントかどうかを判定する「脳」の役割。

3. 実装コード:鉄壁のガードマンを作る

では、実際にコードを書いていきましょう。以下の手順通りに進めてください。

Step 1: クラスモジュールの作成

まず、VBAエディタのメニューから `挿入` -> `クラスモジュール` を選択してください。
作成されたクラスの名前を、プロパティウィンドウから `clsDocumentEvent` に変更してください。

' --- クラスモジュール: clsDocumentEvent ---
Option Explicit

' Visioのドキュメントイベントをキャッチするための宣言
' WithEvents を使うことで、イベントを監視できるようになります
Public WithEvents Doc As Visio.Document

' ドキュメントに図形がドロップ(貼り付け)されたときに発生するイベント
Private Sub Doc_Drop(ByVal DropEvent As Visio.DropEvent)
    Dim targetShape As Visio.Shape
    
    ' ドロップされた対象(シェイプ)を取得
    Set targetShape = DropEvent.Shape
    
    ' 🛡️ 【ライセンス認証ロジック】
    ' ここでは例として、ドキュメントの「GUID(一意のID)」をチェックします
    ' ファイル名ではなく、ドキュメントそのものの固有IDを見るのがプロの技です
    
    If Not IsAuthorized(Doc) Then
        ' 許可されていない場合、ドロップされた図形を即座に削除
        targetShape.Delete
        
        ' ユーザーに警告を表示
        MsgBox "【警告】このマスターシェイプは、ライセンス認証された" & vbCrLf & _
               "特定のドキュメント以外では使用できません。", vbCritical, "アクセス拒否"
    End If
End Sub

' 認証判定関数(ここをカスタマイズしてセキュリティを高める)
Private Function IsAuthorized(ByVal targetDoc As Visio.Document) As Boolean
    ' 本来はここに、許可されたドキュメントのGUIDや、
    ' 外部サーバーへ問い合わせるAPI通信などを記述します。
    ' 今回はデモとして「特定の名前のドキュメント」を許可対象とします。
    
    Const AUTHORIZED_NAME As String = "Master_Project_2024"
    
    If targetDoc.Name = AUTHORIZED_NAME Then
        IsAuthorized = True
    Else
        IsAuthorized = False
    End If
End Function

Step 2: 標準モジュールの作成

次に、`挿入` -> `標準モジュール` を選択し、以下のコードを記述します。これがプログラムの起動スイッチになります。

' --- 標準モジュール ---
Option Explicit

' クラスのインスタンスを保持するための変数
' ここで宣言しないと、マクロ終了時に「耳」が消えてしまいます
Dim myDocHandler As clsDocumentEvent

' プログラムを開始するメインルーチン
Sub InitializeSecurity()
    ' クラスをインスタンス化(実体化)
    Set myDocHandler = New clsDocumentEvent
    
    ' 現在開いているドキュメントに対して、イベントの監視を開始
    Set myDocHandler.Doc = ActiveDocument
    
    MsgBox "セキュリティ・ガードマンが起動しました。", vbInformation
End Sub

' 監視を停止する場合
Sub StopSecurity()
    Set myDocHandler = Nothing
    MsgBox "ガードマンは退勤しました。", vbInformation
End Sub

4. ここがポイント!陥りやすいエラーと回避策

この実装を進める上で、皆さんが必ずと言っていいほどぶつかる壁が2つあります。

① 「ガードマンが動かない!」問題

一番多いのが、「`InitializeSecurity` を実行し忘れている」ケースです。
VBAのイベント監視は、プログラムが動いている間だけ有効です。ファイルを閉じたり、マクロを終了したりすると、クラスのインスタンス(`myDocHandler`)がメモリから消えてしまい、監視が止まります。

プロのアドバイス:
実際の業務ツールでは、`ThisDocument` モジュールの `Document_Open` イベントの中に `InitializeSecurity` を記述します。これにより、ファイルを開いた瞬間に自動でガードマンが配備されるようになります。

② 「図形が消えすぎて困る」問題

今回のコードは「ドロップされた瞬間に消す」という非常に強力なものです。もし認証ロジックにミスがあると、ユーザーは何も描けない地獄のような状況になります。

プロのアドバイス:
開発中は、`targetShape.Delete` の代わりに `Debug.Print “Unauthorized drop detected”` と記述して、イミディエイトウィンドウにログを出すだけに留めましょう。「破壊的な操作」は、テストが完了するまで絶対に本番コードに混ぜてはいけません。

5. 次のステップへ:さらなる高みを目指すなら

今回実装したのは、あくまで「クライアントサイド(Visio内)」での制限です。非常に強力ですが、VBAのコード自体を解析されると突破されるリスクはゼロではありません。

真のプロフェッショナルを目指すなら、以下の技術を組み合わせてみてください。

1. GUIDによる認証: `ActiveDocument.Application.Version` などの情報を利用し、ファイル名に依存しないチェックを行う。
2. 外部APIとの連携: VBAからHTTPリクエストを送り、サーバー上のデータベースに「このユーザーは利用権限があるか?」を問い合わせる。
3. コードの難読化: VBAプロジェクトにパスワードをかけることは基本ですが、それだけでなく、ロジックを複雑にして解析を困難にする。

まとめ

「ただ図形を並べる」フェーズから、「仕組みを制御する」フェーズへ。
今回学んだクラスモジュールを使ったイベントハンドリングは、Visio VBAにおける最も強力な武器の一つです。

オブジェクトのライフサイクル(生成→イベント発生→破棄)を意識できるようになれば、あなたの書くコードは単なる「自動化」を超え、一つの「システム」へと進化します。

ここをクリアすれば、Visio VBAの基本はバッチリですよ。自信を持って、次の開発に挑んでくださいね!

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