Configure Your First Virtual Device on Catenis Flow

Note: You will need to have created a virtual device on your Catenis administrative interface before proceeding with this step. You can find instructions for creating your first virtual device: Click Here

Now that you have installed the Catenis pallet on Node-RED let’s configure connectivity to the Catenis Sandbox server.  If you have still not installed the Catenis pallet, see the section titled “Installing the Catenis Flow Pallet on Node-RED” You will also be required to have signed up for an account at

Getting your Virtual Device ID and Access Secret

In order to have Catenis Flow connect to the Catenis APIs on the sandbox environment you first need to add your virtual devices credentials in Node-RED as a “configuration node”. This will require that you obtain both the Device ID and the API Access Secret from your Catenis administrative user interface.

Note: To get the API Access Secret on your Catenis Administrative User Interface, go to “Virtual Devices” on the left nav bar and click the “API Access Secret” button in the bottom left of the panel. DO NOT use information from the “API Access” section listed on the left navbar unless you created your device to share secret keys.

  1. Login to
  2. Click on the “Virtual Devices” button
  3. Identify the “Device ID” corresponding to the device you wish to use. Copy this ID for later.  Click on the hyperlink on the “Device ID”
  4. Click on the API Access Secret button
  5. Your Access Secret will be displayed in the pop-up. Copy the Device’s API Access Secret to be used in the next step
Login Screen
Virtual Devices Button
Virtual Device ID Link
Device Level API Access Secret
Image Description

Adding Virtual Device to Node-RED

Virtual devices are created by setting up a configuration node. A configuration node is a special type of node that holds reusable configuration information that can be shared by nodes in a flow. Once a virtual device is created via a configuration node, this node will be available for use by all Catenis Flow nodes. 

Let’s set up our first configuration node with the virtual device information. Double click on the “log message” node. This will expand the properties dialogue box for the log message node.  This slide-out dialogue box contains all of the possible configurations for the specific node.

  1. To create a new device, click the pencil button icon on the right of the Device ID field to add a new configuration node to the flow. 

Note: A “Error - server error” message may show up. Ignore this message as the node is trying to communicate with the server, but the node has not yet been configured.

Login Screen
  1. Enter the Virtual device ID and API access secret you obtained from your customer administration interface(as explained above).
    1. Enter a name in the “Name Field” (i.e. Bitcoin Connector)
    2. Enter your Virtual device ID in the “Device Field”
    3. Enter the API Access Secret in the “API Access Secret Field”
    4. Click “Add Button”
    5. The populated slide-out will show up again
  2. Uncheck the Encrypt checkbox. Make sure the “encrypt” option is unchecked as we need to see the transaction on the Bitcoin blockchain to ensure it is working correctly
  3. For testing let’s also disable the “off-chain message” option by unchecking this option so a bitcoin transaction is immediately created so we can later check for proper connectivity to the blockchain in a timelier fashion. Note: When building an application, you should always use off-chain messages. Standard messages incur higher fees, cost more Catenis credits and create unneeded bitcoin transactions
  4. Click the “Done” Button
  5. Click the “Deploy” Button
Configuring The Virtual Device Credentials

Now you should be ready to test connectivity to the Catenis APIs via Catenis Flow and interact with the bitcoin blockchain.

Related Articles

How can we make things Better for you?
  • Accepted file types: jpg, gif, png, pdf.
  • This field is for validation purposes and should be left unchanged.