Blender® Addons License Manager

—

アドオン

—

発行済みライセンス

—

アクティブ

—

管理者

—

承認待ち申請

最近発行したライセンスすべて見る

ライセンスキー	アドオン	メール	状態	発行者	発行日
読み込み中…

アドオン別ライセンス数

表示：

	申請日時	メール	アドオン	メッセージ	状態
読み込み中…

読み込み中…

絞り込み

	ライセンスキー	アドオン	メール	状態	アクティベーション	発行者	発行日	有効期限
読み込み中…

—

日時	ライセンスキー	アドオン	IPアドレス	マシンID	結果
読み込み中…

ロール権限一覧

権限	オーナー	管理者	閲覧者
ダッシュボード閲覧
ライセンス閲覧
ライセンス発行・失効
アドオン追加・編集
管理者の追加・削除
API設定・キー再生成

管理者一覧

名前	メール	ロール	最終ログイン	登録日
読み込み中…

エンドポイント一覧

ベースURL

メソッド	パス	説明
POST	`/verify`	ライセンス認証
GET	`/status/{key}`	ライセンス状態確認
POST	`/deactivate`	アクティベーション解除

Blender アドオン実装サンプル

import requests

LICENSE_API = "https://your-server.example.com/api/v1"

def verify_license(key: str) -> bool:
    try:
        res = requests.post(
            f"{LICENSE_API}/verify",
            json={"key": key, "machine_id": get_machine_id()},
            timeout=5
        )
        return res.json().get("valid", False)
    except Exception:
        return False

APIキー管理（オーナーのみ）

レスポンス例

成功時

{"valid": true, "addon": "MeshFlow Pro", "expires_at": null, "activations": 1}

失敗時

{"valid": false, "reason": "activation_limit_exceeded"}

license_client.py ダウンロード

自分のアドオンにライセンス認証機能を追加するためのモジュールです。設定値を入力してダウンロードしてください。

アドオン選択 *

選択するとADDON_IDとADDON_NAMEが自動入力されます

ADDON_NAME（表示名）

ADDON_ID

CHECK_DAYS（確認間隔・日）

API_BASE（自動）

API_KEY はセキュリティ上ダウンロードファイルに含まれません。ダウンロード後、ファイル内の YOUR_API_KEY_HERE を上の「APIキー管理」欄のキーに置き換えてください。

アドオンへの導入方法

上のフォームで設定を入力し、license_client.py をダウンロードする
ダウンロードしたファイルの API_KEY 欄に、上の「APIキー管理」のキーを貼り付ける
ADDON_MODULE をアドオンのフォルダ名（パッケージ名）に変更する
ADDON_MODULE = "your_addon_folder" # ← ここを変更
license_client.py をアドオンフォルダに配置する

アドオンの __init__.py に以下を追加する：

from . import license_client
from . import your_feature_module  # 機能モジュール

def register():
    license_client.setup(
        on_activate   = lambda: your_feature_module.register(),
        on_deactivate = lambda: your_feature_module.unregister(),
    )

def unregister():
    license_client.teardown()

Blenderでアドオンをインストール・有効化し、プリファレンス画面でライセンスキーを認証する

ドキュメント

ロールと権限

機能	オーナー	管理者	閲覧者
ダッシュボード閲覧	✓	✓	✓
ライセンス・アクティベーション閲覧	✓	✓	✓
ライセンス発行・失効	✓	✓	✗
アドオン追加・編集・削除	✓	✓	✗
申請承認・却下	✓	✓	✗
管理者の追加・削除・ロール変更	✓	✗	✗
APIキー再生成・ダウンロード	✓	✗	✗

ライセンス管理の流れ

アドオン登録：「アドオン管理」→「＋アドオンを追加」でアドオンを登録する。IDが発行される。
APIキー発行：「API設定」→「キーを再生成」でAPIキーを発行し、license_client.py に設定する。
license_client.py 配布：「API設定」→「license_client.py をダウンロード」で設定済みファイルを取得し、アドオンに同梱して配布する。
ユーザーが申請：Blenderのアドオン設定画面からメールアドレスを入力して申請する。
管理者が承認：「ライセンス申請」画面で申請を確認し、承認するとライセンスキーがメールで自動送付される。
ユーザーが認証：受け取ったライセンスキーをBlenderのアドオン設定画面に入力して認証する。

license_client.py 設定項目

項目	説明	設定例
`ADDON_MODULE`	アドオンのフォルダ名（パッケージ名）。必ず変更してください。	`"my_addon"`
`ADDON_NAME`	アドオンの表示名。サーバー未登録時の自動作成に使用。	`"My Addon"`
`ADDON_ID`	管理画面のアドオン管理で確認できるID番号。	`1`
`API_KEY`	API設定画面で生成したキー。外部に漏洩しないよう注意。	`"sk-xxxx..."`
`API_BASE`	このサーバーのURL + `/api/v1`。	`"https://example.com/api/v1"`
`CHECK_DAYS`	サーバーへのライセンス再確認間隔（日）。オフライン時も有効。	`30`

__init__.py の最小構成

import bpy
from . import license_client
from . import your_feature_module  # 機能モジュール

bl_info = {
    "name": "My Addon",
    "version": (1, 0, 0),
    "blender": (4, 0, 0),
    "category": "3D View",
}

def register():
    license_client.setup(
        on_activate   = lambda: your_feature_module.register(),
        on_deactivate = lambda: your_feature_module.unregister(),
    )

def unregister():
    license_client.teardown()
    try:
        your_feature_module.unregister()
    except Exception:
        pass

よくある質問

Q. オフライン環境でも使えますか？

A. 一度認証するとローカルにキャッシュが保存され、CHECK_DAYS で設定した日数の間はオフラインでも動作します。

Q. APIキーを再生成したらユーザーはどうなりますか？

A. キャッシュ期間中は引き続き使えますが、次回サーバーへの確認時（CHECK_DAYS 後）にエラーになります。新しいAPIキーを設定したアドオンを再配布する必要があります。

Q. アドオンが複数ある場合は？

A. アドオンごとに license_client.py をダウンロードし、ADDON_ID・ADDON_NAME・ADDON_MODULE を変えて使用してください。APIキーとAPI_BASEは共通で構いません。

Blender® Addons License Manager

ドキュメント

ライセンス発行

ライセンス詳細

アドオンを追加

アドオンを編集

申請を承認

申請を却下

ライセンスを失効

再有効化の確認

ロールを変更

管理者を招待