管理 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 通訊協定查詢或呼叫 Hyperledger Fabric 鏈碼。

新增註冊至 REST 代理主機

您可以將 Hyperledger Fabric 註冊新增至 REST 代理主機。註冊可讓使用者在沒有註冊憑證的情況下呼叫 REST 代理主機。

如果您要將使用者新增至登記，他們必須已存在於 IDCS 中，並且已指派給 REST_USER 角色。

使用區塊鏈平台主控台新增註冊，並將 IDCS 使用者與這些註冊建立關聯。註冊完全由區塊鏈平台管理，而不是由 IDCS 內部管理。

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

1. 前往主控台並選取節點頁籤。
2. 在節點頁籤中，尋找您要新增註冊的 REST 代理主機節點，然後按一下此節點的動作功能表。
3. 按一下檢視或管理註冊，以查看節點的目前註冊清單。
   隨即顯示目前註冊的清單。您可以刪除現有的登記，以及從此頁面新增登記。
4. 展開建立新登記。
5. 在登記 ID 欄位中，輸入要新增的登記名稱。
   註冊 ID 只能包含英數字元、連字號 (-) 和底線 (_)。
6. 或者，在使用者 ID 欄位中，輸入要與註冊建立關聯之 REST_USER 角色的使用者 ID。按一下加入 (Enroll) 。
   按一下註冊之後：

   • 系統會建立註冊，並顯示在「註冊」表中。
   • 新的註冊會複製到網路中的每個 REST 代理主機節點。
   • 如果您指定了使用者 ID，該 ID 會與註冊相關聯，且無法從相關聯的 REST 使用者清單中移除。如果使用者 ID 不是有效的 REST 使用者，則會傳回錯誤。
   • 如果您指定了使用者 ID，產生的註冊憑證會包含 ID 作為 username 屬性。
   • 使用基本認證的 REST API 呼叫不支援包含冒號 (：) 的使用者 ID。您可以使用基本認證來進行測試和內部開發。請勿在生產環境中使用基本認證。
7. 在關聯的 REST 從屬端使用者窗格中，您可以檢視和管理與目前註冊關聯的所有使用者，包括從註冊刪除使用者。
8. 展開關聯新使用者，新增其他使用者至登記。輸入已指派 REST_USER 角色之使用者的電子郵件或 ID。按一下關聯。

在您建立註冊並將使用者與該註冊建立關聯後，當您使用 REST 在區塊鏈上執行交易時，列在區塊詳細資訊中的發起者將被列為新的註冊，而不是原始的預設使用者。

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

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

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

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