離線授權啟用與檔案交換
目標電腦完全不能聯網時,用申請檔案和簽章回應完成首次啟用。申請檔案可以通過 U 盤帶到另一臺聯網電腦。
操作步驟
- 在目標電腦載入 SDK 設定,呼叫 OfflineRequest("activate"),儲存申請檔案。生成申請不需要訪問伺服器。
- 在聯網電腦打開控制臺的“離線檔案啟用”,上傳申請并下載回應。終端客戶也可以在自己的客戶門戶中辦理。
- 把回應帶回目標電腦,呼叫 ImportOffline,傳入原申請和回應。SDK 檢查簽章、申請編號、版本以及本機身份,通過后儲存快取。
- 用 CheckFeature 檢查授權。離線電腦無需啟動線上心跳;允許離線多久,由授權策略決定。
檔案啟用只支援允許離線的綁定裝置授權。申請有效期 30 天。限時授權從伺服器批準申請時開始計時,因為伺服器無法知道回應檔案什么時候被匯入。
如何離線解除綁定?
在原電腦生成 OfflineRequest("deactivate")。SDK 會先刪除本機快取,再把申請交給廠商或客戶門戶辦理釋放。刪除原電腦快取不能證明沒有其他歷史副本;需要立即阻止舊授權時,應使用需要定期聯網的策略。
各語言的名字
| 語言 | 生成申請 | 匯入回應 |
|---|---|---|
| Go | OfflineRequest("activate") → []byte | ImportOffline(requestBytes, responseBytes) |
| Java | offlineRequest("activate") → JSON 文字 | importOffline(requestText, responseText) |
| JavaScript | offlineRequest("activate") → object | importOffline(requestObject, responseObject) |
| C | ln_offline_request(client, "activate") | ln_import_offline(client, requestText, responseText) |
| C++ / C# | OfflineRequest("activate") → JSON 文字 | ImportOffline(C++ 傳文字,C# 傳位元組) |
| Python | offline_request("activate") → dict | import_offline(requestDict, responseDict) |
C 返回的文字由呼叫方使用 ln_free_string 釋放。回應檔案傳入的是檔案本身的內容,不是網頁 API 外層的 data 包裝。