Home / Integration plugins / Cisco ISE SMS OTP Integration

+

Send SMS OTP codes from Cisco ISE

When a guest registers through the Cisco ISE Sponsor portal, their login details are sent by SMS through SMSEagle, your own hardware SMS gateway. The request stays in your local network, with no cloud SMS provider.

Notifications never touch a third party

Cisco ISE’s SMS Gateway Provider page normally points at a cloud SMS API. Point it at SMSEagle instead: the request stays on your local network and the message is sent from your own device over the cellular network.

Works in isolated and air-gapped networks

Cloud SMS gateways need outbound internet access from your ISE deployment. SMSEagle sends messages on-premises over its own cellular connection, delivering guest and authentication SMS even in fully offline installations.

Predictable cost, no vendor dependency

Cloud SMS delivery is billed per message, which adds up fast for guest portal traffic. SMSEagle sends over a standard SIM at local carrier rates – no per-message fees, no external contract.

How it works

1

Guest registration

A guest registers through the Sponsor portal, and their phone number is captured automatically.

2

SMS HTTP API call

Cisco ISE’s SMS Gateway calls SMSEagle’s API directly, with the phone number and message filled in from the URL template.

3

Message delivery

SMSEagle delivers the code over its own cellular connection, not through a third-party service, as an SMS to the guest’s phone.

Set up in about 10 minutes

Paste the API URL in Cisco ISE and save, and guest and login codes are sent by SMS.

SMSEagle sends Cisco ISE guest and login codes by SMS from your own device, with no cloud SMS provider.

Works on any phone

An SMS code needs no app: people receive it on any mobile phone.

Every code sent is recorded

SMSEagle records every code it sends, together with its status, so you can check whether it was received.

Logins work even if one device fails

Two SMSEagle devices can work as an HA cluster: if one fails, the other takes over sending codes.

SMSEagle configuration

  1. Create a new user in SMSEagle (menu System > Users) with access level “User”.
  2. Grant API access to the created user:
    • go to Settings > Global settings > API and open the API v1 page
    • click Create API key, fill in Key name and select that user as Owner
    • Add access permissions in section Permissions for: Send SMS, Send to contact, Send to group
    • click Create key. Then, in System > Users, open that user and tick Enable user/password authentication (APIv1 only).
  3. Open Settings > Global settings > Network > SSL, turn off Forward HTTP to HTTPS and click Save changes.

 

Cisco ISE configuration

All configuration related to SMS Gateway settings messages is done from the System -> Settings -> SMS Gateway page.

SMS Gateway Provider page will be displayed.

Select:

  • SMS HTTP API

and in the URL field paste our API request:

http://SMSEagle_IP/index.php/http_api/send_sms?login=john&pass=doe&to=$mobilenumber$&message=$message$

where SMSEagle_IP is gateway’s IP address and  login and pass are username and password for SMSEagle user you just created.

Some important notes:

  • The username and password to the SMSEagle must be included in this link (unfortunately, clear text is used).
  • The mobile number is taken automatically from the Phone number field during the guest creation exercise from the Sponsor portal.
  • The message field is filled automatically from this location: Sponsor portal > Portal Page Customization > Notify Guests > SMS notification > Message text.

Explore SMSEagle Demo device

SMSEagle is a hardware & software solution that guarantees a swift delivery of your messages to designated recipients, whether it’s for notifications, alerts, or important updates.

After registering to a demo you get a remote access to our physical device NXS-9750.

  • 14-days free trial
  • Access to over 20 functionalities

What is hardware
SMS Gateway?

Learn more about
SMSEagle features