Two factor authentication

kklosson

I had posted a query on implementation of MFA and there was an interesting response. The post disappeared - maybe support had to restore the forum from a backup or something. The responder mentioned that AwareSoft had a plugin for a third-party SMS service. I'll need a repeat on that please.

hpl123

Hi kklosson,
I think it was ACDC or Rocketrod that wrote about the SMS module. It´s the Clickatell SMS module and search the forums or ask support about more info. I have it myself (have the module but haven´t started to use it yet so can´t tell you how well it works) and it´s very straight forward and works exactly like email i.e. as an outgoing channel.

I am also interested in this whole thing so I can rewrite my post. I have used/worked with RSA secureid before and works great. I have thought about creating a custom security solution in my application where I use "printed security codes" i.e. random codes Aware IM creates which the user prints out and use as the 2nd authentication factor. I haven't thought about how this should be implemented and how Aware IM store/secure the codes etc. but that´s probably not a hard thing achieve.

Another (or 2 other) option is using email/SMS where Aware IM sends out an email/SMS with the 2nd authentification factor code and the SMS solution is possible the ideal but then it´s SMS rate cost + there have to be some form of verification of number etc. but these things are also probably not very hard to achieve.

Please keep up posted on how/what you do and if you get to a good/working solution. Thanks

kklosson

Many thanks. My needs for security are very high and I will be walking this road with diligence. I'll keep you posted.

hpl123

Great, thanks.

ACDC

kklosson,
I use the Aim clickatell plug-in to message users of events that take place in my App. You can use this to implement two factor authentication. I have not implemented this yet, but its on my to-do list and seems very easy. I am also keen to implement bi directional sms interaction i.e. respond to sms reply that was sent by My app - something like an sms question and then based on the reply start a process etc etc , but let me not digress!

When you sign up for an account with Clickatell they are very good at sending out updates on the latest trends and concepts of how sms can be used and how to implement the concept in your system

I recently received this link from them on two factor authentication which might interest you - also check the video out

https://www.clickatell.com/get-creative-with-sms/two-factor-authentication/?cid=208583

Please let me know how you progress

ACDC

by the way, as far as the cost of sms goes, the prices are very reasonable. Also I charge my customers for the service. If they wish to raise the level of security there is a cost to them. I handle this by way of a prepaid account.

Incidentally I did note in the Clickatell documentation somewhere that it would be possible to develop a front end in your app that lets your customer (user) handle their own prepaid account directly with Clickatell. So this would save you the admin of maintaining things

kklosson

Excellent stuff. I will query AwareSoft about the plugin.

hpl123

ACDC wrote
kklosson,
I use the Aim clickatell plug-in to message users of events that take place in my App. You can use this to implement two factor authentication. I have not implemented this yet, but its on my to-do list and seems very easy. I am also keen to implement bi directional sms interaction i.e. respond to sms reply that was sent by My app - something like an sms question and then based on the reply start a process etc etc , but let me not digress!

When you sign up for an account with Clickatell they are very good at sending out updates on the latest trends and concepts of how sms can be used and how to implement the concept in your system

I recently received this link from them on two factor authentication which might interest you - also check the video out

https://www.clickatell.com/get-creative-with-sms/two-factor-authentication/?cid=208583

Please let me know how you progress

Yeah, great stuff ACDC. I was wondering regarding the bi-directional sms you write about. I am currently investigating this exact thing for a potential project and I have talked some to Himanshu who has implemented this through Twilio. Twilio does unfortunately not cover all the countries I am interested in but Clicktell does so next on my todo regarding this potential project is actually investigating how I could get this working with Clickatell. Have you got any idea on how hard this implementation would be and if the existing Clicktell module can be built upon or reconfigured to also support bi-directional?

PS: Regarding SMS delivery etc., am I right when I assume it works as it should, reliably etc. since you only write you use it and not that you use it and it kinda works 🙂 ?

Thanks

ACDC

The current plugin sends SMS only, and yes it does work as it should.

With regards to SMS "responding" you will have to get support to enhance the current plug in to support the call back response.

Alternatively you could attempt to do this yourself using the call back url they offer and pointing the call back to your app to run a process on receipt of the call back notification. I THINK the call back option could work - but don't take my word for it.

Also if you wish to know more, spend some time on their developer network, there is a wealth of technical development info there. Also they are the largest and most successful SMS gateway out there, so they claim

hpl123

Thanks ACDC. I will look into this some more.

hpl123

Kklosson,

Thinking about security and I have used Incapsula for site protection and works great and I thought about looking into also using the service for app security.

http://www.incapsula.com

I will probably not look into this right now (maybe in the future) but thought this could be of interest to you.

jannes

I'm currently implementing two-factor authentication (2FA) in AwareIM for a back-office user. The step to send a verification code via SMS is already working using Bulkgate. Here's the process I'm using:

CREATE SMSRequest WITH SMSRequest.Request='{
  `application_id`: `' + SystemSettings.SMSApplicationID + '`,
  `application_token`: `' + SystemSettings.SMSKey + '`,
  `number`: `' + BackofficeUser.TelNrMobiel + '`,
  `text`: `Your verification code is: ' + BackofficeUser.Code2FA + '`,
  `sender_id`: `gText`,
  `sender_id_value`: `PolderSoft`,
  `unicode`: true,
  `country`: `NL`
}'

To generate a number : GENERATE_PWD(6,6,0,6,0)

Question:
What are the recommended steps to properly integrate this into AwareIM’s login process?

Specifically, I want to:
Let the user first log in with username and password
Then show an additional screen to enter the verification code
Only grant access after the correct code is entered
Are there any best practices or examples of how to implement this properly within AwareIM?
Should I use a temporary object, a custom login form, a session variable, or something else?

Any advice or example implementations would be greatly appreciated!

Thanks in advance,
Jannes

hpl123

jannes
I am no security or 2FA expert but I can tell you what I remember from how I set it up (was a while ago and not using it any longer). I had a intermediary VP that handled the SMS code entry i.e each user logged into their account and then the user got redirected to an empty VP that only had the SMS code form. The user typed in code and then if correct, the user was redirected to his main VP. I also had a (cumbersome but still) mechanism for added security where I as part of the login process changed accesslevel of the user so I had for example AdminLimited and AdminFull and AdminLimited only had access to the temporary SMS code BO and all else was blocked (via accesslevel settings and protection rules). When the correct code was added, the users accesslevel was changed to AdminFull. I also had various rules etc. here and there to change the access level back to AdminLimited after the user had logged out. Cumbersome and not perfect from a security standpoint by a long shot but still more secure than not using it. Today we have a lot more options etc. in Aware so there are probably better ways to do this now.

rbross

Mark Bailey uses 2FA for his app. Also Peter Tran did a demo at one of the user conferences. You might want to reach out to one of them about what they are using.
I would try Mark first.

jannes

Hi ,

I just wanted to share that I’ve successfully implemented two-factor authentication (2FA) in AwareIM. 🎉

After the user logs in with their username and password, they are presented with a custom HTML form to enter a 2FA code.
The user can choose to receive this code via SMS (using BulkGate.com) or email, depending on their preference.
Only after entering the correct code is the main Visual Perspective shown.

If anyone is looking to set up something similar, I’m happy to share more details.

Best regards,
Jannes

Jaymer

Great Jannes

1) yes, please provide the specifics on how you’re handling User Access levels, changing VPs, etc.
Henrik’s method posted above seemed a bit intricate per his description.
So please elaborate.

Jaymer

@jannes are you going to be able to describe how you did this?

jannes

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>2FA Implementation in AwareIM</title>
  <style>
    body {
      font-family: Arial, sans-serif;
      margin: 2em;
      line-height: 1.6;
      background: #f9f9f9;
      color: #333;
    }
    h1, h2, h3 {
      color: #005288;
    }
    code {
      background: #eee;
      padding: 2px 4px;
      font-family: Consolas, monospace;
    }
    pre {
      background: #eee;
      padding: 1em;
      overflow-x: auto;
    }
    .section {
      margin-bottom: 2em;
    }
  </style>
</head>
<body>
  <h1>2FA Implementation in AwareIM (SMS & Email)</h1>


<h1>🔐 Summary: Two-Factor Authentication (2FA) Implementation in AwareIM</h1>

  <p>I’ve implemented a flexible 2FA system in AwareIM that supports both <strong>SMS</strong> and <strong>email</strong> verification, based on a system-wide setting. Below is a short overview of the setup.</p>

  <h2>⚙️ Configuration</h2>
  <p>The 2FA method is defined in the <code>SystemSettings.Method2FA</code> attribute with the following options:</p>
  <ul>
    <li><code>SMS</code></li>
    <li><code>Email</code></li>
    <li><code>not available</code></li>
  </ul>

  <h2>📦 Business Objects</h2>
  <ul>
    <li><strong>Login2FA</strong>: stores the generated code (<code>Code2FA</code>) and user input (<code>Code2FAInput</code>), with a reference to <code>ps_BackofficeUser</code></li>
    <li><strong>SMSService</strong>: handles REST call to <a href="https://portal.bulkgate.com" target="_blank">BulkGate API</a></li>
    <li><strong>SMSRequest</strong> and <strong>SMSResponse</strong>: support request and response data</li>
  </ul>
  
  <h2>🔁 Process Flow</h2>

  <h3>Process: Initialise</h3>
  <p>Called during user login or session startup. Checks which 2FA method is active and starts <code>SendSMS</code> or <code>SendEmail</code> accordingly.</p>
  <div class="section">
    <pre><code>IF SystemSettings.Method2FA='SMS'
   AND SystemSettings.SMSKey IS DEFINED
   AND LoggedInBackofficeUser.TelNrMobiel IS DEFINED THEN
   DISPLAY PERSPECTIVE Login2FA
   SendSMS
ELSE IF SystemSettings.Method2FA='Email'
   AND SystemSettings.ps_Template2FA IS DEFINED
   AND LoggedInBackofficeUser.EmailAddress IS DEFINED THEN
   DISPLAY PERSPECTIVE Login2FA
   SendEmail</code></pre>
  </div>

  <h3>Process: SendSMS</h3>
  <ul>
    <li>Creates a <code>Login2FA</code> record and generates a 6-digit code</li>
    <li>Sends the code using a REST call to BulkGate</li>
    <li>Displays a custom HTML form to enter the code</li>
  </ul>

  <div class="section">
    <pre><code>CREATE Login2FA WITH ps_BackofficeUser=LoggedInBackofficeUser,
  Code2FA=GENERATE_PWD(6,6,0,6,0), Code2FAInput=''

CREATE SMSRequest WITH SMSRequest.Request='{
  `application_id`: `' + SystemSettings.SMSApplicationID + '`,
  `application_token`: `' + SystemSettings.SMSKey + '`,
  `number`: `' + LoggedInBackofficeUser.TelNrMobiel + '`,
  `text`: `Your verificationcode : ' + Login2FA.Code2FA + '`,
  `sender_id`: `system_number`,
  `unicode`: true,
  `country`: `NL`
}'

REQUEST SERVICE SendLoginCode OF SMSService
VIEW Login2FA USING HTML</code></pre>
  </div>


  <h3>Process: SendEmail</h3>
  <ul>
    <li>Same logic as SMS, but sends the code via email using a predefined template</li>
  </ul>

  <div class="section">
    <pre><code>CREATE Login2FA WITH ps_BackofficeUser=LoggedInBackofficeUser,
  Code2FA=GENERATE_PWD(6,6,0,6,0), Code2FAInput=''

FIND Templates WHERE Templates=SystemSettings.ps_Template2FA TAKE BEST 1

CREATE OutgoingEmail WITH SentToAddress=LoggedInBackofficeUser.EmailAddress,
  Subject=Templates.Subject, Message=Templates.Message

CREATE OutboundEmail WITH FromAddress=SystemSettings.OutgoingEmailFromAddress,
  Subject=OutgoingEmail.Subject, Message=OutgoingEmail.Message

SEND OutboundEmail TO LoggedInBackofficeUser
VIEW Login2FA USING HTML</code></pre>
  </div>

  <h3>Process: Check2FA</h3>
  <ul>
    <li>Compares user input to the generated code</li>
    <li>If incorrect, shows an error and clears the input</li>
    <li>If valid, displays the target perspective (e.g., <code>Administrator</code>)</li>
  </ul>

  <div class="section">
    <pre><code>IF SystemSettings.Method2FA IN 'SMS', 'Email'
   AND LoggedInSystemUser.AccessLevel IN 'Administrator', 'BackendUser'
   AND (Login2FA.Code2FA &lt;&gt; Login2FA.Code2FAInput OR Login2FA.Code2FAInput IS UNDEFINED) THEN
   DISPLAY MESSAGE 'Wrong verification code. Please try again.'
   Login2FA.Code2FAInput=''
ELSE
   DISPLAY PERSPECTIVE Administrator</code></pre>
  </div>

  <h2>📜 HTML Input Form</h2>
  <pre><code>&lt;input class="aw-mapped" type="text" maxlength="6" placeholder="e.g., 123456" aw_attr_id="101"&gt;
&lt;button class="btn aw-selected aw-mapped" type="submit" aw_oper_id="4"&gt;Verify&lt;/button&gt;</code></pre>


  <div class="section">
    <h2>HTML Form (Login2FA)</h2>
    <pre><code>&lt;html lang="nl"&gt;
  &lt;head&gt;
    &lt;meta charset="UTF-8"&gt;
    &lt;meta name="viewport" content="width=device-width, initial-scale=1.0"&gt;
    &lt;title&gt;2FA Verification&lt;/title&gt;
  &lt;/head&gt;
  &lt;body&gt;
    &lt;div class="box"&gt;
      &lt;h2&gt;Enter verification code&lt;/h2&gt;
      &lt;form class="form-control"&gt;
        &lt;input class="aw-mapped" type="text" maxlength="6" placeholder="e.g., 123456" aw_attr_id="101"&gt;
        &lt;br&gt;
        &lt;button class="btn aw-selected aw-mapped" type="submit" aw_oper_id="4"&gt;Verify&lt;/button&gt;
      &lt;/form&gt;
    &lt;/div&gt;
  &lt;/body&gt;
&lt;/html&gt;</code></pre>
  </div>

<h2>✅ Result</h2>
  <p>
    This approach provides:
    <ul>
      <li>Flexible control via system settings</li>
      <li>External SMS integration using REST</li>
      <li>A simple and user-friendly HTML interface</li>
    </ul>
  </p>

</body>
</html>

jannes

🔐 Summary: Two-Factor Authentication (2FA) Implementation in AwareIM

I’ve implemented a flexible 2FA system in AwareIM that supports both SMS and email verification, based on a system-wide setting. Below is a short overview of the setup.

This approach provides:

Flexible control via system settings
External SMS integration using REST
A simple and user-friendly HTML interface

⚙️ Configuration

The 2FA method is defined in the SystemSettings.Method2FA attribute with the following options:

SMS
Email
not available

—

📦 Business Objects

Login2FA: stores the generated code (Code2FA) and user input (Code2FAInput), with a reference to ps_BackofficeUser
SMSService: handles REST call to BulkGate API
SMSRequest and SMSResponse: support request and response data

—

🔁 Process Flow

1. Initialise

Called during user login or session startup. Checks which 2FA method is active and starts SendSMS or SendEmail accordingly.

IF SystemSettings.Method2FA='SMS' 
   AND SystemSettings.SMSKey IS DEFINED 
   AND LoggedInBackofficeUser.TelNrMobiel IS DEFINED THEN
   DISPLAY PERSPECTIVE Login2FA
   SendSMS
ELSE IF SystemSettings.Method2FA='Email' 
   AND SystemSettings.ps_Template2FA IS DEFINED
   AND LoggedInBackofficeUser.EmailAddress IS DEFINED THEN
   DISPLAY PERSPECTIVE Login2FA
   SendEmail

2. SendSMS

Creates a Login2FA record and generates a 6-digit code
Sends the code using a REST call to BulkGate
Displays a custom HTML form to enter the code

CREATE Login2FA WITH 
    ps_BackofficeUser=LoggedInBackofficeUser, 
    Code2FA=GENERATE_PWD(6,6,0,6,0),
    Code2FAInput=''

CREATE SMSRequest WITH SMSRequest.Request='{
  `application_id`: `' + SystemSettings.SMSApplicationID + '`,
  `application_token`: `' + SystemSettings.SMSKey + '`,
  `number`: `' + LoggedInBackofficeUser.TelNrMobiel + '`,
  `text`: `Je verificatiecode is: ' + Login2FA.Code2FA + '`,
  `sender_id`: `system_number`,
  `unicode`: true,
  `country`: `NL`
}'

REQUEST SERVICE SendLoginCode OF SMSService
VIEW Login2FA USING HTML

3. SendEmail

Same logic as SMS, but sends the code via email using a predefined template

CREATE Login2FA WITH 
    ps_BackofficeUser=LoggedInBackofficeUser, 
    Code2FA=GENERATE_PWD(6,6,0,6,0),
    Code2FAInput=''

FIND Templates WHERE Templates=SystemSettings.ps_Template2FA TAKE BEST 1

CREATE OutgoingEmail WITH 
    SentToAddress=LoggedInBackofficeUser.EmailAddress,
    Subject=Templates.Subject,
    Message=Templates.Message

CREATE OutboundEmail WITH 
    FromAddress=SystemSettings.OutgoingEmailFromAddress,
    Subject=OutgoingEmail.Subject,
    Message=OutgoingEmail.Message

SEND OutboundEmail TO LoggedInBackofficeUser
VIEW Login2FA USING HTML

4. Check2FA

Compares user input to the generated code
If incorrect, shows an error and clears the input
If valid, displays the target perspective (e.g., Administrator)

IF SystemSettings.Method2FA IN 'SMS', 'Email'
   AND LoggedInSystemUser.AccessLevel IN 'Administrator', 'BackendUser'
   AND (Login2FA.Code2FA<>Login2FA.Code2FAInput OR Code2FAInput IS UNDEFINED) THEN
   DISPLAY MESSAGE 'Wrong verification code. Please try again.'
   Login2FA.Code2FAInput=''
ELSE
   DISPLAY PERSPECTIVE Administrator

📜 HTML Input Form

<html>
  <body>
    <div class="box">
      <h2>Enter verification code</h2>
      <form class="form-control">
        <input class="aw-mapped" type="text" maxlength="6" placeholder="e.g., 123456" aw_attr_id="101">
        <br>
        <button class="btn aw-selected aw-mapped" type="submit" aw_oper_id="4">Verify</button>
      </form>
    </div>
  </body>
</html>