On top of keeping the asset records and device hardware and software inventories up-to-date, integration of Miradore with ServiceNow offers a huge amount of possibilities to automate operative IT tasks. With automating preapproved installation requests in a service management tool, you can achieve significant savings in time, but also reach good end user satisfaction, without compromising the best practices in service delivery measuring.

This blog post is an example of triggering a software distribution using Miradore web service. Automation could then be taken further by launching a distribution when user request for a preapproved software installation is created in ServiceNow.

Time to get our hands dirty. First, create a Distribution operation. This is done by sending an HTTP POST message to Miradore web service URL: https://<server>/<instance>/connectors/rest.svc/Distribution (replace <server> and <instance> with the correct values from your environment).



Then in ServiceNow, define a REST Message, which uses Miradore web service.


${DeviceName}, ${PackageName} and ${User} are variables which must be declared when the REST Message is triggered. Notice also the Content-Type header which must be defined to use the Miradore web service.

The body of the message looks like the following:


To identify the target asset and package, you can use any attributes of those items. But make sure that the targets are identified uniquely.

Now, let’s test the message by inputting the required parameters. I want to distribute Adobe Reader to a computer and leave also an entry into event log of the distribution. I need to define the target device ({$DeviceName$}=TPC00280), the package I want to deploy ({$PackageName}= Adobe Reader 10.0.1~1), and the user who created the distribution ({$UserName}=my email address).


Run test:


Ok, I can see that something went wrong since Miradore web service responded with an error code 403. To see more details of the error, I can check the logs from Miradore server. I’ll go to my Miradore server, browse into the installation folder, and find the web service logs (default: c:Program FilesMiradoreServer<Miradore instancename>logsWebService). I open the latest of the server side logs and see that my web service user name or password is incorrect. This is the user account which I created in Miradore in order to use the web service API.


Let’s double check the settings in ServiceNow. I’ll write the password again (this time correctly) and update.


Let’s try again.


Yes, that was it! Now, I have triggered a software installation from ServiceNow to a computer managed by Miradore.


You can find more information about Miradore web service from the Miradore product guide (Administrators guide > Connectors > Web service):

Check out also our ServiceNow integration tutorial video.

Have fun integrating Miradore with ServiceNow! If you have any questions or comments, please email us at support@miradore.com.

Jere Jutila

Jere Jutila

Service Manager at Miradore Ltd
Jere Jutila, Services Manager, works in technical sales, customer training and consultation at Miradore. He has years of experience in IT operations management in a global enterprise environment with expertise in workstation infrastructure, administration, development and 3rd level support. | LinkedIn
Jere Jutila

Share Now

Share this post with your friends!