This article provides detailed design information about the Connected System design object and its configuration options. A connected system represents an external system that is integrated with Appian. Connected systems allow you to share connection details across multiple integrations. You can also upload a logo image to visually identify the system
Each connected system has the following properties.
|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 when selecting the system in the integration designer and in the application contents grid.|
|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.|
|Authentication||The type of authentication to use for the integrations that use this connected system.
The following properties are available for configuration when HTTP Basic Authentication is selected as the authentication type:
|Username||The username to use for authentication. This value is encrypted and supports environment specific configuration.|
|Password||The password to use for authentication. This value is masked, encrypted, and supports environment specific configuration.|
|Send credentials preemptively instead of waiting for a 401 authentication challenge||Determines whether or not authentication credentials are sent only after a 401 Not Authorized response or, when selected, before the system has challenged.|
The following properties are available for configuration when OAuth 2.0 is selected as the authentication type:
|Callback URI||Required (in the other system). This URI provided within the instructions of the configure authorization box. Follows the format: http://
|Authorization Endpoint||Required. The endpoint specified in the third-party system's documentation to the authorization server. Allows Appian to connect to the authorization server.|
|Client ID||Required. ID provided by the third-party system during the registration process.|
|Client Secret||Required. The password provided by the third-party system during the registration process. This field is masked to prevent unauthorized users from seeing and should be treated as a password.|
|Scope||Optional. Defines what resources are available from the resource server. Depending on what system Appian is connecting to, scope may be set from the connected system or within the third-party system directly.|
|Token Request Endpoint||Required. The endpoint specified in the third-party system's documentation to send the token to the resource server.|
The security rolemap of the connected system controls who can see or modify the connected system properties.
Connected systems can be used when calling an integration by any user regardless of their defined role in the security rolemap.
The following actions can be completed by each role:
|Evaluate integrations that use this connected system||Yes||Yes||Yes||Yes|
|Select this connected system when creating an integration||Yes||Yes||Yes||No|