メインコンテンツへスキップ
ソフトウェアやデジタル商品に対してユニークなキーを発行し、アクティベーションを管理し、必要に応じてアクセスを取り消します。ライセンスキーは、サブスクリプションや一回限りの購入と組み合わせて使用するのに適しています。

​
ライセンスキーとは？

ライセンスキーは、製品へのアクセスを認可するユニークなトークンです。以下の用途に最適です：
  • ソフトウェアライセンス: デスクトップアプリ、プラグイン、CLI
  • ユーザーごとの制御: ユーザーまたはデバイスごとのアクティベーションを制限
  • デジタル商品: ダウンロード、アップデート、またはプレミアム機能へのゲート

​
主な利点

  • アクセス制御: 有効期限とアクティベーションの制限を定義
  • 運用の可視性: 使用状況、デバイス、履歴を追跡
  • セキュリティとサポート: 迅速に無効化、再有効化、監査

​
ライセンスキーの作成

1

ライセンスキーを作成する

Dodo Paymentsのダッシュボードに移動し、ライセンスキーセクションを開きます。新しいライセンスキーを作成するオプションを選択します。
2

ライセンスキー設定の構成

ライセンスキーが発行され、使用される方法を指定するこれらのフィールドを設定します：
  • ライセンスキーの有効期限: キーが有効な期間を定義します。特定の期間（例：30日または1年）を選択するか、「無期限」を選択して永続的なキーにします。
  • アクティベーション制限: キーごとの同時アクティベーションの最大数を設定します。シングルユーザー（1）やチームライセンス（5）などのシナリオには特定の数を使用するか、「無制限」を選択してアクティベーションの上限を設けません。
  • アクティベーション手順: お客様のために明確なアクティベーション手順を提供します。これらはライセンスキーとともにメールで送信されます。例：「設定 → ライセンスにキーを貼り付ける」または「実行: mycli activate <key>」。
3

確認と保存

入力したすべての詳細を確認します。準備ができたら、ライセンスキーの設定を保存してキーの作成を完了します。
現実的な手順を使用し、アクティベーションチケットを減らすためにサポートリンクを含めてください。
Dodo Paymentsダッシュボードでのライセンスキーの作成

​
管理と監視

ライセンスキーセクションは、すべてのライセンスキーのアクティビティを包括的に表示し、ライセンスを効果的に管理および監視することを可能にします。

​
キー情報

各ライセンスキーの詳細情報を表示します：
  • キーの詳細: ライセンスキーの値、関連する製品名、顧客の詳細（customer_id）、購入日
  • 使用状況: アクティベーションの数、アクティベーションの日付と時刻、ステータス（アクティブ、期限切れ、無効）
  • 有効期限と制限: キーの有効期限、残りのアクティベーション数、現在のアクティベーションインスタンス
ライセンスキーの詳細

​
利用可能なアクション

ライセンスキーに対して以下のアクションを実行できます：
  • ライセンスキーを無効化: さらなる使用を防ぐためにキーを即座に無効化します
  • キーを有効化: 以前に無効化されたライセンスキーを再有効化します
  • アクティベーションインスタンスを表示: 特定のライセンスキーに関連するすべてのアクティベーションインスタンスを確認します
ライセンスキーのアクション

​
利点

  • ライセンスキーのアクティビティをリアルタイムで追跡
  • 潜在的な不正使用や無許可のアクティベーションを特定
  • 不一致が発生した場合に詳細な使用記録を提供することで顧客サポートを簡素化

​
API管理

これらのAPIを使用して、ライセンスキーとそのアクティベーションインスタンスをアクティブ化、検証、リスト、更新します。
公開エンドポイント: アクティベート、デアクティベート、検証ライセンスのエンドポイントは公開されており、APIキーは必要ありません。これにより、API資格情報を公開することなく、クライアントアプリケーション、デスクトップソフトウェア、CLIから直接呼び出すことができます。
ライセンスキーに対してアクティベーション、デアクティベーション、検証アクションをトリガーします。

ライセンスをアクティブ化

ライセンスキーのアクティベーションインスタンスを作成または記録します。

ライセンスをデアクティブ化

以前のアクティベーションを取り消して容量を解放します。

ライセンスを検証

アクセスを許可する前に、真偽、ステータス、および制約を確認します。
ライセンスキーとその設定、ステータスをリスト、取得、更新します。

ライセンスキーをリスト

ステータスと使用状況の詳細を含むすべてのキーを閲覧します。

ライセンスキーを取得

特定のキーとそのメタデータを取得します。

ライセンスキーを更新

有効期限、アクティベーション制限、またはキーの有効/無効を変更します。
各キーの個別デバイスアクティベーションを操作します。

インスタンスをリスト

特定のキーのすべてのアクティベーションインスタンスを返します。

インスタンスを取得

単一のアクティベーションインスタンスの詳細を取得します。

インスタンスを更新

インスタンスのデバイス情報を取り消すか、更新します。

​
統合例

​
ライセンスをアクティブ化

これらのエンドポイントはAPIキーを必要とせず、クライアントアプリケーションから直接呼び出すことができます。
import DodoPayments from 'dodopayments';

// No API key needed for public license endpoints
const client = new DodoPayments();

const response = await client.licenses.activate({ 
  license_key: 'license_key', 
  name: 'Device Name' 
});

console.log(response.id);

​
ライセンスを検証

import DodoPayments from 'dodopayments';

// No API key needed for public license endpoints
const client = new DodoPayments();

const response = await client.licenses.validate({ 
  license_key: '2b1f8e2d-c41e-4e8f-b2d3-d9fd61c38f43' 
});

console.log(response.valid);

​
ベストプラクティス

  • 制限を明確に保つ: 有効期限とアクティベーションのために合理的なデフォルトを選択
  • ユーザーをガイドする: 正確なアクティベーション手順と自己サービスのドキュメントを提供
  • チェックを自動化する: アクセスを許可する前にサーバー側でキーを検証
  • イベントを監視する: ウェブフックを使用して不正使用を検出し、取り消しを自動化