跳到正文

離線授權啟用與檔案交換

目標電腦完全不能聯網時,用申請檔案和簽章回應完成首次啟用。申請檔案可以通過 U 盤帶到另一臺聯網電腦。

操作步驟

  1. 在目標電腦載入 SDK 設定,呼叫 OfflineRequest("activate"),儲存申請檔案。生成申請不需要訪問伺服器。
  2. 在聯網電腦打開控制臺的“離線檔案啟用”,上傳申請并下載回應。終端客戶也可以在自己的客戶門戶中辦理。
  3. 把回應帶回目標電腦,呼叫 ImportOffline,傳入原申請和回應。SDK 檢查簽章、申請編號、版本以及本機身份,通過后儲存快取。
  4. 用 CheckFeature 檢查授權。離線電腦無需啟動線上心跳;允許離線多久,由授權策略決定。

檔案啟用只支援允許離線的綁定裝置授權。申請有效期 30 天。限時授權從伺服器批準申請時開始計時,因為伺服器無法知道回應檔案什么時候被匯入。

如何離線解除綁定?

在原電腦生成 OfflineRequest("deactivate")。SDK 會先刪除本機快取,再把申請交給廠商或客戶門戶辦理釋放。刪除原電腦快取不能證明沒有其他歷史副本;需要立即阻止舊授權時,應使用需要定期聯網的策略。

各語言的名字

語言生成申請匯入回應
GoOfflineRequest("activate") → []byteImportOffline(requestBytes, responseBytes)
JavaofflineRequest("activate") → JSON 文字importOffline(requestText, responseText)
JavaScriptofflineRequest("activate") → objectimportOffline(requestObject, responseObject)
Cln_offline_request(client, "activate")ln_import_offline(client, requestText, responseText)
C++ / C#OfflineRequest("activate") → JSON 文字ImportOffline(C++ 傳文字,C# 傳位元組)
Pythonoffline_request("activate") → dictimport_offline(requestDict, responseDict)

C 返回的文字由呼叫方使用 ln_free_string 釋放。回應檔案傳入的是檔案本身的內容,不是網頁 API 外層的 data 包裝。