クライアント SDK
実際の業務処理を SDK のコールバックに渡します。通常機能には RunFeature、利用回数制限付き機能には RunMeteredFeature を使います。通信、署名検証、キャッシュ、ハートビートは SDK が処理します。
Go SDK · Java · C · C++ · C# / .NET · Python · JavaScript · Rust · Ruby
初期化パラメーターの取得先
製品 ID はコンソールの「製品」一覧で確認します。信頼する公開鍵は、同じ製品の「署名公開鍵」から取得し、キー ID をキー、公開鍵を値とする対応表にします。これらを初期化コードの製品 ID と trustedKeys に設定してください。licenseKey には、アプリの認証画面で顧客が入力したライセンスキーを渡します。
SDK には公式サーバーの URL が標準設定されています。通常の組み込みで設定ファイルやソフトウェアのバージョン登録は不要です。独自サーバー、プロキシ、バージョン制限などの高度な設定は、SDK の設定オブジェクトへ直接指定できます。
SDK をインストールする
アプリケーション プロジェクトに固定バージョンをインストールします。上で言語を選択すると、そのプラットフォームのインストール手順が表示されます。パブリック SDK のインストールには、ベンダー管理 API キーは必要ありません。
バージョン:
インストールされているSDKの参照方法
| 言語 | プロジェクトの統合 |
|---|---|
| Go | import licentivo "github.com/spf86/licentivo-sdk" |
| Java | import licentivo.Client; |
| C / C++ | find_package(Licentivo 0.11 REQUIRED) · target_link_libraries(MyApp PRIVATE Licentivo::C) / Licentivo::CPP |
| C# | using Licentivo; |
| Python | from licentivo import Client |
| Node.js | import {Client} from '@licentivo/sdk' |
| Rust | use licentivo::Client; |
| Ruby | require 'licentivo' |
保護する業務処理は SDK を通して実行し、アプリの終了時にクライアントを閉じます。
Loading code…管理サンプルを実行するにはどうすればよいですか?
最初にこれらのサーバー環境変数を設定します LICENTIVO_URL と LICENTIVO_API_KEY、ライセンス サーバー URL とフル管理キーを設定します。この例では、製品リストを読み取り、HTTP ステータスと応答を出力します。
HTTP 200 と次の応答が返れば成功です： data.items。401 の場合は、キーが完全か、有効期限内か、失効していないかを確認します。キーの作成と権限についてはこちら： 管理 API キー。
AI ワークフローに従って独自のソフトウェアのライセンスを取得する →
認可状況の表示方法
Status と FeatureStatus は、リクエストやバックグラウンド検証を待たずにローカルで読み取られます。ステータス通知を使用して UI を更新します。
| ステータス | 意味 |
|---|---|
active | 最後のオンライン検証は成功しました。ローカル認証は有効です。 |
offline_valid | ローカル署名は有効です。起動以来オンライン確認が成功していません。 |
verification_required | 使用可能な署名がありません。オンラインでアクティブ化または更新します。 |
| expired / revoked / released | サーバーが明示的に認可を拒否しました。保護された操作を停止します。 |
quota_exhausted | この従量制リクエストは許容量を超えました。他の利用権のある機能は引き続き利用できます。 |
allowed はローカルの利用権限が有効かを示します。利用回数制限付き機能では、別途回数の確保が必要です。lease_valid_until は署名付きキャッシュの期限であり、ライセンス自体の最終有効期限ではありません。code はエラー識別子、request_id はログ照合用 ID、retryable は再試行可否を表します。
各言語のメソッド、通知コールバック、パッケージの使用法については、ダウンロード内の sdk/README.md を参照してください。上記の手順では、パッケージ マネージャーのインストールを言語ごとにリストしています。この Web サイトでは、バージョン管理されたパッケージ、共通のインストーラー、オフライン インストールも提供します。
これはアプリケーションのどこに属しますか?
| アプリの実行段階 | 何をすべきか |
|---|---|
| 起動時またはキー入力後 | OpenWithLicense を呼び出します。C++ ではコンストラクターで作成して Start を呼び出します。SDK がポリシーに従って認証を行い、ハートビートを開始します。 |
| 有料機能の前 | RunFeature に実際の処理をコールバックとして渡します。利用回数制限付き機能には RunMeteredFeature を使います。 |
| アプリケーションの実行中 | client を存続させ、SDK はポリシー内の間隔でハートビートを送信します |
| アプリケーション終了時 | Close / Dispose / Destroy はハートビートを停止し、同時接続枠を返し、デバイスにバインドされた登録を保持します。 |
| ユーザーがバインドを解除するとき | Deactivate を呼び出し、client を閉じます。 |
表内のメソッド名は操作を識別します。あなたの言語の例では正確な名前を使用してください。ハートビート、オフライン キャッシュ、オンライン更新については、次を参照してください。 ハートビートとオフライン アクセス。