Integration Administration

Estimated Reading Time:  3 minutes

Overview

Integration Administration lets you manage all your application integrations in Unqork. Complex applications require access to a diverse set of platforms and data sources. Integration Administration ensures your applications integrate seamlessly, accelerating your development. This administration page provides two integration options. You can integrate your external services using Services Administration or the Integration Gateway.

What You'll Learn

In this article, you'll understand the differences between Services Administration and the Integration Gateway. You'll also learn how to configure external connections in both.

Differences Between Services Administration and Integration Gateway

Here are the high-level differences between Services Administration and Integration Gateway:

Services Administration

Services Administration lets you create and manage standard authentication integrations. It lets you set up services and connect to third-party platforms and APIs APIs (application programming interfaces) are a set of protocols and definitions developers use to build and integrate application software. APIs act as the connective tissue between products and services. in Unqork applications.

Services Administration supports the following authentication methods:

  • No Authentication

  • Basic Auth

  • OIDC

  • Bearer Token

  • WSSE Username Token Profile

  • HMAC

  • Custom Soap Headers

  • OAuth 2.0

  • Client Credentials Grant

  • Password Grant

  • JWT Bearer Grant

  • JWT Client Credential Grant Extended

It also supports the following platform-specific authentications:

  • Canada Post

  • Google Places

  • Twilio

  • Plaid

  • Hyperscience

You can also set up FTP, SFTP, and GPG encryption-based connections.

Integration Gateway

The Integration Gateway takes your external integration experience one step further. Services Administration does not support connections to databases or working with messaging queues. It also does not support extra fields in standard authentication schemes.

The Integration Gateway accelerates digital transformations by integrating with over 700 systems across enterprise applications, databases, and legacy on-premise infrastructure—in the cloud or on-premise.

Here are a few examples of available, ready-to-use external services:

  • Salesforce

  • Microsoft SQL Server

  • MySQL

  • Greenhouse

  • ADP Workforce Now

  • Jira

  • Dropbox

  • Stripe

Once connected, you can create a step-by-step recipe to map the integration's flow. A recipe works like an Unqork Workflow. You'll create a starting and ending point with steps in between. Recipes let you integrate your connections, set up triggers, and determine the actions and events you want to occur when triggered. Lastly, you can associate the recipe with an endpoint to use it in Unqork.

Accessing Integration Administration

To access the Integration Administration page:

1. At the top right of the Unqork Designer Platform, click Settings ▾.
2. Click Administration.
3. Under Integration, select Integration Administration.

After accessing the page, you'll see two tabs to the left: Integration Gateway and Services Administration. The remainder of this article covers the Integration Gateway tab.

TIP  To learn more about the Services Administration tab, view our Services Administration article.

Navigating the Integration Gateway

After accessing the Integration Gateway, there are various tabs you can select to create projects, set up endpoints, promote recipes, and set up on-premise agents.

A static image displaying Unqork's Integration Gateway.

The table below provides descriptions of what to expect from each tab in Integration Gateway:

Tab Description

Projects

Create and access projects to build and run recipes and connections.

API Platform

Create endpoints so you can run your recipes in Unqork using a Plug-In component.

Promote

Create a manifest to store endpoints, collections, connections, and recipes that are part of the same project. Then, you can export these assets as a ZIP file containing the package's JSON JSON (JavaScript Object Notation) is an open standard file and data interchange format. Unqork uses JSON for submission (record) data. definition. Import this file for use in a different environment level.

Environment Properties

Create Property Name and Value pairs that recipes can look up every time a job is executed. For sensitive values, you can use the Property Names of key, password, and secret to hide a value.

On Prem Groups

Create an On-Prem Group to connect to on-premise (on-prem) systems, like databases, Jira, Sharepoint, Oracle, and so on. You can create an On-Prem Agent, choose an operating system, download an installer locally, and run and test your on-prem systems.

TIP  To learn more about setting up On-Prem Groups and Agents, view our How to: Create On-Prem Groups Using the Integration Gateway article.

Resources