管理 REST 代理主機節點

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

如何使用 REST 代理主機？

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

Oracle Blockchain Platform 可以使用 REST 代理主機與 Hyperledger Fabric 網路互動，而不使用原生的 Hyperledger Fabric API。當您使用原生 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 資源的相關資訊，請參閱 REST API for Oracle Blockchain Platform 。

1. 移至主控台並選取節點頁籤。
2. 在節點頁籤中，尋找您要新增註冊的 REST 代理主機節點，然後開啟其他動作功能表。
3. 按一下檢視或建立註冊即可查看節點的目前註冊清單。
4. 按一下建立新註冊。
   將會顯示建立新註冊對話方塊。
5. 在「使用者名稱」欄位中，輸入登記名稱。按一下註冊。
   按一下註冊之後：

   • 註冊即會建立並顯示在「註冊」表中。
   • 新登記會複製到網路中的每個 REST 代理節點。
   • LDAP 伺服器上 OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> 群組中的新使用者角色。

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

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

只有管理員可以變更節點的組態。如果您有使用者權限，就可以檢視節點的組態設定值。請參閱 REST 代理主機節點屬性。

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