Fortinet black logo

Administration Guide

Creating or editing ITSM connectors

Creating or editing ITSM connectors

You can create ITSM connectors for ServiceNow, Slack, and Webhook.

To create an ITSM connector:
  1. Go to Fabric View > Fabric > Fabric Connectors, and click Create New.
  2. Under ITSM, click ServiceNow Connector, Slack Connector, or Generic Connector and click Next.
  3. Configure the following options, and click OK:

    Property

    Description

    Name

    Type a name for the fabric connector.

    Description

    (Optional) Type a description for the fabric connector.

    Protocol

    Select HTTPS.

    For Slack connectors and Generic connectors, you can also select HTTP.

    Port

    Specify the port FortiAnalyzer uses to communicate with the external platform.

    Method

    Select POST.

    For Slack connectors and Generic connectors, you can also select PUT.

    Title

    Type a title for the fabric connector.

    URL

    Type the URL of the external platform.

    Using ServiceNow as an example, copy and paste the URL from ServiceNow API URL in the Connection to ServiceNow API section in ServiceNow > FortiAnalyzer System Properties.

    Enable HTTP Authentication

    Set HTTP authentication to ON or OFF.

    If set to ON, select Basic or OAuth2 authentication type.

    Using ServiceNow with Basic authenictation as an example, enter the username and password from the Connection to ServiceNow API section in ServiceNow > FortiAnalyzer System Properties.

    Using Webhook Connector with OAuth2 authentication as an example, enter the URL of the token service as well as the client ID and client secret for authentication.

    Status

    Toggle ON to enable the fabric connector. Toggle OFF to disable the fabric connector.

Tooltip

After a ServiceNow connector is created, playbooks configured in FortiSoC can use the connector to post incident change notices. See Playbooks.

To edit an ITSM connector:
  1. Go to Fabric View > Fabric > Connectors.
  2. Right-click an ITSM connector, and select Edit.

    The Edit Connectors dialog box is displayed.

  3. Edit the settings, and click OK.

Creating or editing ITSM connectors

You can create ITSM connectors for ServiceNow, Slack, and Webhook.

To create an ITSM connector:
  1. Go to Fabric View > Fabric > Fabric Connectors, and click Create New.
  2. Under ITSM, click ServiceNow Connector, Slack Connector, or Generic Connector and click Next.
  3. Configure the following options, and click OK:

    Property

    Description

    Name

    Type a name for the fabric connector.

    Description

    (Optional) Type a description for the fabric connector.

    Protocol

    Select HTTPS.

    For Slack connectors and Generic connectors, you can also select HTTP.

    Port

    Specify the port FortiAnalyzer uses to communicate with the external platform.

    Method

    Select POST.

    For Slack connectors and Generic connectors, you can also select PUT.

    Title

    Type a title for the fabric connector.

    URL

    Type the URL of the external platform.

    Using ServiceNow as an example, copy and paste the URL from ServiceNow API URL in the Connection to ServiceNow API section in ServiceNow > FortiAnalyzer System Properties.

    Enable HTTP Authentication

    Set HTTP authentication to ON or OFF.

    If set to ON, select Basic or OAuth2 authentication type.

    Using ServiceNow with Basic authenictation as an example, enter the username and password from the Connection to ServiceNow API section in ServiceNow > FortiAnalyzer System Properties.

    Using Webhook Connector with OAuth2 authentication as an example, enter the URL of the token service as well as the client ID and client secret for authentication.

    Status

    Toggle ON to enable the fabric connector. Toggle OFF to disable the fabric connector.

Tooltip

After a ServiceNow connector is created, playbooks configured in FortiSoC can use the connector to post incident change notices. See Playbooks.

To edit an ITSM connector:
  1. Go to Fabric View > Fabric > Connectors.
  2. Right-click an ITSM connector, and select Edit.

    The Edit Connectors dialog box is displayed.

  3. Edit the settings, and click OK.