I'd like to add a URL to our email template that allows the on-call personnel to acknowledge alarms without having to login to the web interface. This would be primarily used on mobile devices.
Last change on Feb 26, 2010 9:01:16 AM by
Is there a way to single-click acknowledge an alarm by adding a URL to the email template?
Votes:
2
Best Answer
Accepted Answer
Votes:
3
This is possible as of PRTG 7.3.2
As of 7.3.2 the %sensorid placeholder is supported, so we can now edit the HTML template and insert something like:
<div class="url"> <a href="http://192.168.1.2:8080/api/acknowledgealarm.htm?id=%sensorid&ackmsg=ok&username=admin&passhash=12345678"><h3>Acknowledge alarm</h3><a> </div>
The top section of the HTML template would than look like:
<!-- HTML Template per Notification BEGIN -->
<div class="head">
<b>%device</b>: %name %status %down (%message)
</div>
<div class="url">
<a href="http://192.168.1.2:8080/api/acknowledgealarm.htm?id=%sensorid&ackmsg=ok&username=admin&passhash=12345678"><h3>Acknowledge alarm</h3><a>
</div>
<div class="content">
You have to change the IP and portnumber to match your own PRTG installation. Also the username (admin) and passhash (12345678) are just for example purpose and have to be changed.
The user that receives the email is now presented with a link to acknowledge the alarm.
Last change on Jul 15, 2010 8:44:26 AM by
5 Replies
Accepted Answer
Votes:
3
This is possible as of PRTG 7.3.2
As of 7.3.2 the %sensorid placeholder is supported, so we can now edit the HTML template and insert something like:
<div class="url"> <a href="http://192.168.1.2:8080/api/acknowledgealarm.htm?id=%sensorid&ackmsg=ok&username=admin&passhash=12345678"><h3>Acknowledge alarm</h3><a> </div>
The top section of the HTML template would than look like:
<!-- HTML Template per Notification BEGIN -->
<div class="head">
<b>%device</b>: %name %status %down (%message)
</div>
<div class="url">
<a href="http://192.168.1.2:8080/api/acknowledgealarm.htm?id=%sensorid&ackmsg=ok&username=admin&passhash=12345678"><h3>Acknowledge alarm</h3><a>
</div>
<div class="content">
You have to change the IP and portnumber to match your own PRTG installation. Also the username (admin) and passhash (12345678) are just for example purpose and have to be changed.
The user that receives the email is now presented with a link to acknowledge the alarm.
Last change on Jul 15, 2010 8:44:26 AM by
Votes:
0
You guys are awesome. This addresses Adrian's concern because the API is stateless.
Last change on Jul 15, 2010 8:45:15 AM by
Votes:
1
HTML email template part 2, hide username and passhash
Adding the
http://192.168.1.2:8080/api/acknowledgealarm.htm?id=%sensorid&ackmsg=ok&username=admin&passhash=12345678
To the email template works ok, but leaves the user with the complete visible url in his browser, including the username and passhash. To hide the username and passhash, we can make things a little bit more complicated and pass our url to the checklogin.htm page.
Our basic url, (without username and passhash) now becomes the payload for the checklogin.htm and has to be url encoded. We do however want to leave the %sensorid placeholder intact, so let's break up the basic url into 3 pieces.
Basic url
http://192.168.1.2:8080/api/acknowledgealarm.htm?id= %sensorid &ackmsg=ok
The first and third line now need to be url encoded:
http%3a%2f%2f192.168.1.2%3a8080%2fapi%2facknowledgealarm.htm%3fid%3d %sensorid %26ackmsg%3dok
Putting it back together:
http%3a%2f%2f192.168.1.2%3a8080%2fapi%2facknowledgealarm.htm%3fid%3d%sensorid%26ackmsg%3dok
We now add this to the checklogin.htm and add our username and passhash:
http://192.168.1.2:8080/public/checklogin.htm?loginurl=http%3a%2f%2f192.168.1.2%3a8080%2fapi%2facknowledgealarm.htm%3fid%3d%sensorid%26ackmsg%3dok&login=admin&passhash=12345678
Making the top section of our email template look like this:
<!-- HTML Template per Notification BEGIN -->
<div class="head">
<b>%device</b>: %name %status %down (%message)
</div>
</div class="ull">
<a href= "http://192.168.1.2:8080/public/checklogin.htm?loginurl=http%3a%2f%2f192.168.1.2%3a8080%2fapi%2facknowledgealarm.htm%3fid%3d%sensorid%26ackmsg%3dok&login=admin&passhash=12345678"><h3>Acknowledge alarm 2</h3><a>
</div>
Our user is still presented with a link to acknowledge the alarm, but does not see the username and passhash in his browser anymore.
Url encoding can be done online by sites as: http://www.string-functions.com/urlencode.aspx
Last change on Jul 15, 2010 8:44:51 AM by
Votes:
0
Created on Jun 22, 2010 2:37:22 PM by
Disclaimer: The information in the Paessler Knowledge Base comes without warranty of any kind. Use at your own risk. Before applying any instructions please exercise proper system administrator housekeeping. You must make sure that a proper backup of all your data is available.
Add comment