A Connection is a property of an Integration. You must have a Connection setup to allow messages to be sent and received for your Integration.
The Connection stores all the authentication details of the Integration specific to a single environment. You can setup many Connections so you can easily switch between environments as necessary.
The Integration is controlled by the Connections. Making a Connection active will make it’s Integration active (and vice versa).
Although you can have multiple Connections per Integration, only one Connection can be active for an Integration at a time. Activating a different Connection will deactivate other Connections (for the Integration).
You can assign a Connection to a specific environment to make it easy to see what you are connecting to.
Available environment choices are:
The Connection is the link between the ServiceNow endpoint that is receiving messages and the Integration that is used to process them. If you want to receive messages from a remote system, you must specify an Inbound user which the remote system will use to authenticate with.
In order for a Connection to send messages to remote systems, you must provide an Endpoint URL and the method of authentication.
Connections support several types of authentication: Basic, Mutual and OAuth.
Basic authentication is achieved by providing a username and password.
Mutual Authentication (MAuth) using SSL certificates is available by selecting the Mutual auth checkbox and configuring certificates on a ServiceNow Protocol Profile record.
You can connect using OAuth by configuring a ServiceNow OAuth Entity Profile.
If the system you are connecting to is behind a firewall (such as an internal service) you can specify a MID Server for the integration to communicate over.
The following table is a summary of the fields to be configured for the Connection record:
|Environment||Reference||The environment this connection applies to.|
|Integration||Reference||The integration this record belongs to.|
|Application||Reference||The application containing this record.|
|Active||Boolean||Use this connection for the integration when true.|
|Inbound user||Reference||The user profile used by the external system for authentication. An active connection must be found for the user to gain access.|
|Endpoint URL||URL||The external system’s access URL.|
|Authentication||String||The authentication method to use for this connection.|
|User||String||The username used in basic authentication.|
|Password||Password2||The password used in basic authentication.|
|OAuth profile*||Reference||The OAuth Entity Profile to authenticate with.|
|MID server||Reference||The MID server this connection will use to send messages.|
|Mutual auth||Boolean||Use mutual authentication with each request sent to this connection when true.|
|Protocol profile**||Reference||The protocol profile to use with this connection.|
*OAuth profile: This field is visible when ‘OAuth’ has been selected as the choice from the
**Protocol profile: This field is visible when
Mutual auth is checked/set to ‘true’.