Manage REST Proxy Nodes

How's the REST Proxy Used?

The REST proxy maps an application identity to a blockchain member, which allows users and applications to call the Oracle Blockchain Platform REST APIs.

Instead of using the native Hyperledger Fabric APIs, Oracle Blockchain Platform can use the REST proxy to interact with the Hyperledger Fabric network. When you use the native Hyperledger Fabric APIs, you connect to the peers and orderer directly. However, the REST proxy allows you to query or invoke a Fabric chaincode through the RESTful protocol.

Add Enrollments to the REST Proxy

Enrollments allow users to call the REST proxy without an enrollment certificate. Enrollements require a new user group to be defined on your authentication server.

Adding Enrollments When Using Microsoft Active Directory as Your Authentication Server

Adding an enrollment to the REST Proxy requires a new user group to be added to Active Directory: <Rest Proxy Client Users group name>_<custom enrolment name>. You can then use the Blockchain Platform console to map the enrollment to this group.

Create a new Active Directory group called <Rest Proxy Client Users group name>_<custom enrolment name>.
Add any users needing to use the custom enrollment to this group.
Go to the Blockchain Platform console and select the Nodes tab.
In the Nodes tab, find the REST proxy node you want to add an enrollment to and open the More Actions menu.
Click View or create enrollments to see a list of the node’s current enrollments.
Click Create New Enrollment.
In the User Name field, enter <custom enrolment name> from the first step. Note that this is case-sensitive and must match the user group you created. Click Enroll.
- The enrollment is created and displays in the Enrollments table.
- The new enrollment is copied to each REST proxy node in the network.

Adding Enrollments When Using OpenLDAP or Oracle Internet Directory as Your Authentication Server

Adding an enrollment to the REST Proxy creates a new user role in the OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> group on your LDAP server.

After the enrollment is created in the console, the Administrator uses the LDAP server to assign the required users to this role.

For information about how users access the REST resources, see REST API for Oracle Blockchain Platform.

Go to the console and select the Nodes tab.
In the Nodes tab, find the REST proxy node you want to add an enrollment to and open the More Actions menu.
Click View or create enrollments to see a list of the node’s current enrollments.
Click Create New Enrollment.
The Create New Enrollment dialog is displayed.
In the User Name field, enter a name for the enrollment. Click Enroll.
After you click Enroll:
- The enrollment is created and displays in the Enrollments table.
- The new enrollment is copied to each REST proxy node in the network.
- A new user role in the OBP_<platform-name>_<instance-name>_REST_<custom-enrollment> group on your LDAP server.

View and Edit the REST Proxy Node Configuration

A REST proxy node’s configuration determines how the node performs and behaves on the network.

Only administrators can change a node’s configuration. If you've got user permissions, then you can view a node’s configuration settings. See REST Proxy Node Attributes.

Go to the console and select the Nodes tab.
In the Nodes tab, go to the Nodes table, locate the REST proxy node that you want configuration information for, and click the node’s More Actions button.
The configuration option is determined by your permissions. If you're an administrator, locate and click Edit Configuration. If you're a user, locate and click View.
The Configure dialog is displayed.
If you're an administrator, then modify the node’s Proposal Wait Time (ms), Transaction Wait Time (ms), Log Level, and Transaction Event Logging attributes as needed.
Click Submit to save the configuration changes, or click X to close the Configure dialog.