Configuring Blinks ServiceNow integration
ServiceNow is one of the integrations which requires preconfiguation by a Blink administrator before employees can choose to enable it for themselves.
There are three steps to completion:
- Import the Blink Update Set into your ServiceNow instance.
- From ServiceNow, generate a Client ID and a Client Secret for Blink to use.
- From Blink, copy the Webhook Secret and Auth ID strings for ServiceNow to use.
NOTE! You will need to be an Admin in Blink and hold the ServiceNow Adminstrator role on your ServiceNow instance to complete this configuration!
Before you begin, open the config page for Blinks ServiceNow integration in the Blink admin panel. Choose integrations and select ServiceNow to do this.
Also open your ServiceNow instance in a web browser and log in as someone with the Systems Administrator role, which will romething like this:
1. Install the Blink Update Set on your ServiceNow instance.
An Update Set is ServiceNow terminology for an XML configuration file. The Blink Update Set contains our endpoint addresses and a few other bits of config, such as, which ServiceNow events to send to Blink.
Download the Update Set from this link then, in ServiceNow, navigate to System Update Sets, Retrieved Update Sets and click Import Update Set From XML to upload the file.
Press Preview to view the contents of the file, and then Commit to save the changes into your ServiceNow instance, once done you should see something similar to the image below.
Note that the state is committed because you previewed and commited the Update Set. It's easy to miss those two steps so don't forget!
2. Generate Client ID and Client Secret
These permit Blink to connect to your ServiceNow instance and take action on your behalf when you ask it to.
As a ServiceNow System Administrator, navigate to System OAuth, Application Registry and create a new entry in the application registry for Blink.
When prompted for the type, choose OAuth API endpoint for an external client and when asked for the name, call it Blink then hit Submit.
Blink will now appear in the list of endpoints. Click on it to view the endpoint details and take note of the Client ID and Client Secret strings for use in the next step. Also fill in the Redirect URL field with the Redirect URL displayed on your Blink ServiceNow integration page.
3. Generate and install your Webhook Secret and Auth IDs.
Head to your ServiceNow config page in Blink and complete the form, filling in the URL of your service-now instance along with the Client ID and Client Secret strings from ServiceNow, as generated in step 2 then click Connect
Two additional fields will now appear called Auth ID and Webhook Secret, make a note of them.
In ServiceNow navigate to System Properties, Categories, Blink and create two new system properties called blink.auth_id and blink.webhook_secret with the values you noted above.
They should look like this:
Once complete, you should have three Blink properties confirgured in total like the image below.
Congratutlations, you're all done.
Your employees will now be able to enable the ServiceNow integration, receiving alerts on new tickets and gaining the ability to mange them directly from the Blink Feed!
To test this feature, add ServiceNow as an integration to your feed, sign in with your regular user account and use a different account to assing a ticket to one of your ServiceNow assignment groups. You should immeditely receive a new feed item that you can action!