手動での組み込み手順
まず 1 つの実際の操作を承認し、次にポリシーに必要な機能を追加します。このガイドでは、プラットフォームのセットアップとアプリのコードを結び付けます。
準備するもの
作業中のプロジェクト、製品 ID、その製品のすべての署名公開鍵、テスト ライセンス、保護する機能 ID を準備します。機能 ID は大文字と小文字が区別され、発行されたライセンスと一致する必要があります。
デスクトップ アプリ、プラグイン、および CLI は、SDK をローカルで使用します。 Web アプリケーションは、信頼されたバックエンドでライセンスと保護された操作を強制します。ブラウザはステータスを表示できますが、実行を許可することはできません。
アプリのライフサイクルに組み込む
- 固定バージョンをインストールする
「クライアント SDK」で言語を選び、対応するインストールコマンドを実行します。製品 ID と、すべてのキー ID・公開鍵の対応表を初期化設定へコピーしてください。明示的に設定した製品公開鍵だけを信頼します。公開鍵はアプリに同梱できますが、管理 API キーは同梱してはいけません。
- 顧客にキーを貼り付けてもらいます
アクティベーション画面またはインタラクティブな CLI を提供します。最初のテストでは、プラットフォームのクイックスタートからキーをコピーし、統合アプリに貼り付けます。実稼働環境の顧客は、提供されたライセンスキーを使用してアプリ内でアクティベートします。ソース、インストーラー、またはログにテスト キーを埋め込まないでください。
- ライセンスの開始と復元
選択した言語でサンプルを起動して、長期有効な client を作成します。初めて顧客認証コードを渡します。同じユーザーが後で開始する場合は空白のままにすることができ、SDK がプライベート デバイスの認証情報を復元できるようになります。起動失敗を処理し、再試行エントリを提供します。インターフェースのスレッドをブロックしないでください。
- 実際の動作を保護する
通常の機能には RunFeature 相当のラッパーを使い、利用回数制限のある機能には RunMeteredFeature を使います。実際の処理をコールバックへ渡し、権限チェックに失敗したら実行しないようにします。ボタン、ショートカット、コマンド、バックグラウンドタスク、サーバールートは、すべて同じ権限チェックを通してください。
- ステータスを表示し、変更を処理する
client と SDK を維持し、ポリシーに従ってハートビートを送信します。インターフェイスはステータスの変更をサブスクライブし、更新許可エントリを提供できます。一時的なネットワーク障害の場合、オフライン認証がまだ有効であるかどうかを判断するために使用できるのは SDK のみです。明示的な拒否を受け取った後、保護された操作は停止され、ユーザーの既存のデータは保持されます。
- 通常終了と端末の登録解除を区別する
通常終了時は client を閉じてバックグラウンド処理を停止し、同時接続枠の返却を試みます。端末の登録は保持されます。顧客が端末移行や登録解除を明示的に選んだ場合だけ Deactivate を呼び出し、その後 client を閉じてください。終了するたびに登録解除してはいけません。
これらの名前は操作を説明します。各言語の正確なスペル、非同期動作、戻り値の型については、SDK リファレンスを使用してください。起動例と操作のスニペットをコピーする前に、言語を選択してください。
インストールと完全な例 · 9 言語すべてのメソッドとパラメータ
ポリシーが使用する機能を追加します
| シナリオ | 何を実装または検証するか |
|---|---|
| デバイスのバインドと転送 | SDK マシン ID とプライベート キャッシュを使用します。コピーされたキャッシュが別のマシンを許可していないことを確認します。 |
| 同時接続枠 | プロセスを起動するたびに、オンラインで同時接続枠を取得します。正常終了時の返却、上限到達、リース期限切れ、異常終了後の枠の回収をテストしてください。 |
| ハートビートとネットワーク損失 | ハートビート間隔とオフライン許容量は別です。ハートビートを無効にしても、永続的なアクセスが許可されるわけではありません。キャッシュの有効期限は最終的なライセンスの有効期限ではありません。 |
| 完全オフラインアクティベーション | ターゲット マシン上でリクエストを生成し、そのレスポンスをオンラインで取得して、そのマシンにインポートし直します。ポリシーではこのオフライン モードを許可する必要があります。 |
| 機能の利用回数制限 | 実際のジョブごとに安定した一意の ID を使用し、再試行のためにそれを保持します。予約、確認、キャンセル、およびクラッシュ後の実際のビジネス結果を処理します。 |
| バージョン制限とアップグレード | 制限が適用される場合は、実際の AppVersion を指定します。メンテナンス ルールでは、そのバージョンを最初に公開する必要があります。アプリのアップグレード後にオンラインで認証を更新します。 |
| 顧客による操作と端末解除 | 顧客の電子メールを関連付け、ポータル リンクを提供し、必要に応じて一時転送コードを受け入れ、通常の終了と明示的なデバイスの解放を区別します。 |
| 注文と管理の自動化 | 管理 API キーはサーバー上でのみ使用してください。ライセンスの発行、更新、および Webhook の処理は、クライアントの認証チェックとは別のものです。 |
リリース用のキーとキャッシュを準備する
信頼する製品公開鍵をすべてアプリの設定に固定し、更新時に新しい公開鍵一覧を確認します。認証応答に含まれるという理由だけで未知の公開鍵を受け入れてはいけません。端末認証情報とキャッシュは現在のユーザー専用ディレクトリに保存し、配布物に同梱したりユーザー間で共有したりしないでください。本番版ではテスト用ライセンスキーと開発用の認証回避処理を除去します。