Learn F5 Technologies, Get Answers & Share Community Solutions Join DevCentral

Filter by:
  • Solution
  • Technology
Clear all filters
code share

Send an One Time Password (OTP) via the MessageBird SMS gateway

Problem this snippet solves:

This snippet makes it possible to send an One Time Password (OTP) via the MessageBird SMS gateway. This snippet uses iRuleLX and the node.js messagebird package to interact with the MessageBird API.

How to use this snippet:

Prepare the BIG-IP

  • Provision the BIG-IP with iRuleLX.
  • Create LX Workspace: messagebird
  • Add iRule: messagebird_irule
  • Add Extension: messagebird_extension
  • Add LX Plugin: messagebird_plugin -> From Workspace: messagebird

Install the node.js messagebird module

# cd /var/ilx/workspaces/Common/messagebird/extensions/messagebird_extension
# npm install messagebird --save  
messagebird@2.1.4 node_modules/messagebird


To make it works, you need to install the irule on the Virtual Server that publish your application with APM authentication.

access profile

If you already have an existing access profile, you will need to modify it and include some additionnal configuration in your VPE. If you have no access profile, you can starts building your own based on the description we provide below.

Configuring the Visual Policy Editor

The printscreen below is a minimal Visual Policy Editor used to make MessageBird OTP Authentication works properly :

Image Text

Irule Event – MessageBird

This is an irule event with the ID set to ‘MessageBird’. This will trigger the messagebird_irule to come into action.

MessageBird Status

This is an empty action with two branches. The branch named "successful" contains the following expression : expr { [mcget {session.custom.messagebird.status}] contains "successful" }

Message Box

This is a message box that will inform the user that there was a failure sending the One Time Password.


### Name   : messagebird_irule
### Author : Niels van Sluis, <niels@van-sluis.nl>
### Version: 20180721.001
### Date   : 2018-07-21

    if { [ACCESS::policy agent_id ] eq "MessageBird" } {

        # Set MessageBird access key    
        set accessKey "<ACCESS_KEY>"

        # Set user-friendly message which will be send prior to the OTP itself
        set message "Your OTP is: "

        # Set username used for logging purposes only
        set username "[ACCESS::session data get session.logon.last.username]"

        # Set OTP generated by BIG-IP APM which will be added to the SMS message.
        set generatedOTP "[ACCESS::session data get session.otp.assigned.val]"

        # Set phonenumber to send the SMS to
        set telephoneNumber "[ACCESS::session data get session.ad.last.attr.telephoneNumber]"

        # Set the sender of the message. This can be a telephone number (including country code) or an alphanumeric string.
        # In case of an alphanumeric string, the maximum length is 11 characters.
        set sender "MessageBird"

        if {[info exists username] && ($username eq "")} {
            log local0. "Error: username variable is empty; no OTP sent."

        if {[info exists generatedOTP] && ($generatedOTP eq "")} {
            log local0. "Error: generatedOTP variable is empty; no OTP sent for user $username."

        if {([info exists telephoneNumber] && $telephoneNumber eq "")} {
            log local0. "Error: telephoneNumber variable is empty; no OTP sent for user $username."

        set rpc_handle [ ILX::init messagebird_plugin messagebird_extension ]
        if {[ catch { ILX::call $rpc_handle sendOTP $generatedOTP $telephoneNumber $sender $message $accessKey } result ] } {
            log local0. "sendOTP failed for telephoneNumber: $telephoneNumber, ILX failure: $result"

        log local0. "MessageBird status for user $username ($telephoneNumber): $result"
        ACCESS::session data set session.custom.messagebird.status $result
Tested on Version:
Comments on this Snippet
Comment made 08-Mar-2018 by Manuel Cristobal 73

Hi Niels, very useful information but I am trying to use Twilio instead of MessageBird as it is a customer's requirement.

Do you know how/where can I get the node.js for Twilio?

I have found this link but it looks confusing to me. Do I have to build the node.js or can i download it and install it in the F5?


Much appreciated

Also.. could you please paste the APM policy a little bigger? It is hard to read and follow



Comment made 09-Mar-2018 by Niels van Sluis 2744

Hi Manuel,

See here, a new snippet that will get you going.


And about the APM policy picture, try using the 'zoom' function of your browser. The details are in there.

Kind regards,


Comment made 09-Mar-2018 by Manuel Cristobal 73

Very much appreciated ...

This information will help for sure.

Regards Manuel