ソースコード向けのソフトウェアライセンスキーシステムには、3 つの役割があります。購入者が製品を購入したことを証明すること、製品がどこにインストールされているかを記録すること、そして購入者が所有するエディションに合わせてコードの動作を調整できるようにすることです。読めるソースコードをコピー不可能にすることはできませんし、それを無理に実現しようとすると、たいていは海賊版の利用者よりも誠実な購入者のほうが損をします。多くの販売者にとって最もうまくいく方法はシンプルです。インストーラーで一度だけキーを入力してもらい、サーバー側でライセンス API に照らして検証し、インストール先のドメインに紐づけたら、あとは邪魔をしないことです。
このガイドでは、その仕組みと製品への組み込み方を説明します。これはWeb アプリや SaaS のソースコードを販売する方法に関する総合ガイドの一部です。AppTrovo では、販売のたびにライセンスキーが自動発行され、ドメイン認証とライセンス検証 API も用意されているため、ライセンスサーバーを自作する必要はありません。必要なのは、インストーラー内の小さなクライアント側チェックだけです。
API リファレンスだけが必要な場合は、ライセンス連携ガイドに直接進んでください。考え方、トレードオフ、テスト計画については、このまま読み進めてください。
ライセンスキーで実際に守れるものは何か
読めるソースコードを販売する場合、その気になればライセンスチェックはいつでも取り除けてしまいます。この事実を正直に受け止めることで、煩わしいだけの仕組みではなく、役に立つ仕組みを設計できます。
| ライセンスキーシステムにできること | ライセンスキーシステムにできないこと |
|---|---|
| インストール前に、購入者が有効な購入をしていることを確認する | 読めるコードからチェック処理を削除されるのを防ぐ |
| ライセンスがどのドメインで認証されているかを記録する | 購入者が ZIP ファイルを共有するのを防ぐ |
| 購入者がどのエディションを所有しているかをコードに伝える | 明確なライセンス契約の代わりになる |
| サポートとアップデートが有効かどうかを示す | あらゆるケースで支払いを保証する |
| サポートや紛争対応の際に、きれいな記録を残す | 購入者に信頼されていない製品の穴埋めをする |
ライセンスキーは鍵ではなく、住所が書かれた領収書だと考えてください。業務用ソフトウェアの購入者の大半は誠実で、特にアップデートやサポートがそれに左右される場合は、ライセンスをきちんと守りたいと考えています。キーは、誠実な道を簡単な道にするためのものです。
コードを難読化・エンコードすべきか
PHP スクリプトをエンコードや難読化で保護しようとする販売者もいます。しかしソースコードのマーケットプレイスでは、たいていそれは誤りです。
- 購入者はソースにお金を払っています。セルフホスト型アプリを選ぶ理由は、コードを読み、監査し、変更できることです。エンコードされたファイルはその価値を奪います。
- エンコーダーはホスティング要件を増やします。専用のローダーなどが必要になり、インストールの失敗や問い合わせの原因になります。
- 難読化はあなた自身からもバグを隠します。また、購入者によるセキュリティレビューも不可能になります。
- 海賊版はほとんど防げません。エンコードされた製品の海賊版も、結局は出回ります。
その労力は、お金を払う価値を生むものに注ぎましょう。アップデート、サポート、ドキュメント、そして商用エディションの機能です。これらは海賊版では決して手に入りません。
ドメイン認証の仕組み
ドメイン認証は、ライセンスキーを製品のインストール先に紐づける仕組みです。AppTrovo での流れは次のとおりです。
- 購入者が製品を購入し、一意のライセンスキー(UUID)を受け取ります。
- インストール時に、インストーラーがサーバーからキーとインストール先のドメインをライセンス検証 API に送信します。
- キーが有効で、認証枠に空きがあれば、そのドメインがライセンスに記録され、レスポンスでその旨が確認されます。
- 同じドメインでインストーラーを再実行しても、枠を追加で消費することはありません。
- 購入者が新しいサーバーやドメインに移行する場合は、ダッシュボードから古いドメインの認証を解除し、新しいドメインを認証します。ドメイン認証の管理をご覧ください。
各ライセンスの認証枠の数には上限があり、検証レスポンスには使用済みの数(activations_used)と利用可能な数(activations_limit)が含まれます。この上限により、購入者はあなたに問い合わせることなく本番サイトとステージング環境を運用できる一方で、無関係な何十ものドメインへのインストールは抑止されます。ライセンスが法的に何を許可するかは、枠の数ではなくライセンス条項で定められています。
一度だけ検証するか、定期的に通信するか
コードがいつライセンスをチェックするかについては、一般的に 3 つの戦略があります。この選択は、ライセンス関連の他のどの判断よりも重要です。ライセンス処理が購入者の本番サイトを止めてしまうかどうかが、ここで決まるからです。
| 戦略 | 仕組み | 購入者へのリスク | 推奨 |
|---|---|---|---|
| インストール時に一度だけ検証 | インストーラーがキーをチェックし、その後アプリは通常どおり動作する | 非常に低い。ネットワーク障害の影響はインストーラーのみ | 推奨されるデフォルト |
| 定期的な再チェック | スケジュールされたジョブが毎日または毎週キーを検証する | 中程度。障害、ファイアウォール、レート制限によって誤った失敗が起こりうる | 強い理由がない限り避ける |
| リクエストごとにチェック | ページを読み込むたびにライセンスサーバーを呼び出す | 高い。すべてのページが遅くなり、あなたのサーバーが単一障害点になる | 使用しない |
AppTrovo の連携ガイドでは、一度だけの検証を推奨しています。インストーラーが成功したら、製品は「インストール済み」マーカーを書き込み、それ以降 API を呼び出すことはありません。ネットワーク障害の間にライセンスサーバーに到達できなかったという理由で、購入者の本番アプリが止まるようなことがあってはなりません。
インストーラーにライセンスチェックを追加する方法
検証 API は、/api/v1/licenses/verify への 1 回の GET リクエストで、license_key と、必要に応じて product_slug およびインストール先の domain を渡します。製品スラッグを送信することをおすすめします。これにより、そのキーが別の製品ではなく、あなたの製品のものであることが保証されます。インストーラーの流れを手順で示します。
- キーを入力してもらう。Web インストーラーに入力欄 1 つだけのライセンス手順を追加します。購入者に製品名を入力させたり設定ファイルを編集させたりする必要はありません。ZIP をパッケージ化する前に、製品スラッグを自分の設定ファイルに記述しておきます。
- サーバー側で検証する。短めのタイムアウトを設定し、SSL 検証を有効にしたうえで、バックエンドから API を呼び出します。ブラウザーの JavaScript から検証してはいけません。また、クライアント側のコードに秘密情報を含めてはいけません。
- ドメインを送信する。インストール先のホスト名を渡し、認証がそのホストに対して記録されるようにします。
- レスポンスを処理する。
validが true の場合は、必要な情報をローカルに保存します。license_typeから得られるエディション、ライセンシー名、そして管理画面で表示するならサポート期間の日付などです。false の場合は、failure_reasonをわかりやすい言葉で表示し、購入者が再試行できるようにします。 - インストール完了を記録する。インストール済みマーカーを書き込み、データベースと管理者ユーザーの手順に進みます。管理画面でインストール済みのバージョンと最新リリースを比較する場合は、PHP の version_compare() も後々役立ちます。ここから先、ライセンス関連のコードは一切実行されません。
Laravel 製品向けには、そのまま組み込めるインストーラー SDK が用意されています。既製のインストーラーコントローラーと、インストール済みマーカーの有無だけを確認する小さなミドルウェアが含まれています。パラメーターの一覧、レスポンスのフィールド、失敗理由の詳細は、ライセンス検証 API の記事と連携ガイドに記載されています。API にはレート制限があり(執筆時点では IP あたり毎分 120 リクエスト)、これもリクエストごとにチェックすべきでない理由の 1 つです。
検証結果を安全に保存する
ライセンスキーは他の認証情報と同じように扱ってください。公開ディレクトリ、ログ、フロントエンドには置かないことです。アプリケーションでのキーやトークンの扱いについての一般的な指針は、OWASP Secrets Management Cheat Sheet にまとめられています。
機能はドメインではなくエディションで制限する
AppTrovo の製品には、ちょうど 2 つのエディションがあります。無料で機能が限定された Community エディション(購入者は本番環境で利用できますが、作者のサポートはありません)と、すべての機能が利用できる有料の商用ライセンスです。3 つ目の区分はありません。購入者がどちらを持っているかは、検証レスポンスの license_type(community または commercial、さらに自分用のテストキーには developer)でわかります。
- 機能の制限には
license_typeを使ってください。エディションオブジェクトのスラッグは使いません。商用エディションの内部スラッグは「commercial」という表記ではない恒久的な識別子なので、制限の判定用に設計されたフィールドはlicense_typeです。 - インストール時にエディションを保存し、設定テーブルに格納して、実行時にはローカルから読み取ります。
- 各エディションに何が含まれるかを明確に決め、商品ページに明記してください。インストール後に初めて現れる隠れた制限は、騙されたように感じさせます。
レスポンスには product.retired も含まれます。製品の提供を終了した場合でも、既存のライセンスは引き続き検証に通り、管理画面では今後のアップデート予定がないことを控えめに通知できます。
開発環境、ステージング、サーバー移行への対応
実際のワークフローを無視したライセンス処理は、問い合わせを生みます。次のようなケースに備えておきましょう。
- ローカル開発。購入者はまず
localhostや.testドメインにインストールします。インストーラーがそれを認証としてカウントするかどうかを決めておきましょう。多くの販売者は、ローカルホストではドメイン送信を省略しています。 - ステージング環境。認証枠があるのは、ステージングサイトのために 2 つ目のライセンスを必要としないためです。このことをドキュメントに記載しておきましょう。
- サーバー移行。手順をドキュメント化します。ダッシュボードで古いドメインの認証を解除し、ファイルを移動し、新しいドメインでライセンス手順またはインストーラーを再実行します。
- クライアントのためにインストールする制作会社。どのドメインを認証すべきか、誰がキーを保有すべきかを説明します。クライアント向けの利用についてはライセンス条項を案内します。
申請前に連携をテストする
自分の製品の有料ライセンスは持っていないため、AppTrovo ではすべての作者が製品の編集ページから無料の開発者テストライセンスを生成できます。このライセンスは localhost、127.0.0.1、あるいは .test や .local で終わるホストなど、ローカルドメインでのみ認証でき、30 日で期限切れになりますが延長も可能です。まだ製品を持っていない新しい作者は、サンドボックスライセンスを使って流れを試せます。次のシナリオを実行してください。
| シナリオ | 発生させる方法 | 期待される結果 |
|---|---|---|
| 有効なキー、新しいドメイン | localhost に新規インストール | インストーラーが続行し、エディションを保存する |
| 有効なキー、同じドメインで再度 | 同じホストでインストーラーを再実行 | インストーラーが続行し、追加の認証枠は消費されない |
| 空き枠なし | 上限数までローカルドメインを認証し、さらにもう 1 つ認証する | ドメインの認証解除方法を説明するわかりやすいメッセージ |
| 無効なキー | ランダムな UUID を入力 | わかりやすいエラーが表示され、インストーラーはライセンス手順にとどまる |
| 期限切れのキー | 期限切れのテストキーを使用 | 「ライセンスの有効期限が切れています」というわかりやすいメッセージ |
| ネットワーク障害 | 自分のマシンで API ホストへの接続をブロック | 空白ページではなく、再試行ボタン付きのわかりやすいエラー |
パッケージ化する前に、テスト中に追加した開発用のバイパスフラグをすべて削除し、API のベース URL が本番環境を指していることを確認してください。
ライセンス手順は人間のために書く
ライセンス画面は、購入者がファイルをアップロードした後に最初に目にする画面であることが多いものです。いくつかの細かな配慮で、使いやすい画面になります。
- キーがどこで確認できるかを伝えます(AppTrovo の購入者であれば、ダッシュボードの「ライセンス」セクションです)。
- 前後に空白があってもキーを受け付け、トリムします。
- API の失敗理由を次に取るべき行動に言い換えます。たとえば「このキーには空いている認証枠がありません。ダッシュボードで使用しなくなったドメインの認証を解除してから、もう一度お試しください。」のようにします。
- ライセンスエラーのトラブルシューティングページへのリンクを置きます。そうした項目の書き方は、サポートへの問い合わせを減らすドキュメントのガイドで紹介しています。
よくある質問
コードを販売するには、独自のライセンスサーバーを構築する必要がありますか?
AppTrovo では不要です。販売のたびにライセンスキーが発行され、購入者はダッシュボードからドメイン認証を管理し、あなたはライセンス検証 API でキーを検証します。あなたの作業は、インストーラー内の小さなライセンス手順だけです。自社サイトでも販売する場合は、その販売分について別のライセンスの仕組みが必要になります。
ライセンスキーで PHP スクリプトの海賊版を防げますか?
読めるソースコードを編集されることを完全に防げるライセンスチェックはありません。ただし、購入の確認、インストール先の記録、購入者とアップデートやサポートの結びつけには役立ちます。海賊版の多くには、アップデート、サポート、商用版の機能を通じて、有料製品の価値を明確に高めることで対抗するほうが効果的です。
インストール中にライセンスサーバーがダウンしていたらどうなりますか?
一度だけ検証するパターンであれば、影響を受けるのはインストーラーだけです。再試行できるわかりやすいエラーを表示し、購入者の入力内容は保持しておきます。インストール後のアプリはライセンスサーバーに一切依存しないため、後で障害が起きても影響はありません。
購入者がライセンスを新しいドメインに移すにはどうすればよいですか?
ダッシュボードから古いドメインの認証を解除して認証枠を空け、新しいドメインでライセンス手順を実行します。購入者があなたに連絡しなくても済むよう、インストールガイドや移行ガイドにこの手順を記載しておきましょう。
Community エディションでもライセンスキーを必須にすべきですか?
Community ライセンスにもキーがあり、検証レスポンスでは community として返されます。両方のエディションで同じインストーラーの流れを使えばコードがシンプルになり、購入者が後から商用ライセンスを購入して新しいキーを入力した際に、商用版の機能を有効にできます。