Before we configure our Connection, we need to ensure we have a user in the instance to use as the Inbound user for our Integration. To configure our Integration user:
In the native ServiceNow window, navigate to User Administration > Users. Click New.
The fields to be configured for the User record are as follows:
The id of the user (to be used by the external system for authentication).
The integration user's first name.
<Your First Name>
The integration user's last name.
<Your Last Name>
The user's password (to be used in basic authentication).
The roles required for access to the integrated records.
Your User record should look like this:
Back in the Unifi Integration Designer window, after clicking the 'Connections' icon, the first thing you will notice is a widget at the top of the page which clearly displays the inbound endpoints (REST Resources) which were automatically created when the Process was configured.
The fields to be configured for the New Connection modal are as follows:
The environment this connection applies to.
The external system's access URL.
<External system Endpoint URL>
Use this connection for the integration when true.
The format of the Endpoint URL is as follows:
Your New Connection modal should look like this:
9) Click Submit and view.
The fields to be configured for the Details form are as follows:
The authentication method to use for this connection.
The username used in basic authentication.
The password used in basic authentication.
<External system user password>
The user profile used by the external system for authentication. An active connection must be found for the user to gain access.
<lookup: Your Inbound User>
Your Details form should look like this:
14) Save the Connection.
At this stage you can carry our a basic connection test which verifies whether the user is authorized (i.e. whether you've configured the user/password/roles correctly). To do this, click Connection Test.
Then, on the Connection Test modal, click Test.
The results (Pass/Fail) will be displayed.
The main, manually configured elements are now in place for our Integration to work. We are now ready to configure and test each of our Scenarios in turn.