Step by Step Guide to implement SMS authentication to Juniper Networks SA SSL-VPN Serie
The complete installation guide for securing the authentication to your Juniper SSL VPN solution with Nordic Edge One Time Password Server, delivering strong authentication via SMS to your mobile phone.
1 Summary
This is a complete installation guide for securing the authentication to your Juniper SA SSL-VPN solution with Nordic Edge One Time Password Server, delivering two-factor authentication via SMS to your mobile phone. You will be able to test the product, with your current Juniper SA SSL-VPN solution and LDAP user database, without making changes affecting existing users. The guide will also allow you to make the installation efficiently, using a maximum of 1 hour. Nordic Edge provides several methods for delivering one time passwords, e-mail, tokens, mobile clients, Pledge, prefetch, Yubikey etc… However, in this guide, only SMS will be configured.
This guide covers the entire installation from A to Z. It is based on the scenario that you are running your Juniper SA SSL-VPN solution against Active Directory, and that you install the One Time Password Server on a Windows Server.
The One Time Password Server is platform independent and works with all other LDAP user databases, like eDirectory, Sun One, Open LDAP etc. If you are not running Windows and Active Directory and you have any questions regarding the slight differences in the installation process, you are most welcome to contact us at support@nordicedge.se and we lead you through the entire process.
Table of Contents
- Table of Contents
- 2 Prerequisites
- 3 Getting started
- 4 Installation
- 5 Configuring the One Time Password Server
- 5.1 Start the OTP Configurator
- Start the OTP Configurator by clicking on button – “Configuration”
- 5.2 Configure the One Time Password Server
- 5.3 Configure RADIUS
- 5.4 Configure databases
- 5.5 Configure LDAP Host Settings
- 5.6 Configure the LDAP database settings
- 5.7 Configure search filter
- 5.8 Test LDAP Authentication
- 6 Configure the SSL-VPN client settings.
- 7 Configure Delivery Method
- 8 Restart the One Time Password Server as Windows Service
- 9 Add mobile phone number with Microsoft Management Console
- 10 Configuring Juniper Secure Networks SA SSL-VPN
- 10.1 Add RADIUS Authentication Server
- 10.1.1 Custom Radius Authentication Rules
- 10.2 Sign in page
- 10.3 User Role
- 10.4 User Realm
- 10.5 Sign In Policy
- 10.6 Start testing
- 11 Purchase
- 12 Technical questions
Definitions
In this Step by Step guide the Juniper SA SSL-VPN is referred as "SSL-VPN Solution"
2 Prerequisites
You will need a server, for example a VMware virtual machine, with Windows Server 2003 or higher installed with Ethernet in bridge mode. The server must have a static ip-address configured and must also be able to reach your DNS-servers, your SSL-VPN solution and Active Directory. Since the software is quite small (315 mb) and easy to remove, you can also use any existing server from your network.
Important information regarding communication
The One Time Password Server is a software that can be installed on any existing server in your network or DMZ.
– The One Time Password Server must be able to communicate (Outbound traffic) with your LDAP or JDBC User Database. Default port for LDAP and Secure LDAP are TCP port 389 / 636.
– The SSL-VPN solution must be able to communicate (Outbound traffic) with the One Time Password Server via Radius, UDP port 1812 or 1645 (Outbound traffic).
– If you want to use the Nordic Edge SMS Gateway, the One Time Password Server must be able to communicate (Outbound traffic) with otp.nordicedge.net and otp.nordicedge.se with HTTPS on TCP port 443.
In the following test-scenario you will need to communicate with RADIUS port 1812 or 1645 and use the Nordic Edge SMS Gateway.
3 Getting started
3.1 Register and download the software
Go to www.nordicedge.net and click "PRODUCTS" and then "Downloads"
Type in your name and contact details to receive the software.
You will receive a link for downloading the software. A 30 days evaluation license will be sent via e-mail when you download the software.
Download the 32 or 64 bit version depending on your platform.
4 Installation
4.1 Start the installation
Start the installation on the server where you want to install the One Time Password Server
Please note that if you are installing on a Windows 2008 Server you need to right click on the otp3install.exe using explorer and select “Run as Administrator”.
Click Next
Click Next
Click Next
Click Next
Click Next
Click Next
Click Install
Click Next
Leave default on Yes and click “Done”
5 Configuring the One Time Password Server
5.1 Start the OTP Configurator
Start the OTP Configurator by clicking on button – “Configuration”
5.2 Configure the One Time Password Server
On the Server page you can set the length of the one time password and for how long it should be valid. Default is 5 minutes.
You can also set a default country prefix, which means you will not need to set it in the mobile attribute.
For more information regarding the optional setting please see One Time Password Server 3 – Administration manual
For now, leave this page as default and go on to the next part – Configure RADIUS.
5.3 Configure RADIUS
Change to the RADIUS tab and configure the RADIUS port you want to use to communicate with your SSL-VPN server. In this example we are using RADIUS port nb 1645.
Click Save config.
5.4 Configure databases
In this setup we are going to use the Microsoft Active Directory LDAP database.
Change to the Databases tab and click on the LDAP Database button.
5.5 Configure LDAP Host Settings
For this configuration we will use the active directory installed on the same server as the One Time Password Server. We will use the internal IP-address (127.0.0.1) as host address.
We will use the standard LDAP port No. 389 to communicate with Active Directory.
Admin DN will be the Administrator user to search for user objects in the Active Directory database. For now this user only need read rights to the user objects attributes but be aware that later you might want to use options like disable accounts or the Pledge Enrollment concept from the Pledge Mobile Client. In this event the Admin DN need write rights to modify the disable account attribute and to store oath-keys into an optional user attribute.
Configure your LDAP host settings and click test. You should now get a messages saying “LDAP connection success”
Next step is to configure the LDAP database settings.
5.6 Configure the LDAP database settings
The BASE DN is the search base from where OTPServer will start looking for user objects.
Click on the button with three dots at the right side of the Base DN field to browse your LDAP Database.
Select an Organization Unit or Organization in Active Directory and click OK.
5.7 Configure search filter
Next step is to configure the search filter for One Time Password to search users via selected object classes and attributes according to the Microsoft Active Directory schema.
Click on the “Sample Button” and choose the filter template for MS Active Directory and click OK twice.
5.8 Test LDAP Authentication
Click on the Test LDAP Authentication button and type in the userid of a user you know exist in the directory.
Type in the password
If configuration is correct you will see the following success message.
6 Configure the SSL-VPN client settings.
Since One Time Password Server is also a RADIUS-server, the Juniper SA SSL-VPN is considered a client to the One Time Password Server.
Next step is to configure the settings for this client.
In the left pane click on ”Clients”
Type in a name for your SSL-VPN server and the ipaddress to your SSL-VPN server.
Type in the RADIUS shared secret.
Choose the Active Directory you configured earlier as User Database.
Click Save
7 Configure Delivery Method
The Delivery Methods category is meant for enabling and configuring one or more delivery methods that can be used by the OTP Server to send one-time passwords.
One Time Password Server offers various methods like SMS, Oath Tokens, Instant Messaging, HTTP, Yubikey.
In this example we will use SMS with the Nordic Edge SMS-service as the SMS-provider.
During the evaluating phase we offer customers to use our Nordic Edge SMS-service free of charge for 30 days from the activation of the Demo Account.
In the left Pane, click “Delivery Methods” and then Nordic Edge SMS. In the right pane enable Nordic Edge SMS Gateway.
To Request a demo account click “Request a demo account”.
Click “Yes”
You should now get a success message and the Username and Password for the Nordic Edge SMS-gateway has automatically been filled in. Click OK and Save Config.
8 Restart the One Time Password Server as Windows Service
In the server panel for click “Shutdown”
In Windows Control Panel, open Administrative Tools / Services
Find the NordicEdge OTPServer Service, right click on that service and click “Start”.
9 Add mobile phone number with Microsoft Management Console
Add a mobile phone number to your test user mobile phone attribute by starting the Microsoft MMC, select the test user and enter the mobile phone number into the Mobile attribute.
10 Configuring Juniper Secure Networks SA SSL-VPN
10.1 Add RADIUS Authentication Server
Start the Juniper Secure Networks Secure Access SSL-VPN Central Manager.
Go to Authentication – Auth. Servers
–> New RADIUS Auth Server
Configure as below
10.1.1 Custom Radius Authentication Rules
Note that "Access Challenge” has to be added where the "Reply-Message" "matches the expression" "(.*)" and in that case shows ”show GENERIC LOGIN page”. This will present the OTP field for the user.
10.2 Sign in page
Create a Sign-in page
10.3 User Role
Create a user role so that users are allowed access.
Allow at least one. In the example below we allow "Web".
10.4 User Realm
Create a User Realm that uses the Authentication Server created in step 1 for
authentication.
Create a role mapping for the realm. Use the role created in 10.3.
When done, it should look like this
10.5 Sign In Policy
Create a Sign In Policy that uses the Sign-in Page from step 2 and the User Realm
from step 3.
Note that from the users’ perspective you can always configure the login-pages for both
graphics and text to suit your company.
10.6 Start testing
Go to your Juniper url and add that realm you have created. In this example juniper.nordicedge.se/test
Enter the user-id and password for the user that you have added your mobile number to.
You will receive a one time password to your mobile phone within a couple of seconds.
Enter your one time password and click on “Sign In”.
11 Purchase
If you want to purchase the product, you are more than welcome to contact us at e-mail sales: sales@nordicedge.se. phone: +46 8 122 07 500 fax: +46 8 122 07 508.
12 Technical questions
If you have any technical questions, please contact us at support@nordicedge.se
Thank you for showing interest in our product!
The Nordic Edge One Time Password Server Team
