# Connection

## Inbound User

Before configuring the Connection, you need to ensure you have a user in the instance to use as the Inbound user for the Integration. To configure your Inbound 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:

|  #  | Field      | Description                                                                | Value                     |
| :-: | ---------- | -------------------------------------------------------------------------- | ------------------------- |
|  1  | User ID    | The id of the user (to be used by the external system for authentication). | \<your.integration\_user> |
|  2  | First name | The integration user's first name.                                         | \<Your First Name>        |
|  3  | Last name  | The integration user's last name.                                          | \<Your Last Name>         |
|  4  | Password   | The user's password (to be used in basic authentication).                  | \<Your Password>          |
|  5  | Roles      | The role required for access to the integrated records.                    | 'itil'                    |

*Your User record should look like this:*

![](/files/-MQm179drO13Nj3LvtP7)

## Connection

{% hint style="info" %}
Although you can set up many connections to enable switching between environments (one connection per environment), it is worth noting that only one connection can be active for an Integration at a time.
{% endhint %}

{% hint style="success" %}
&#x20;We will, however, set up only one connection in the 'Development' environment.
{% endhint %}

Back in the **Unifi Integration Designer** window, click on the **'Connections' icon**, then click **New**.

The fields to be configured for the New Connection modal are as follows:

|  #  | Field        | Description                                        | Value                           |
| :-: | ------------ | -------------------------------------------------- | ------------------------------- |
|  6  | Environment  | The environment this connection applies to.        | 'Development'                   |
|  7  | Endpoint URL | The external system's access URL.                  | \<External system Endpoint URL> |
|  8  | Active       | Use this connection for the integration when true. | \<true>                         |

## Outbound Connectivity

The format of the Endpoint URL is as follows:&#x20;

`https://<your_developer_instance>.service-now.com/api/now/table/incident`

*Your New Connection modal should look like this:*

![](/files/-MQm38h9KhwdwFG_xZua)

9\) Click **'Submit and view'**.

{% hint style="info" %}
Clicking 'Submit' will redirect you to the list view of the record you're creating. Clicking 'Submit and view' will redirect you to the newly created record.
{% endhint %}

## Connection Details

The fields to be configured for the Details form are as follows:

|  #  | Field            | Description                                                                                                                      | Value                            |
| :-: | ---------------- | -------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|  10 | Authentication   | The authentication method to use for this connection.                                                                            | 'Basic'                          |
|  11 | User\*           | The username used in basic authentication.                                                                                       | \<external.system.user>          |
|  12 | Password\*       | The password used in basic authentication.                                                                                       | \<External system user password> |
|  13 | Inbound user\*\* | 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>     |

{% hint style="info" %}
\*(External) User/Password: *As created/set in your PDI.*

\*\*Inbound user: *As created above.*
{% endhint %}

*Your Details form should look like this:*

![](/files/-MQmAEloqCKvduYKzaT7)

14\) **Save** the Connection.

We are now ready to step back into the **native ServiceNow** window to configure the **Trigger**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sharelogic.com/unifi/2.2/integration-guides/outbound-incident-guide/connection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.