Integrate with ServiceNow

The integration with ServiceNow allows you to configure email notifications that you can receive daily or any time there is a change to a Best Practice Check or alert.

To learn how to configure your integration with ServiceNow, review the procedure.

Procedure

  1. From the left navigation bar, choose Account Settings > Integrations > Configurations.

    The Integration Configurations page opens.

  2. From the drop-down menu, select ServiceNow.

  3. In the blank text field, type the name of the ServiceNow account.

  4. Click Create.

    A message indicates that your integration was created successfully.

  5. Click OK.

    The page displays the new integration.

  6. Click (green plus sign) to display the details of the ServiceNow integration.

    The ServiceNow integration expands.

    Notice the Account section. Here is an explanation of each data field:

    Parameter

    Description

    Name

    Name of the integration

    Instance

    Your company's ServiceNow instance; Corresponds to sub-domain in the URL

    ClientId

    Unique ID that the application uses when requesting an access token

    ClientSecret

    Secret string shared by the application and the instance to authorize communication

    Username

    Username in ServiceNow

    Password

    Password in ServiceNow

    Assignment Group/sys_id (optional)

    A pool of agents or vendors from which you can choose one to complete a work order task.

    To use an assignment group, you must get the sys_id from ServiceNow.

    1. Navigate to the group record and right-click the header.

    2. From the fly-out menu, select Copy sys_id to copy it to the clipboard.

  7. Type a name for the application in the first field.

    The next steps will show you how to retrieve the account data from ServiceNow.

  8. Launch ServiceNow.

    You may need to reset the password when you first log in to ServiceNow.
  9. Navigate to your instance in ServiceNow and copy the subdomain and not the full URL.

    In this example, the subdomain is dev54396.

  10. Return to CloudCheckr, and paste the subdomain into the Instance field.

  11. Return to your instance in ServiceNow, scroll down the page, and copy the username and password.

  12. Return to CloudCheckr, and paste the username and password into the corresponding fields.

  13. From the left navigation in ServiceNow, choose SystemOAuth > Application Registry.

  14. From the menu bar at the top of the page, click New.

    The right pane displays information on the OAuth application.

  15. Select Create an OAuth API endpoint for external clients.

  16. In the right pane, type a name and copy the client ID.

  17. Click Submit.

    ServiceNow will autogenerate a client secret ID.

  18. Unhide the ID and copy it.

  19. Return to CloudCheckr.

  20. Copy the client ID and the client secret ID to the appropriate fields and type a name for the application.

  21. Click Save.

  22. Click Send Test.

    If the test is successful, CloudCheckr will display a message.

    If the test fails, make sure that:
    • The information in the fields, including ClientSecret and Password fields, is correct
    • OAuth is enabled
    • Refresh tokens are not low

  23. To learn about other configuration options and to turn on alerts, review the topic, Integration Configuration - Understanding Other Options.

How did we do?