Configure Push Login with OpenOTP
  Download PDF

1. Background

This document describes how to set up Push Login infrastructure, using WebADM, OpenOTP Push Server and optionally WAProxy.

OpenOTP is the RCDevs MFA Service running on top of the RCDevs WebADM platform. OpenOTP itself is composed of several server applications and components that provide secure and reliable authentication of users connecting to applications, online services, intranet, extranet just to name a few. OpenOTP relies on proven technologies and open standards, such as OATH (the initiative for open authentication), HOTP / TOTP / OCRA, Radius, LDAP.

WAProxy is an HTTP(S) reverse proxy for WebADM. While any reverse proxy should be able to fill the role, WAProxy is pre-configured to work securely with all the features of WebADM and thereby is recommended. WAProxy handles basic load balancing, failover and both server and client certificate setup with the least possible amount of configuration effort.

Push Server for OpenOTP Token is a service provided by RCDevs. This service is free for RCDevs customers with an Enterprise Licence. Those using a freeware OpenOTP license (limited to 40 users) must create a free push server account at the following link RCDevs Push Registration.

For more information about RCDevs OpenOTP, please refer to documents at RCDevs OpenOTP.

For more information about RCDevs WAProxy, please refer to documents at RCDevs WAProxy.

2. Deployment Scenarios

Scenario 1

Scenario 2

Scenario 3

3. Installation of Required Components

For installation and basic configuration of WebADM, OpenOTP and WAProxy, please refer to manuals available at RCDevs Documentation.

4. Deployment Scenarios Described

Scenario 1: This scenario includes RCDevs WAProxy on DMZ, avoiding WebADM/OpenOTP servers to be exposed on the Internet. This setup is recommended as being the most secure of the three options.

Scenario 2: This is a relatively simple setup with no reverse proxy at all. WebADM/OpenOTP are exposed to the Internet and communicate directly with Push Servers and with end-users’ mobiles. This scenario is recommended for testing purposes.

Scenario 3: This scenario is similar to Scenario 1, however with the possibility of using an existing Internet-facing Web server as web reverse proxy, rather than WAProxy. You can install RCDevs sample proxy script on your existing web server and this script will act as a reverse proxy as to your WebADM/OpenOTP servers.

The RCDevs sample proxy script can be found on your WebADM installation.

/opt/webadm/websrvs/openotp/doc/token_proxy.php

Note

Please note that your web server have to support PHP and CURL.

5. Scenario 1: WebADM Configuration & WAProxy

This chapter describes the configuration of Scenario 1. The chapter assumes you have a working WAProxy already in place. If you do not have WAProxy yet set up, please refer to WAProxy installation and configuration manuals at http://www.rcdevs.com/downloads/documents/.

Once your WAProxy is ready, go to your WebADM server to set up the communication to work between your WebADM and WAProxy.

Edit the file /opt/webadm/conf/webadm.conf

Find the section with WAProxy configuration and edit it:

# Private WAProxy IP who will contact the WebADM server 
waproxy_proxies "192.168.3.150"  

# The public DNS name of your WAProxy server
waproxy_pubaddr "wa.yorcdevs.com"  

After editing webadm.conf file, restart WebADM services:

service webadm restart 

After that, log in on WebADM GUI as Administrator.

Now, for each application available in WebADM, you should see a new option named Proxy WebSrv which appears in the products configuration pages.

When this option is activated for a given application, the application will then become available and accessible through your public WAProxy.

For example, to publish WebADM Self-Desk application:

Go to Self-Desk configuration settings and enable WAProxy WebApp as depicted in the picture below.

screenshot

Save changes. Go to your WAProxy server URL and you should see your Self-Desk there published.

screenshot

6. Scenario 2: WebADM/OpenOTP in DMZ

If your WebADM/OpenOTP servers are already exposed on the internet, or if you simply like to test Push Login, then you do not need to deploy a WAProxy server or the RCDevs Mobile Proxy Script. The URL your phone will contact upon receiving a push notification will simply be the URL of your WebADM/OpenOTP server(s). So there are no configurations needed for this scenario. However, note that the Mobile URL Endpoint setting in Chapter 8 must be configured as follows:

https://webadm.yorcdevs.com/ws/openotp/

Where webadm.yorcdevs.com is a public URL of your WebADM server accessible from the Internet.

7. Scenario 3: Mobile Proxy Script

The mobile proxy script must be used when your WebADM/OpenOTP servers are not exposed on the Internet and when WAProxy is not used. This sample PHP script must be placed on a web server already exposed on the Internet.

Configure your Apache, or similar web platform capable of supporting PHP, deploy the proxy script and define the URL that will be called by the mobile in the OpenOTP configuration.

Important

You must change the default start pages of your WebServer to “token_proxy.php”. Or you must simply rename “token_proxy.php” to “index.php”, if “index.php” is one of your default start pages.

Edit the Mobile Proxy Script and configure your WebADM/OpenOTP backends servers:

### My 1st WebADM Server 
$endpoint_url = "https://192.168.3.54/ws/openotp/"    

### My 2nd WebADM Server
$failover_url = "https://192.168.3.55/ws/openotp/"    

These are the URLs to which your Web server and Mobile Proxy Script will forward the mobile response to, the same manner as WAProxy would.

8. OpenOTP Configuration & Push Servers

This chapter describes how to configure WebADM/OpenOTP to connect with RCDevs Push Servers.

Please note that Push server option is only available since WebADM 1.5.3.

To configure OpenOTP with Push Server, you need to go to WebADM web interface and select Application tab, under which you should select the CONFIGURE link under “MFA Authentication Server”.

On the following page go to Mobile Push section, where you can enable Mobile Push and configure the Mobile EndPoint URL. This is the URL contacted by mobile and thereby must be accessible from the internet.

screenshot

Note

The /ws/openotp/ at the end of the URL is default for WAProxy (scenario 1).

If you are setting up scenario 2 then set the address of your WebADM server, i.e: https://webadmserver.mycompagny.com/ws/openotp/.

/ws/openotp/ is default URL for WebADM/OpenOTP sitting in DMZ.

If you are setting up scenario 3 then set URL to point to where you installed Mobile Proxy Script.

The last step is to configure push server location to WebADM. This is done in /opt/webadm/conf/servers.xml.

	<PushServer name="Push Server"
			host="91.134.128.157"
			port=“7000“
			user=""
			password=""
			ca_file"" />

Note

Customers with RCDevs Enterprise Licence will not need to set user & password. Those with a freeware license must register for a push server account at RCDevs Push Registration to obtain the credentials. The activation of a newly-created push server account can take up to one hour.

9. OpenOTP Token Enrolment with User Self-Services

At this point your configuration is complete and you are ready to start enrolling OpenOTP Token. This chapter describes enrolling OpenOTP Token from the User Self-Service Desk application, available on your WebADM server.

OpenOTP Token is currently available on App Store for iPhone and on Google Play for Android.

Here we describe User Self-Service Desk accessed through a WAProxy (Scenario 1). The methodology is, however, the same for all three scenarios.

Note

Also, note that user enrolment can be run directly through the WebADM administrator interface.

Logon in to User Self-Service Desk:

Once inside, click on OTP application menu and Register Token:

Choose the option QRCode-based. You can then choose between time-based or event-based.

Always prefer time-based if you are unsure which to choose. Open the OpenOTP Token mobile application, scan the QRCode.

Important

You must be connected to the Internet with your smartphone to enroll your OpenOTP Token.

Alert

If you end up with a screen like below, it’s probably because your smartphone cannot communicate with the configured Mobile End Point URL (configured in chapter 8). Check both your mobile internet connectivity and Mobile End Point URL.


Otherwise, your OpenOTP Token will be automatically enrolled and ready for use! You should also see your Token enrolled within the User Self-Service Desk.

10. Enforcing Simple-Push Login & Testing

You can enforce simple-push login (one-tap access with approve/deny) for one single user, for a group of users, for all your users, or for a given application/device (see WebADM Client Policies). In this example, we enable simple-push login for a one individual user.

Go to WebADM GUI interface and click on the user that you like to configure for push notification. In object details, click on CONFIGURE WebADM Settings, then choose the OpenOTP Application.

screenshot

Find the Token Features section (like in the picture below). Enable Simple-Push Login.

screenshot

Save changes and go back to the User Self-Service Desk to test the push login.

In User Self-Service, choose Test Login. A push notification should appear in your Smartphone, similar to picture below:

Click on Approve and authentication should complete successfully!

11. Video Demonstration


Play Video on Youtube