Call : +48 796 200 723 / Mail : hello(at)smseagle.eu

Network Monitoring Systems & Authentication Systems integration

Here we provide ready-to-use solutions for sms notifications in most popular monitoring & authetication systems. If you need help in integrating other system (not listed here), just go ahead and Contact us.

Click on the name to jump to your system:

image

Nagios, Icinga, Shinken | Paessler PRTG | RSA Authentication Manager | Zabbix | Zenoss

Nagios, Icinga, Shinken sms notifications - integration manual

Here we describe how to setup Nagios (and Nagios based NMS) with SMSEagle for sms notifications. It should take you about 5 min to have it up and running.

This tutorial is also available on: Nagios website


SMSEagle Setup

Create a new user for this script in SMSEagle. This user will be referenced below as: SMSEAGLEUSER and SMSEAGLEPASSWORD
Replace SMSEAGLEUSER and SMSEAGLEPASSWORD in script below with your values.


Nagios Setup

1. Download latest version of the script notify_eagle_sms.pl from our repository: https://bitbucket.org/proximus/smseagle-nagios
Place the plugin in your Nagios (Icinga, Shinken) plugins directory.

2. Create the SMS notification commands (commonly found in file commands.cfg).
Replace SMSEAGLEIP with IP Address of your SMSEagle device.
Replace SMSEAGLEUSER and SMSEAGLEPASSWORD with your user/password to SMSEagle.

Define two commands:

define command { 
command_name notify-by-sms 
command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEIP -u SMSEAGLEUSER -p SMSEAGLEPASSWORD -d $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $SERVICESTATE$ $SERVICEDESC$ Host($HOSTNAME$) Info($SERVICEOUTPUT$) Date($SHORTDATETIME$)" 
} 

define command { 
command_name host-notify-by-sms 
command_line $USER1$/notify_eagle_sms.pl -s SMSEAGLEIP -u SMSEAGLEUSER -p SMSEAGLEPASSWORD -d $CONTACTPAGER$ -t "$NOTIFICATIONTYPE$ $HOSTSTATE$ Host($HOSTALIAS$) Info($HOSTOUTPUT$) Time($SHORTDATETIME$)" 
} 
            

3. In your Nagios (Icinga, Shinken) contacts (commonly found in file contacts.cfg) add the contact. Field "pager" should contain a mobile number for sms alerts in full international format without leading + sign, for example: 48xxxxxxxxx (if your mobile operator requires + sign in a telephone number put 00 instead)

define contact { 
contact_name engineer 
alias Support Engineer 
service_notification_period 24x7 
host_notification_period 24x7 
service_notification_options w,u,c,r 
host_notification_options d,u,r 
service_notification_commands notify-by-email,notify-by-sms 
host_notification_commands host-notify-by-email,host-notify-by-sms 
email engineer@somedomain.com 
pager 48xxxxxxxx 
} 
                

Paessler PRTG - integration manual

Here we describe how to use SMSEagle for Paessler PRTG sms notifications.


SMSEagle Setup

Create a new user in SMSEagle.


PRTG Setup

I. Setup Notification Delivery settings

1. In the PRTG web interface, open Setup > System Administration > Notification Delivery Settings

prtg sms notifications

2. In the SMS Delivery section

  • Set Configuration Mode to: Enter a custom URL for a provider not listed
  • Set Custom URL to:
    http://url-of-smseagle/index.php/http_api/prtg_sms?login=username&pass=password&to=%SMSNUMBER&message=%SMSTEXT

    In the string above replace:
    • url-of-smseagle with IP Address of your SMSEagle device
    • username with username you created in Step: SMSEagle Setup.
    • password with password you created in Step: SMSEagle Setup.

3. Save your settings

II. Setup SMS Notification and Test it

1. In the PRTG web interface, open Setup > Account Settings > Notifications

2. Click on the Add new notification button

prtg sms notifications

  • In the Send SMS/Pager Message section, enter the Recipient Number.
    The number should be in internal format, without leading + sign, for example: 44555123456 for a DE mobile number (if your mobile operator requires + sign in a telephone number put 00 instead).
  • You can leave the default Message
  • Save your settings

3. Test:
In the list of all notifications, click on the Test button next to your new SMS notification to initiate a test SMS.
You should receive an SMS text message on the number you just entered.

Note: Test messages still contain unresolved variable names.

RSA Authentication Manager

rsa_ready
SMSEagle device has been certified to use with RSA Authentication Manager. It has passed the official RSA certification process and has been granted to use “RSA Ready” certification sign.

RSA Authentication Manager can be configured to utilize SMSEagle for delivery of on-demand tokencodes to be used in on-demand authentications. When a user authenticates to an agent using his/her username and on-demand PIN, the RSA Authentication Manager sends the on-demand tokencode and mobile number to SMSEagle using the HTTP protocol. SMSEagle then delivers the on-demand tokencode to the user’s mobile device via SMS.

See configuration manual for RSA Authentication Manager: Proximus_SMSEagle1_2_HTTPPlug-In.pdf

See also SMSEagle entry in EMC Solutions Gallery: https://gallery.emc.com/docs/DOC-2823

Zabbix sms alerts - integration manual

Here we describe how to use SMSEagle for Zabbix sms alerts.

Reference: Zabbix Wiki


SMSEagle Setup

Create a new user for this script in SMSEagle.


Zabbix Setup

1. Download latest version of Zabbix script from our repository: https://bitbucket.org/proximus/smseagle-zabbix

2. Edit following lines in the script:

//Set the following three values:
$smseagle_ip     = "192.168.0.102";
$login           = "smseagleuser";
$password        = "smseaglepassword";
            

3. Put the script in the directory, you specified in the zabbix_server.conf, key AlertScriptsPath:
#Location for custom alert scripts AlertScriptsPath=/etc/zabbix/alertscripts
and make sure that it's executable (chmod 755 cli_smseagle.php).

4. Test the script, by running:
./cli_smseagle.php 48601765432 "Test message"

5. In Zabbix goto Administration > Media Types and add a New Media called cli_smseagle.php, and choose that it's a script, and enter the filename cli_smseagle.php as the script name.

6. Finally, in Zabbix Administration > Users click on a user, and add a New Media called cli_smseagle.php. Enter their phone number, and press Save.

Zenoss sms alerts - integration manual

Here we describe how to use SMSEagle for Zenoss sms alerts.


SMSEagle Setup

Create a new user for this script in SMSEagle.


Zenoss Setup

1. Download latest version of the script zenoss_smseagle.py from our repository: https://bitbucket.org/proximus/smseagle-zenoss

2. Edit following lines in the script:

SMSEAGLE_USER = "john"
SMSEAGLE_PASSWORD = "doe"
SMSEAGLE_IP = "192.168.0.101"            
Save the script to the location: [ZENDIR]/bin/zenoss_smseagle.py (where [ZENDIR] is your Zenoss directory). Ensure that it's executable (chmod 755 zenoss_smseagle.py).

3. Add a cell phone number to the "Pager" field of each Zenoss user account.

4. Go to Advanced->Settings and modify the "Page Command" to: $ZENHOME/bin/zenoss_smseagle.py $RECIPIENT

5. When finished, test by using the "test" link next to the cell number shown in the Pager column of each user.

6. If testing is successful (a SMS message is received at the cell phone) create alerts in Zenoss and specify "page" as the action for an alert.