---
title: Connecting Neurons for SOM to ADO
slug: neurons-for-itsm/admin-user-help/enu/latest/connecting-neurons-for-som-to-ado
createdAt: 2026-07-14T19:16:35.952Z
---

Perform the following procedures to connect Neurons for SOM to your ADO instance.

::::ExpandableHeading
## Credentials and Initial Setup

1. Log into ITSM as an Administrator and open the** Ticket Sharing and Synchronization **(TSS) workspace.
2. Select **New Ticket Sharing and Synchronization**.
3. Enter the** Integration Name** (example: ADO).
4. Select **Incident **from the **Business Object Name** menu.
5. Select **Enabled **from the Status menu.
6. In the **Service Name** field, find and select ADO.
7. Save.

:::Paragraph{indent="1"}
Four new tabs now appear after the **Credentials **tab: **Filters**,** Field Mapping**, **Data Mapping**, and **Data Rules**.
:::

8. The **Credentials **tab now contains three additional fields:
   1. **Service URL**: Relevant ADO instance URL (example: https\://dev.azure.com/YourCompany).
   2. **Username**: Jira account username (example: ADOUsername\@company.com).
   3. **Auth Token**: Token provided by ADO (example: Token1232323232323).
9. Click **Save**.
::::

:::ExpandableHeading
## Filters Tab

1. In the **Filters **tab, click **New Connector Service Filters**.
2. In the **New Connector Service Filters** dialog, select **Summary **from the **Incident/ivnt\_SecurityIncident Field Name** menu.
3. In the **Incident/ivnt\_SecurityIncident Field Name** field, enter Trojan. Depending on environment and criteria, choosing the Security Incident’s **Category **field (with, for example “Data Breach” as Field Value) might be more appropriate or practical.
4. **Operation with next Filter** determines how filtering works with other filters. Select the appropriate operator (AND or OR) (example: add a “Ransomware Detected” filter).
5. When all appropriate filters have been added, Save.
:::

:::ExpandableHeading
## Field Mapping Tab

1. In the **Field Mapping** tab, click **New Connector Service Field Mapping**.
   1. In the **New Connector Service Field Mapping **dialog, select **Summary** for the** Incident/ivnt\_SecurityIncident Field Name**.
   2. Enter System.Title for the **ADO Field Name**.
   3. Enter System.Title for the **Service Field Depth**.
   4. Select **Poll this field for any changes**.
   5. Save.
2. Click** New Connector Service Field Mapping**.
   1. In the **New Connector Service Field Mapping** dialog, select **Status** for the** Incident/ivnt\_SecurityIncident Field Name**.
   2. Enter System.State for the **ADO Field Name** . This field is in lowercase in Jira.
   3. Enter System.State for the **Service Field Depth**.
   4. Select **Poll this field for any changes**.
   5. Save.
3. Click** New Connector Service Field Mapping**.
   1. In the **New Connector Service Field Mapping** dialog, select **Description** for the **Incident/ivnt\_SecurityIncident Field Name**.
   2. Enter System.Description for the** ADO Field Name**.
   3. Enter System.Description for the** Service Field Depth**.
   4. Select **Poll this field for any changes.**
   5. Save.
4. Click** New Connector Service Field Mapping**.
   1. In the** New Connector Service Field Mapping** dialog, select **Provide default value** (to switch field mapping from ADO to ISM).
   2. Enter project for the **ADO Field Name**.
   3. Enter the name of the ADO project for the **Default Value**.
   4. Click **Save**.
:::

:::ExpandableHeading
## Data Mapping Tab

1. In the **Data Mapping** tab, click **New Connector Service Data Mapping**.
   1. In the **New Connector Service Field Mapping **dialog, select **Incident/ivnt\_SecurityIncident)=Status \:: ADO=System.State** for the **Connector Service Field**.
   2. Enter Resolved for the **Incident/ivnt\_SecurityIncident Field Value**.
   3. Enter Resolved for the **ADO Field Value**.
   4. Save.
2. Click **New Connector Service Data Mapping**.
   1. Select **Incident/ivnt\_SecurityIncident=Status \:: ADO=System.State **for the **Connector Service Field**.
   2. Enter Logged for the** Incident/ivnt\_SecurityIncident Field Value**.
   3. Enter Committed for the **ADO Field Value**.
   4. Save.
3. Click **New Connector Service Data Mapping**.
   1. Select **IIncident/ivnt\_SecurityIncident=Status \:: ADO=System.State** for the **Connector Service Field**.
   2. Enter Active for the **Incident/ivnt\_SecurityIncident Field Value** .
   3. Enter New for the **ADO Field Value**.
   4. Save.
4. Click **New Connector Service Data Mapping**.
   1. Select **ncident/ivnt\_SecurityIncident=Status \:: ADO=System.State** for the **Connector Service Field**.
   2. Enter Closed for the **Incident/ivnt\_SecurityIncident Field Value**..
   3. Enter Done for the **ADO Field Value**.
   4. Save.
:::

:::ExpandableHeading
## Data Rules Tab

1. In the Data Rules tab, select **New Connector Service Field Constraint**..
   1. In the **Field Mapping Value** menu, select** Incident/ivnt\_SecurityIncident=Status \:: ADO=System.State\[Resolved,Resolved]**.
   2. In the **Business Object Field Name** menu, select **CauseCode**.
   3. Enter Vulnerability for the** Business Object Field Value**. This is an example; you need to match whatever cause codes you have set up in your Incident or Security Incident objects.
   4. Save.
2. Click** New Connector Service Field Constraint**.
   1. In the **Field Mapping Value** menu, select **Incident/ivnt\_SecurityIncident=Status \:: ADO=System.State\[Resolved,Resolved].**
   2. In the **Business Object Field Name** menu, select **Resolution**.
   3. Enter Data Rules Resolution for the** Business Object Field Value**. This is an example; you need to match whatever resolution values you have set up in your Incident or Security Incident objects.
   4. Click **Save**.
:::

:::ExpandableHeading
## Additional Operations

1. Click the **Additional Operations** tab. If the tab is not visible, you may have to refresh or go to List View and select your TSS again.
2. Select the following options:
   - **Push Comments added in HEAT to ADO**
   - **Pull Comments added in ADO to HEAT**
   - **Push Attachments added in HEAT to ADO**
   - **Pull Attachments added in ADO to HEAT**
3. In the **Comment Business Object** menu, select **Journal#Notes**.
4. Click **Save**.
:::

:::ExpandableHeading
## Comment Field Mapping

1. Click the** Comment Field Mapping** tab. If the tab is not visible, you may have to refresh or go to List View and select your TSS again.
2. Click **New Comment Field Mapping**.
   1. In the **Incident/ivnt\_SecurityIncident Field Name** menu, select **Notes**.
   2. Enter Description for the** ADO Field Name**.
   3. Click **Save**.
3. Click** New Comment Field Mapping**.
   1. In the **Incident Field Name** menu, select **Subject**.
   2. Enter Summary for the **Jira Field Name**.
   3. Click **Save**.
:::