How to add a ServiceNow provider
Providers contain the connection details to external platforms. A provider only needs to be set up once and can then be used when creating tiles on a dashboard.
There are two types of providers:
generic Web API providers that can connect to any REST API
dedicated providers that connect to a specific external platform (ServiceNow, Azure Active App Insights, Elasticsearch, etc.)
If you previously configured a ServiceNow account for use with the Web API tile, you can skip this section and go straight to How to add a ServiceNow provider because the new provider can use the same ServiceNow account and settings as the old provider (so there is nothing to change within ServiceNow).
- In the Application Navigator (left-hand menu) go to System OAuth and click Application Registry.
- Click Create an OAuth API endpoint for external clients.
- Call it something like
SquaredUpto make it easier to remember, all the other defaults should be fine.
- Once you've created the endpoint, open the entry to view the client ID and secret (click the padlock next to the client secret to see it!) and copy these into a notepad for use later.
Adding a ServiceNow provider in SquaredUp
The ServiceNow tile needs a new ServiceNow specific provider to be configured in SquaredUp, and cannot use an existing Web API oauth provider you created for use with the Web API tile. The new provider can of course use the same ServiceNow account and settings as the old provider (so there is nothing to change within ServiceNow). The new ServiceNow specific provider is backwardly compatible with the Web API tile.
In SquaredUp navigate to the right-hand menu ☰ > system > Integrations > Add An Integration
- Click on ServiceNow and type in a suitable name, e.g. ServiceNow.
- The instance url should look something like
instancenameis your instance (if
/api/now/is not included as part of the instance URL then it will be automatically appended to this URL when the provider is created). If ServiceNow is installed on-premises, this may be something different. This URL is prepended to every request URL.
- client id and secret are taken from the notes you made earlier.
- username and password of the ServiceNow account which has been setup with the permissions listed in the How to add a ServiceNow provider.
- Click Save.
If the configuration is correct you will see a green tick.
If the provider is not authorized it could be that some of the provider configuration is incorrect (for example the username, password, secret etc), or if you use a proxy it could be that the proxy is not configured. See How to configure SquaredUp to use a proxy.