EventSentry SMS notifications – integration manual
Here we describe how to use SMSEagle for EventSentry SMS notifications.
See more about Eventsentry and SMSEagle also in this Eventsentry blog post.
SMSEagle is an offline hardware SMS gateway. Therefore no external connection to 3rd party system is required. All notifications are generated on-premise and sent directly to a cellular network. This solution can be used in secure installations without Internet access.
- Create a new user in SMSEagle (menu Users > + Add Users, user access level: “User”).
- Grant API access to the created user:
- click Access to API beside the newly created user
- Enable APIv1
- Generate new token
- Check “Enable user/password authentication”
- Add access permissions in section APIv1 Permission for: send_sms, send_tocontact, send_togroup
- Save settings
I. Create an EventSentry HTTP action and point it to your SMSEagle device
The HTTP action includes a number of templates to quickly load all required fields for a specific HTTP API. Select the SMSEagle from the Load template drop-down and specify all the required fields (host IP, user and password to SMSEagle, phone number). Use the test button to ensure the action is setup correctly.
Once the action is setup it can be referenced by one or more filters so that it is triggered under the right circumstances.
II. Setup SMS Notification and Test it
Assuming that you are already monitoring a host outside your network (e.g. your ISPs DNS server, a public web site) to determine whether your Internet connection is available or not, you would want to look for EventSentry event 11000, which indicates when a host changes its availability status, such as:
A filter setup for this event would look like something like this:
Here, we are looking for an application error generated by the Heartbeat Monitoring category of the EventSentry source. We’re also further restricting the filter to only alert us on status changes of the “ispdns” host when it goes off-line. Since the SMSEagle is listed as the action, this particular event (alert) will be sent to the SMSEagle action.
The insertion strings can be determined by either clicking on the “Lookup” button on the filter dialog, or by clicking on the “Preview” button when adding a content filter.