管理 REST 代理节点

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

如何使用 REST 代理？

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

Oracle Blockchain Platform 可使用 REST 代理与超级账本架构网络交互，而无需使用原生超级账本架构 API。使用本机 Hyperledger Fabric API 时，您可以直接连接到对等节点和排序节点。但是，通过 REST 代理，您可以通过 RESTful 协议查询或调用超级账本架构链代码。

将注册添加到 REST 代理

您可以将超级账本架构 (Hyperledger Fabric) 注册添加到 REST 代理。注册允许用户在没有注册证书的情况下调用 REST 代理。

如果要将用户添加到注册，则这些用户必须已存在于 IDCS 中，并分配给 REST_USER 角色。

使用区块链平台控制台添加新注册，并将 IDCS 用户与这些注册关联。注册完全在区块链平台内管理，而不是在 IDCS 内管理。

有关用户如何访问 REST 资源的信息，请参阅 REST API for Oracle Blockchain Platform 。

1. 转到控制台并选择节点选项卡。
2. 在节点选项卡中，找到要向其添加注册的 REST 代理节点，然后单击此节点的操作菜单。
3. 单击查看或管理登记以查看节点的当前登记列表。
   此时将显示当前登记的列表。您可以删除现有登记以及从此页面添加新登记。
4. 展开创建新登记。
5. 在注册 ID 字段中，输入要添加的注册的名称。
   注册 ID 只能包含字母数字字符、连字符 (-) 和下划线 (_)。
6. （可选）在用户 ID 字段中，输入要与注册关联的具有 REST_USER 角色的用户的 ID。单击注册。
   单击注册后：

   • 注册将创建并显示在“注册”表中。
   • 新注册将复制到网络中的每个 REST 代理节点。
   • 如果指定了用户 ID，则该 ID 与注册关联，并且无法从关联的 REST 用户列表中删除。如果用户 ID 不是有效的 REST 用户，则会返回错误。
   • 如果指定了用户 ID，则生成的注册证书将 ID 作为 username 属性。
   • 对于使用基本验证的 REST API 调用，不支持包含冒号 (：) 的用户 ID。您可以使用基本验证进行测试和内部开发。请勿在生产环境中使用基本验证。
7. In the Associated REST Client Users pane you can view and manage any users associated with a current enrollment, including deleting a user from an enrollment.
8. 通过展开关联新用户将另一个用户添加到注册。输入已分配了 REST_USER 角色的用户的电子邮件或 ID。单击关联。

创建注册并将其与用户关联后，当您使用 REST 在区块链上运行事务处理时，块详细信息中列出的启动器将作为新注册列出，而不是作为原始默认用户列出。

查看和编辑 REST 代理节点配置

REST 代理节点的配置决定了节点在网络上的执行和行为方式。

只有管理员才能更改节点的配置。如果您具有用户权限，则可以查看节点的配置设置。请参阅 REST 代理节点属性。

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