管理 REST 代理节点

本主题包含的信息可帮助您了解如何使用 REST 代理、向 REST 代理添加注册以及查看和编辑 REST 代理节点。

如何使用 REST 代理？

REST 代理将应用身份映射到区块链成员，这样用户和应用就可以调用 Oracle Blockchain Platform REST API。

Oracle Blockchain Platform 可以使用 REST 代理与 Hyperledger Fabric 网络进行交互，而不必使用原生的 Hyperledger Fabric API。使用本机超级账本架构 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 Proxy Node Attributes 。

1. 转到控制台并选择节点选项卡。
2. 在节点选项卡中，转到“节点”表，找到所需的配置信息的 REST 代理节点，然后单击节点的更多操作按钮。
3. 配置选项由您的权限确定。如果您是管理员，请找到并单击编辑配置。如果您是用户，请找到并单击查看。
   此时将显示配置对话框。
4. 如果您是管理员，请根据需要修改节点的建议等待时间（毫秒）、事务处理等待时间（毫秒）、日志级别和事务处理事件日志记录属性。
5. 单击提交以保存配置更改，或单击 X 以关闭配置对话框。