Skip to main content
Kinetic Community

Bridgehub

Overview

Kinetic Bridgehub is the main web application that is used to store and run various Bridge Adapters that will be used to access data from different systems and convert it into a single, standardized bridging interface.

Installation

Download kinetic-bridgehub.war and place it in the tomcat webapps directory to deploy.

After the kinetic-bridgehub.war successfully deploys, you will be able to access Kinetic Bridgehub at http://server:port/kinetic-bridgehub. The default username/password combination is admin/admin.

Configuring the Console

Navigating to the Setup tab allows you to edit configuration details for the Bridgehub console.

The Configurator Username and Configurator Password allow you to modify the username/password combination that is needed to log into the Bridgehub Admin Console.

Log Level allows you to choose how verbose the bridge logging will be.

  • Info (Production) will log only necessary information, Debug (Development) will log events such as incoming requests, and Trace (Troubleshooting) is the most verbose logging available.

Log Size (MB) is the size that the Current Log is allowed to be in MB.

Creating a New Bridge

Click the Add Bridge button to start the process of creating a new Bridge.

bridgehub-choose-bridge-adapter.png

From the Bridge Adapter dropdown, choose the type of Bridge Adapter that you want to create.

After selecting a Bridge Adapter type, you will need to fill in the properties for your new Bridge.

  • Name: The Display Name for the Bridge
  • Slug: Unique short name/id for the Bridge (no spaces)
  • Use Access Keys?: An extra security measure that can be used alongside IP Address restrictions to only allow access to requests that include a pre-generated access/secret key combination (similar to passing a username/password along with a request)
  • Servers Allows API Access: A comma separated list of IP Addresses (* to allow all IPs) - Defaults to ipv4 and ipv6 localhost addresses

Any remaining properties are specific to the selected Bridge Adapter Class. See the individual documentation for each adapter to get more specifics about those properties.

Adding a New Access Key

When a bridge configuration has Use Access Keys set to Yes, the access key management (on the right side of the edit screen) will be shown.

bridgehub-add-access-keys.png

When adding access key the application will generate a secure and random access key and secret. It is also possible to edit these to values of your choosing when creating or editing access keys. It is also recommended to include a short description to denote who or what the key/secret will be used for.

bridgehub-create-access-key.png

Keep note of the access key and secret, which will be necessary for the user or integrating application to create signatures to authenticate the bridge request. All previously created access key/secret combinations will be available to view or edit on the bridge edit page.

bridgehub-added-access-key.png

Adding a New Adapter Class

Adapter Classes are how functionality for different services is added into Kinetic Bridgehub.

To add an Adapter Class, add the .jar file that contains the Adapter Class into the Bridgehub WEB-INF/lib folder. Tomcat then needs to be restarted for the changes to take appear.

To check and see if the Adapter was added properly, look under Adapters header in the Environment tab to see the name and version of all the currently installed Adapters.

Changelog

v1.1.1 (2017-06-08) - Download

  • Fix local configuration issue where sensitive properties were being encrypted multiple times leading to incorrect authentication after a Bridgehub restart

v1.1.0 (2017-05-16) - Download

  • Add Bridgehub clustering support with Cassandra
  • Add access key support
  • Add /{bridgeSlug} endpoint to the API to check if a bridge exists and is properly configured
  • All bridge results return as strings
  • If an adapter .jar is removed from the Bridgehub tomcat, the console now loads with a message saying the bridge cannot be found and allows deletion of missing bridge.
  • Bridges listed alphabetically
  • Passing no query parameters to an API request now has a more descriptive error
  • Removed sensitive properties from manage API returns
  • Updated Amazon EC2 Adapter to v1.0.1
  • Updated Google Admin Adapter to v1.0.1
  • Updated Kinetic Core Adapter to v1.0.3
  • Updated Salesforce Adapter to v1.0.1

v1.0.3 (2016-08-23) - Download

  • Show spinner and timing when testing bridge
  • Encrypt sensitive bridge properties in database
  • Add bridge adapter build
  • Allow pageSize and offset metadata values to be passed without a pageNumber
  • Authenticated users bypass IP Address list restrictions
  • Internet Explorer compatibility issues fixed
  • Key 'value'  for the Count object changed to 'count'
  • Added Azure Adapter
  • Updated Kinetic Core Adapter to v1.0.2
  • Updated Ars Adapter to v1.0.1

v1.0.2 (2016-06-03) - Download

  • Added support for Basic Authentication

v1.0.1 (2016-05-09) - Download

  • DisposableAdapter class added so that adapters could be destroyed on shutdown of the Bridgehub web application
  • Added a testing framework to make standalone adapter development easier

v1.0.0 (2015-12-18) - Download

  • Initial Version

Related

Topics
Form List
Create Form
Creating a new Request Form.
Form Description
Overview and other consoles containing detailed information about the Form
Builder
How to use the builder to create and maintain Forms for Request.
Forms
Form Details and Advanced Properties
Form Actions
Reviews available actions for the Forms.
Models
Mappings
Bridgehub
Kinetic Bridgehub is the main web application that is used to store and run various Bridge Adapters that will be used to access data from different systems and convert it into a single, standardized bridging interface.
Kinetic Bridgehub Adapter Creation Training
Class with activities on how to build your own bridges/adapters for bridgehub.
Add a Hyperlink to a Service Item
I would like to add a Hyperlink to my Service Item which will open a new Tab and display some related information.  How can I add a Hyperlink to my Service Item?
Migrating from Kinetic Request Remedy Edition (RE) to Kinetic Request Core Edition (CE) Q and A
Q&A for migrating from Request RE to Request CE
Remedy Bridge in CE for people search
Using Review Request in Kinetic Request CE
How to use Review Request to display a submission in read-only in Kinetic Request CE.
Bridgehub
Kinetic Bridgehub is the main web application that is used to store and run various Bridge Adapters that will be used to access data from different systems and convert it into a single, standardized bridging interface.
References
Other