Free cookie consent management tool by TermsFeed HTTP Connected System [Connected Systems]
HTTP Connected System

Overview

HTTP connected systems allow you to connect to various third-party systems easily by sharing base URL and authentication details across multiple integrations. You can also upload a logo image to visually identify the system.

This page provides details about HTTP connected system properties. For information that pertains to all connected systems, see Connected System Object.

If the system you are connecting to uses OpenAPI, you can use an OpenAPI Connected System instead.

If you unable to connect to a connected system using an HTTP connected system, you have several options:

  • Check out the pre-built connected systems that connect to popular third-party systems.
    • Some of these are included with Appian. See the options available under CONNECTED SYSTEM TYPES in the topics to the left.
    • You can also download pre-built connected system plug-ins from the App Market.
  • Java developers can build custom connected system plug-ins using the SDK.

Properties

Each HTTP connected system has the following properties.

Field Description
Name The name of the connected system. Use a name that will uniquely identify this connection to the external system.
Description Supplemental information about the connected system that is displayed in the objects grid of some Designer views and when selecting the system in an integration object.
UUID The Appian-generated identifier of the connected system object. This UUID is needed when updating the object using the connected system management API.
System Logo An image document used to visually represent the external system or service being connected to. The logo is displayed in the integration designer and in the Process Modeler on integrations that connect to this system (using the Call Integration Smart Service). If no document is selected a default logo will be used instead.
Base URL A consistent prefix for the URLs of this connected system's integrations.

This value is included in import customization files so that you can specify a different value for each environment.
Authentication The type of authentication to use for integrations that use this connected system.

screenshot of an HTTP connected system object

Automating property updates

This object's properties can also be updated programmatically using the Update Connected System endpoint. This lets you change passwords, API keys, and other values without needing to sign in to Appian.

The following properties can be included in the JSON request body of the PATCH /connected-system/<UUID> call.

*Custom header properties are incrementally labeled. csCustomHeaders.1 is the property name of the first custom header.
Authentication Type Available Properties
API Key baseUrl, apiKeyValue
Basic baseUrl, username, password
Google Service Account baseUrl, projectId, privateKeyId, privateKey, clientEmail, clientId, tokenUri, userEmail
OAuth 2.0: Authorization Code Grant baseUrl, clientId, clientSecret, tokenUrl, authUrl
OAuth 2.0: Client Credentials Grant baseUrl, clientId, clientSecret, tokenUrl
OAuth 2.0: SAML Bearer Assertion Flow baseUrl, clientId, clientSecret, tokenUrl, refreshTokenUrl, csCustomHeaders.n*
OpenID Connect Properties are inherited from the environment's OIDC configuration. These values can be changed in the Admin Console.

HTTP Connected System

FEEDBACK