Integrate with ServiceNow

Introduction

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.
  2. The Integration Configurations page opens.


  3. From the drop-down menu, select ServiceNow.
  4. In the blank text field, type the name of the ServiceNow account.
  5. Click Create.
  6. A message indicates that your integration was created successfully.

  7. Click OK.
  8. The page displays the new integration.

  9. Click (green plus sign) to display the details of the ServiceNow integration.
  10. 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.

    How do I 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.

  11. Type a name for the application in the first field.
  12. The next steps will show you how to retrieve the account data from ServiceNow.

  13. Launch ServiceNow.
  14. Note: You may need to reset the password when you first log in to ServiceNow.

  15. Navigate to your instance in ServiceNow and copy the subdomain and not the full URL.
  16. In this example, the subdomain is dev54396.


  17. Return to CloudCheckr, and paste the subdomain into the Instance field.
  18. Return to your instance in ServiceNow, scroll down the page, and copy the username and password.
  19. Return to CloudCheckr, and paste the username and password into the corresponding fields.
  20. From the left navigation in ServiceNow, choose SystemOAuth > Application Registry.

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


  22. The right pane displays information on the OAuth application.

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

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

  25. Click Submit.
  26. ServiceNow will autogenerate a client secret ID.

  27. Unhide the ID and copy it.

  28. Return to CloudCheckr.
  29. Copy the client ID and the client secret ID to the appropriate fields and type a name for the application.
  30. Click Save.
  31. Click Send Test.
  32. 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

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

See Also:
Integration Configuration – Understanding Other Options
Integration Configurations
Integrate with Slack
Integrate with PagerDuty
Integrate with Amazon SNS
Integrate with Syslog
Best Practice Report
Configure Best Practice Check Notification