RCDevs OpenOTP SMS one-time passwords – integration manual

Here we describe how to setup RCDevs OpenOTP with SMSEagle for SMS one-time passwords.

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.

SMSEagle Setup

RCDevs OpenOTP uses HTTP API requests (see details: API). All you have to do at SMSEagle is to create new user for API access at webGUI.

  • 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 (copy it for later use)
    • Add access permissions in section APIv1 Permission for: send_sms, send_tocontact, send_togroup
    • Save settings

RCDevs OpenOTP Setup

1. Download script custom1.php from our repository: https://bitbucket.org/proximus/smseagle-rcdevs_openotp/src
Place the plugin in your OpenOTP/smsc directory.

  • it will be used as „Custom 1”, but if you already use it for other configuration, you can rename file to „customX.php” and than edit „smshub_custom1” in line 27 to „smshub_customX” where X is number from 2 to 4.

2. All configuration related to SMS Gateway settings messages is done from the  SMS Gateway configuration.

Configure with:

  • SMS Gateway and choose Custom1
  • SMSC Username is username for SMSEagle API user you just created.
  • SMSC Password is password for above user.
  • SMSC Custom Name fill with SMSEagle
  • SMSC URL or address: https://SMSEagle_IP
    • where SMSEagle_IP is IP address of your gateway

You must also define SMS as OTP token for every user in MFA application:

Have Questions?

SMSEagle devices are designed for easy setup. If you don't have a device yet, just buy your SMSEagle and get started with your integration. If you need technical assistance or have questions about our products, we’ll be happy to help you.