API セットアップガイド

ライセンス管理サブドメインを使用すると、ライセンスの管理が容易になり、新しいライセンスファイルのアップロード、現在アクティブなライセンスに関する情報の取得、既存ライセンスの削除を行えます。

有効なライセンスを取得するには、お問い合わせください。

ライセンス管理 API のセットアップ​

1. アクティブなライセンスのアップロード​

この API には Glasswall Halo のエントリポイントを通じてアクセスできます。このエントリポイントは、ポータルと同じ ip address/url を共有します。

ライセンスファイルを送信するには、/API/v1/license エンドポイントに post request を送信します。.lic 形式のライセンスファイルを含む json request body を含めてください。

-----BEGIN LICENSE FILE-----\n  eyJlbmMiOiJleUprWVhSaElqcDdJbWxrSWpvaU1EYzFZV05sT1RFdFlUaGtP\n  UzAwTVdObUxXRmtNMk10TTJJd01EWXpOakF5WTJRMUlpd2lkSGx3WlNJNklt\n...\nYithdmN6WmVTMitrZGxrKzNwZ0RGTXhueHVpWkNYQUI3RlRrYnB5MkRRPT0i\nLCJhbGciOiJiYXNlNjQrZWQyNTUxOSJ9\n-----END LICENSE FILE-----\n

ライセンスが有効で有効期限内である場合、API はライセンスの詳細を含む JSON body を返し、ライセンスファイル構造の概要を提供します。ライセンスの詳細についての詳細情報はこちらをご覧ください。

注: 任意の時点で許可されるアクティブなライセンスは 1 つのみであることにご注意ください。

license API からの応答が失敗した場合、通常はライセンスが無効または期限切れであることを示します。応答本文には、ライセンスが検証チェックを通過できなかった理由を示すエラーメッセージが含まれます。この状況が発生した場合は、弊社までご連絡ください。プロセスを正常に再試行できるよう、有効なライセンスファイルの取得を弊社チームがサポートします。

2. 正しいライセンスがインストールされていることの確認​

有効なライセンスをアップロードすると、応答にはライセンスの詳細が含まれます。これらのライセンス詳細を再度取得するには、ステップ 1 で説明したものと同じエントリポイントを使用して、/API/v1/license に get リクエストを送信してください。ライセンス詳細の詳細については、こちらをご覧ください。

ライセンスが正しいことを確認するため、ライセンスの詳細を確認してください。具体的には、daysleft、startdate、および entitlements が、購入したライセンスに対する想定内容と一致していることを確認してください。提供されたライセンスが無効である、または不正確な内容を含んでいる疑いがある場合は、弊社までお問い合わせください。

詳細については、弊社のAPI ドキュメントも参照してください。

有効なライセンスの更新​

ライセンスを更新するには、新しいライセンスをインストールする際に前述したのと同じ手順に従ってください。新しいライセンスをアップロードすると、以前のライセンスは自動的に置き換えられ、新しいライセンスが有効になります。

新しいライセンスが反映されるまで 60 秒お待ちください。

有効なライセンスの削除​

現在有効なライセンスを削除するには、前の手順と同じエントリポイントを使用して、/API/v1/license に delete リクエストを送信してください。この操作によりライセンスは削除され、元に戻すことはできません。