イベント通知

ライセンスがアクティブ化、更新、または取り消されると、Licentivo は注文、顧客、サポート システムを同期するようにサーバーに通知できます。

有効期限の管理と更新通知には、期限間近、期限切れ、有効期間延長のイベントを購読します。販売者のサイトで状態を確認し、必要に応じて顧客へメールを送信できます。Webhook は状態変更を通知するもので、販売者に代わって顧客へ自動でリマインダーを送る機能ではありません。

通知エンドポイントを追加する

ライセンス イベント通知を開き、サーバーの HTTPS URL を追加し、イベントを選択します。保存すると、署名シークレットが 1 回表示されます。受信サーバーに保存します。運用環境では、ローカルまたはプライベート ネットワークの宛先は許可されません。

受け取り後に署名を確認する

X-Licentivo-Timestamp、X-Licentivo-Event、生のリクエスト本文を読み取ります。timestamp + '.' + event ID + '.' + body を連結し、署名シークレットで HMAC-SHA256 を計算します。先頭に sha256= を付け、X-Licentivo-Signature と定時間比較してください。現在時刻から 5 分を超えてずれたタイムスタンプは拒否します。

イベント ID によって重複を排除します。署名を検証し、イベントをトランザクションまたはキューに配置し、耐久ストレージの後に 2xx を返します。重複の場合は、注文アクションを繰り返さずに 2xx を返します。

失敗すると何が起こるのでしょうか？

配信は最大 8 回まで自動的に試行され、遅延が増加します。コンソールには HTTP ステータス、試行時間、エラーが表示され、手動再配信が許可されます。イベントとライセンス操作はデータベース トランザクションを共有します。再起動後に配信が再開されます。

イベントには作成、更新、有効期間延長、失効、認証、端末解除、機能利用、期限間近、期限切れ、保守期間変更などがあります。通知に含まれるのはライセンスキーの接頭辞だけで、完全なキーは含まれません。