How to add enrollments to REST proxy in Oracle Blockchain Cloud

Add Enrollments to the REST Proxy

You can add Hyperledger Fabric enrollments to the  REST proxy. Enrollments allow users to call the REST proxy without an  enrollment certificate.

Adding an enrollment to the REST Proxy creates a new user role in Oracle Identity Cloud Service. This role is: RESTPROXY#_USER_${enrollment_name}                      

After the enrollment is created in the console, the Administrator uses Oracle Identity Cloud Service to assign the required users to this role.                       

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

A new user role called RESTPROXY#_USER_${enrollment_name} is created in Oracle Identity Cloud Service and is now ready for the Administrator to assign users to it. See Add Hyperledger Fabric Enrollments to a REST Proxy in Administering Oracle Autonomous Blockchain Cloud Service.                                     

Add User to the enrollment

Assign a user to the  role called RESTPROXY#_USER_${enrollment_name}  - RESTPROXY#_USER_$producer

Giving permissions on Oracle Cloud

Today a customer asked me how to assign different privileges to the cloud service instances and I found interesting to have this documented. I have created a Digital Assistant instance and then given developer privileges to my user. Let's see this easy process.

New Instance Service

I have deployed a Digital Assintance instance called digiAgr. How do I give access to developers to this instance?

From Users menu, let's acces to the Identity Cloud Service console

Let's navigate to the applications.

Scroll down and find the Application that represents our new instance: BotsSaaSAuto_digiAgr. Click on it.

Click on Application Roles and then assign users

Select the user and click assign. Easy.

Deploy a Hyperledger Fabric blockchain network in Oracle Blockchain Cloud Service

I am not going to go through all the process of creating the
blockchain instances and I am going to focus on the process of
creating the HLF network, pariring the participant instance
with the founder organization network.

The process of creation OBC instances it is well explained in the
documentation.

https://docs.oracle.com/en/cloud/paas/blockchain-cloud/administer/create-oabcs-instance.html#GUID-C24F59D7-E81E-4527-93AD-E3DDCEA13704

There are two types of OABCS instances you can provision:

Founder organization: a complete blockchain environment,

including a new network to which participants can join later on.

Participant instance: if there is already a founder organization you

want to join, you can create a participant instance if your

credentials provide you with access to the network.

On creating the Founder you will need the “Create a new Network”
checked.

The network has been created with two instances: the "matrix" as a founder and the "producer" as a provider. Let's open the two instances consoles from the hamburger at the right hand side

Add OBCS Instance as a Network Participant

When you get into the "producer" instance it propose you to join to an already existing network.

Here are the screenshots. It is self explained through the UI. I will just annotate to which instance belongs the UI.

Step 1.1. Producer Instance

Step 1.2. "Producer" Instance. Export Certificate.

Step 1.3.1. Founder. Add Organization.

Step 1.3.2. Founder. Add "Producer" Instance Certification

Step 1.3.3. Founder. Add Organization successfully completed

Step 1.3.4. Founder. Organization added to the founder network.

Step 1.4.1. Founder. Export Order Settings.

Step 1.4.2."Producer" Instance. Import founder orderer settings.

Step 1.4.2."Producer" Instance.  Successfully imported founder orderer settings.

Step 1.5. "Producer" Instance is now a participant in the Parent blockchain network

Create a new channel

Step 2.1. Founder. Create a new channel.

Step 2.2. Founder Instance. Details on creating a new channel "logistica".

Step 2.2. Founder Instance. Channel "logistica" created with two founder peers participating in the channel.

Step 2.3. "producer" Instance is part of the channel "logistica" but still any peer has been added.

Step 2.4. Add "producer" Instance's  peers to the channel "logistica"

Step 2.5. Choose the "producer" Instance's  peers to add

Step 2.5. "producer" Instance's  peers already added

Simple App Orchestration flow with Oracle Integration Cloud

I want to demonstrate how easy is to create an App Orchestration flow with Oracle Integration Cloud Service. The flow will be very simple: every time a new temperature record is created into a database table, it will trigger a flow that will notify by email if the value of the temperature is over 30 degrees.

Oracle Cloud Trial

Log into the Oracle Cloud account and see the dashboard

Prepare the database

After having created a database cloud service go to the console and
take note of the public ip address and the connect string

Connect to the database through the SQL Developer

Create a table called CLAVEVALOR to store temperature data with and
status column ESTADO

Remote Agent Installation in DBCS VM

In order to capture database changes we need to install a remote agent
into the database VM.

Having already created "Autonomous" Integration Cloud Service (ICS)  
version 18.4.1.181017.0400-1756 , let's go to ICS console > Integrations

From here we will go to Agents menu for creating the agent group and
to download the agent needed to set up remote capture from the DBCS table
modifications

Create a database agent group.

https://docs.oracle.com/en/cloud/paas/integration-cloud/integrations-user
/creating-agent-group.html

Download and install the remote agent installer into the DBCS VM

https://docs.oracle.com/en/cloud/paas/integration-cloud/integrations-user
/downloading-and-running-premises-agent-installer.html
#GUID-3F36A9CE-BE4E-4A74-AE7E-C6005CC97A12

Copy the agent to the DBCS VM

Access to the DBCS VM through SSH connection and unzip
oic_connectivity_agent.zip

In the DBCS VM configure the InstallerProfile.cfg with the integration
cloud service information

Run the connectivity agent Agent Installer as a Background Process

https://docs.oracle.com/en/cloud/paas/integration-cloud/integrations-user/
downloading-and-running-premises-agent-installer.html
#GUID-57125700-B6D9-472F-B8BE-248C6A3DD5E4

After installation, agent appears linket to the  gent group

Create connections

Connections already created

Oracle Database Cloud Service connection with the connection properties,
security user and agent group to capture database changes

Create the integration

Create an App Driven Orchestration integration style

Notification configuration

Database changes configuration

Basic info and next

Polling information indicating table to take into account and the review
polling strategy

Polling strategy and frecuency

Testing the integration

Inserting a new value into the table as unprocessed record

Record is inserted with unprocessed status

Once the polling frequency is accomplished the new record is processed

The temperature is over 30 degrees so an email is sent to my account
alerting about that circumstance.