管理 REST 代理主機節點

本主題包含的資訊可協助您瞭解如何使用 REST 代理主機、將註冊新增至 REST 代理主機，以及檢視和編輯 REST 代理主機節點。

如何使用 REST 代理主機？

REST 代理主機會將應用程式識別對應至區塊鏈成員，讓使用者和應用程式能夠呼叫 Oracle Blockchain Platform REST API。

Oracle Blockchain Platform 不使用原生 Hyperledger Fabric API，而是改用 REST 代理主機與 Hyperledger Fabric 網路互動。當您使用原生 Hyperledger Fabric API 時，可以直接連線至對等和排序器。不過，REST 代理主機可讓您透過 RESTful 通訊協定查詢或呼叫 Fabric 鏈碼。

新增註冊至 REST 代理主機

註冊可讓使用者在沒有註冊憑證的情況下呼叫 REST 代理主機。註冊需要在您的認證伺服器上定義新的使用者群組。

使用 Microsoft Active Directory 作為認證伺服器時新增註冊

若要將註冊新增至 REST 代理主機，必須將新的使用者群組新增至 Active Directory：<Rest Proxy Client Users group name>_<custom enrolment name>。接著，您可以使用區塊鏈平台主控台將註冊對應至此群組。

  1. 建立名為 <Rest Proxy Client Users group name>_<custom enrolment name> 的新 Active Directory 群組。
  2. 新增任何需要使用此群組自訂註冊的使用者。
  3. 前往區塊鏈平台主控台並選取節點頁籤。
  4. 在節點頁籤中，尋找您要新增註冊的 REST 代理主機節點，然後開啟其他動作功能表。
  5. 按一下檢視或建立登記，以查看節點的目前登記清單。
  6. 按一下建立新註冊。
  7. 在使用者名稱欄位中，從第一個步驟輸入 <custom enrolment name>。請注意，這區分大小寫，而且必須與您建立的使用者群組相符。按一下註冊。
    • 系統會建立註冊，並顯示在「註冊」表中。
    • 新的註冊會複製到網路中的每個 REST 代理主機節點。

使用 OpenLDAP 或 Oracle Internet Directory 作為您的認證伺服器時新增註冊

新增註冊至 REST 代理主機會在您 LDAP 伺服器的 OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> 群組中建立新的使用者角色。

在主控台中建立註冊之後，管理員會使用 LDAP 伺服器將必要的使用者指定給此角色。

如需有關使用者如何存取 REST 資源的資訊，請參閱 Oracle Blockchain Platform 的 REST API 。

  1. 前往主控台並選取節點頁籤。
  2. 在節點頁籤中，尋找您要新增註冊的 REST 代理主機節點，並開啟其他動作功能表。
  3. 按一下檢視或建立登記，以查看節點的目前登記清單。
  4. 按一下「建立新註冊」。
    隨即顯示建立新註冊對話方塊。
  5. 在「使用者名稱」欄位中，輸入註冊的名稱。按一下加入 (Enroll) 。
    按一下註冊之後：
    • 系統會建立註冊，並顯示在「註冊」表中。
    • 新的註冊會複製到網路中的每個 REST 代理主機節點。
    • LDAP 伺服器上 OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> 群組的新使用者角色。

檢視及編輯 REST 代理主機節點組態

REST 代理主機節點的組態決定節點在網路上的執行和行為方式。

只有管理員可以變更節點的組態。如果您有使用者權限，就可以檢視節點的組態設定值。請參閱 REST 代理主機節點屬性。
  1. 前往主控台並選取節點頁籤。
  2. 在節點頁籤中，移至「節點」表格，找出您要設定組態資訊的 REST 代理主機節點，然後按一下節點的其他動作按鈕。
  3. 組態選項是由您的權限所決定。如果您是管理員，請找出並按一下編輯組態。如果您是使用者，請找出並按一下檢視。
    隨即顯示設定對話方塊。
  4. 如果您是管理員，請視需要修改節點的提案等待時間 (毫秒) 、交易等待時間 (毫秒) 、日誌層級及交易事件記錄屬性。
  5. 按一下送出以儲存組態變更，或按一下 X 以關閉設定對話方塊。