管理 REST 代理节点

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

如何使用 REST 代理？

REST 代理将应用标识映射到区块链成员，这允许用户和应用调用 Oracle Blockchain Platform REST API。

Oracle Blockchain Platform 可使用 REST 代理与超级账本架构网络交互，而无需使用原生超级账本架构 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. 转到 Blockchain Platform 控制台，然后选择 Nodes 选项卡。
  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. 配置选项由您的权限决定。如果您是管理员，请找到并单击编辑配置。如果您是用户，请找到并单击查看。
    此时将显示 Configure 对话框。
  4. 如果您是管理员，请根据需要修改节点的建议等待时间（毫秒）、事务处理等待时间（毫秒）、日志级别和事务处理事件日志记录属性。
  5. 单击提交以保存配置更改，或单击 X 以关闭配置对话框。