Skip to main content

ServiceNow

The ServiceNow integration enables enterprise organizations to improve operational efficiencies by streamlining and automating change management processes. Specifically, it allows you to manage projects, teams and customer interactions by customizing approvals, which helps reduce errors and ensure compliance without slowing your release process. With this integration:

  • If your organization manages changes in ServiceNow, when you make required approvals in Harness FME, all approvals are forwarded to ServiceNow so that change requests are recorded and approved in one place.
  • If you’re an approver, you can manage your approvals.
  • If you’re an engineer, any change you make is quickly recorded and approved. This integration also lets you know when your changes are approved.

Supported version​

The following is the supported ServiceNow version:

Product/plan: Service Now ITSM Pro Platform version: Rome and later versions DevOps plugin: 1.35.1 and later versions

Setting up in Harness FME​

Create a Harness FME token​

To start connecting the ServiceNow integration to Harness FME, you need to generate and copy a Harness authentication token so you can paste it into the ServiceNow integration.

To create your Harness authentication token, do the following:

  1. Click the profile button at the bottom of the left navigation pane and click Admin settings.
  2. Click Integrations and navigate to the Marketplace tab.
  3. Find ServiceNow in the integrations list and click Add. The Connect to ServiceNow DevOps page appears.
  4. Enter a user friendly name for the integration and click Save. The authentication token is created once you save the settings page.
  5. Copy your authentication token. You need the token to configure your Harness FME extension in ServiceNow integration. Note: This field is not editable.

From here, you can either configure your environment within Harness FME for ServiceNow approvals or go to ServiceNow to finish setting up your integration.

Configure your Harness FME environment for ServiceNow approval (optional)​

You can configure your Harness FME environment so approvals only occur on the ServiceNow side.

To configure your Harness FME environment, do the following:

  1. Click the profile button at the bottom of the left navigation pane and click Admin settings.
  2. Select Projects to see the projects in your Harness account.
  3. For one of the projects, click View. The environments associated with this project display.
  4. Within the Environments tab, click Edit on the desired environment (e.g. Prod-client). The Edit environment page appears.
  5. In the Change permissions section, select Require approval for changes, then select Restrict who can approve.
  6. On the Approvers menu list, in the first field, select Integration and in the second field, select ServiceNow, ServiceNow DevOps.
  7. Click the Save button. This takes you back to the selected project page. Now when you make a change to an FME feature flag or segment in Harness, the approver is automatically set to the ServiceNow integration. View this in the Change summary page under the Approvers field.

Set up in ServiceNow DevOps​

Create a ServiceNow DevOps tool for Harness FME​

After setting up Harness FME, you can set up the integration in ServiceNow DevOps by doing the following:

  1. From the ServiceNow store, install the DevOps Feature Flag Integration (if not already installed).
  2. In ServiceNow, at the top left of the page, select All to access the navigation.
  3. Search for tools and select Create New. The Create DevOps tool page appears.
  4. In the tool page, enter the following:
    • In the Tool name field, enter a human recognizable name (e.g. splitdemotool).
    • In the Tool integration field, enter Split IO and select the provided option.
    • In the Tool URL field, enter **https://api.split.io **.
    • In the Tool username field, optionally enter any username you want.
    • In the Tool password/Access token field, paste the Harness authentication token you generated when you set up ServiceNow in Harness FME.
  5. Click the Submit button. A new DevOps tool is created in ServiceNow. From here, refer to the Connection status field to see if the tool is connected to Harness FME. Note: When you create a tool, it can take up to a minute.

Add a webhook for the ServiceNow DevOps tool​

Once you connect to Harness FME, you need to configure your new tool to receive notifications from Harness FME when you or others make changes to feature flags and segments.

To add a webhook, do the following:

  1. In ServiceNow, from the left navigation select Feature flag tools. The DevOps tools page appears with the extension you created.
  2. From this page, select the Split tool and click the Configure button. The message Webhook is configured successfully appears at the top of the screen.
  3. Switch back to Harness FME under the ServiceNow DevOps Integration that was just configured, and ensure that it is now set to Active.
  4. Within ServiceNow, to get your data from Harness FME to display on the ServiceNow view, click the Discover button. This populates the Harness FME projects, environments, feature flags (if any), and segments (if any) on the DevOps tool page.

Troubleshooting tip: If all the projects, environments, and feature flags are not loaded correctly or some are missing. Please reload the page and wait for all of them to appear. If they still don't appear, then please remove the webhook from both ServiceNow and Harness FME and add it again by following the steps mentioned above.

Add an approval group in ServiceNow (optional)​

After configuring your ServiceNow tool, you can optionally preconfigure an environment to assign change requests to a specific Change Approval Group by doing the following:

  1. In the left navigation, click All, then under DevOps, select Environment. The Environments page appears.
  2. In the Name column, select the desired environment that has the approval workflow attached within Harness FME. The Environment page appears.
  3. In the Edit Environment page, set the Change Model field to Normal. Optionally, set the Change Type field to Normal if not already set and click the Update button.
  4. In the Change approval group field, select the desired approval group and click the Update button. The Environment page redisplays with the environment now configured and all Harness FME change requests for a given environment are assigned to the selected approval group.