Home / Integration plugins / Aruba ClearPass SMS OTP Integration

+

Send SMS OTP codes from Aruba ClearPass

When a guest registers or a user signs in, ClearPass sends the code by SMS through SMSEagle, your own hardware SMS gateway. The request stays in your local network and never goes through a cloud SMS provider.

Notifications never touch a third party

ClearPass’s SMS Gateway page normally points at a cloud SMS handler. Set its Custom HTTP Handler to point 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 ClearPass 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 or auth event

A guest registers or a user authenticates through ClearPass, triggering an SMS notification.

2

Custom HTTP Handler call

ClearPass’s Custom HTTP Handler calls SMSEagle’s HTTP API, authenticated with HTTP Basic Authentication.

3

Message delivery

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

Set up in about 10 minutes

Paste the service URL in ClearPass, set Basic Authentication, and guest and login codes are sent by SMS.

SMSEagle sends ClearPass 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: guests and users 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 a guest received it.

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.

Aruba ClearPass configuration

All configuration related to SMS Gateway settings messages is done from the Home-> Configuration -> SMS Services -> Gateways page.
SMS Gateway Configuration page will be displayed.

In SMS Gateway field select Custom HTTP Handler:

and in the Service URL field paste our API request:

https://SMSEagle_IP/index.php/http_api/send_sms?login=@USERNAME@&pass=@PASSWORD@&to=@TO@&message=@MESSAGE_ENC@

where SMSEagle_IP is gateway’s IP address. Below in fields use:

  • Service Method select GET
  • Authentication Method select HTTP Basic Authentication
  • Service Username: put your username for SMSEagle user you just created
  • Service Password and Confirm Password: put your password for SMSEagle user you just created

Verification
Once the SMS gateway configuration is complete you can click on the Send SMS option under the gateway, enter a valid phone number and verify that the SMS is received.

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