External Authentication with Cisco ASA Authenticating Users Using SecurAccess Server by SecurEnvoy

External Authentication with Cisco ASA

Authenticating Users Using SecurAccess Server by

SecurEnvoy

Phil Underwood [email protected]

Tony Davis [email protected]

Cisco ASA Integration Guide

This document describes how to integrate a Cisco ASA with SecurEnvoy two-factor Authentication solution called ‘SecurAccess’.

Cisco ASA provides Secure Remote Access and Firewalling to the internal corporate network.

SecurAccess provides two-factor, strong authentication for remote Access solutions (such as Cisco), without the complication of deploying hardware tokens or smartcards.

Two-Factor authentication is provided by the use of (your PIN and your Phone to receive the one time passcode)

SecurAccess is designed as an easy to deploy and use technology. It integrates directly into any LDAP server and negates the need for additional User Security databases. SecurAccess consists of two core elements: a Radius Server and Authentication server. The Authentication server is directly integrated with LDAP in real time.

SecurEnvoy Security Server can be configured in such a way that it can use the existing LDAP password. Utilising the LDAP password as the PIN, allows the User to enter their UserID, Domain password and One Time Passcode received upon their mobile phone. This authentication request is passed via the Radius protocol to the SecurEnvoy Radius server where it carries out a Two-Factor authentication. It provides a seemless login into the Windows Server environment by entering three pieces of information. SecurEnvoy utilises a web GUI for configuration, as does the Cisco ASA (ASDM). All notes within this integration guide refer to this type of approach.

The equipment used for the integration process is listed below: Cisco

Cisco Adaptive Security Appliance Software Version 9.1(3) Device Manager Version 7.1(4)

Cisco Anyconnect Mobile Client 3.1.03103

SecurEnvoy

Windows 2012 R2 Server

IIS installed with SSL certificate (required for management and remote administration) Active Directory installed or connection to Active Directory via LDAP protocol.

Index

1.0 Prerequisites ... 3

1.1 Configuration of Cisco AAA server ... 4

1.2 Configuration of Cisco ASA VPN configuration ... 5

2.0 Configuration of SecurEnvoy - PIN configuration ... 5

2.1 Configuration of SecurEnvoy - RADIUS configuration ... 5

3.0 Cisco AnyConnect VPN Client Configuration ... 7

4.0 Test logon SSL ... 7

4.1 Test logon AnyConnect Client ... 8

4.2 Configuration of OneSwipe(Optional)... 9

4.3 User Experience - OneSwipe ... 10

5.0 Troubleshooting RADIUS connection ... 11 1.0 Prerequisites

It is assumed that the Cisco ASA has been installed and is authenticating VPN users with a username and password.

Securenvoy Security Server has been installed with the Radius service and has a suitable account that has read and write privileges to the Active Directory. If firewalls are between the SecurEnvoy Security server, Active Directory servers, and the Routing and Remote Access server(s), additional open ports will be required.

NOTE: Add radius profiles for each Cisco ASA that requires Two-Factor Authentication. The following table shows what token types are supported.

Token Type Supported

Real Time SMS or Email



_

_

_



_

1.1 Configuration of Cisco AAA server

Launch the Cisco Adaptive Security Device Manager (ASDM), select Configuration in top toolbar, navigate to AAA setup, go to AAA server Groups and click ADD.

Enter name details and select the Radius protocol, set max failed attempts to 3.

Click Ok when completed.

Navigate to AAA setup, go to AAA server and click ADD.

Enter details for interface, IP address of SecurEnvoy server. Set port to 1812 (this is the default port of SecurEnvoy Radius)

Enter Server Secret Key.

1.2 Configuration of Cisco ASA VPN configuration

Within the ASDM, navigate to the Remote Access VPN. Then select the existing profile you wish to change. In this example the AnyConnect Connection profile was selected.

Within the AnyConnect profile, change the AA server group to be the AA group that was configured earlier.

Click OK when complete.

Apply all changes to make the configuration active.

2.0 Configuration of SecurEnvoy - PIN configuration

To help facilitate an easy to use environment, SecurEnvoy can utilise the existing LDAP password as the PIN. This allows the users to only remember their Domain password. SecurEnvoy supplies the second factor of authentication, which is the dynamic one time passcode (OTP) which is sent to the user’s mobile phone via SMS, email or use a Soft Token. Launch the SecurEnvoy admin interface, by executing the Local Security Server

Administration link on the SecurEnvoy Security Server. Click “Config”

Select Windows – Microsoft Password is the PIN under PIN Management This will now use the users existing password as the PIN.

Click “Update” to confirm the changes

2.1 Configuration of SecurEnvoy - RADIUS configuration

Click the “Radius” Button

Click “New” then enter IP address and Shared secret for each Cisco ASA that wishes to use

Make sure that “Prompt all passcodes in the same way as Real Time Codes” is ticked.

If required Group membership can be achieved

SecurEnvoy RADIUS can respond with LDAP group membership via Radius return attribute 3076-223.

Click “Update” to confirm settings. Click “Logout” when finished. This will log out of the Administrative session.

NOTE SecurEnvoy RADIUS has the ability to send Privilege level access by returning Radius Privilege-Level 220 attribute to an ASA.

SecurEnvoy can search any LDAP attribute and respond with the data that is contained in that attribute.

To set this up, first choose an LDAP attribute and populate with the correct data. This example uses “pager”.

In this example the LDAP attribute Pager is used. It is then populated with 15 for level 15 access.

Please see Cisco ASA reference guide for more information.

Within the Radius set, provide a unique number and then the VendorID, 3076-220. Then select LDAP and type in the name of the LDAP attribute, this example uses “pager”. Click “Update” when complete.

Cisco Attribute Name Attribute Syntax Value

3.0 Cisco AnyConnect VPN Client Configuration

The VPN client does not require any changes, if it was working by using a username and password it will now work with SecurEnvoy Two Factor authentication.

4.0 Test logon SSL

Once the configuration has been saved, the connection can be initiated by navigating to the configured URL.

In this example

Https://server.securenvoy.com

User then enters existing Domain User ID and Domain password. User is then prompted to enter a 6 digit

passcode. This can be obtained from SMS, Email, Soft Token etc.

Click “continue” to complete the logon.

NOTE If a user is setup for Voice Call, the user enters User ID and password as described

previously, but will then the following prompt will be displayed.

4.1 Test logon AnyConnect Client

User then enters existing Domain User ID and Domain password.

Click “OK” to continue.

User is then prompted to enter a 6 digit passcode. This can be obtained from SMS, Email, Soft Token etc.

Click “Continue” to complete the logon.

NOTE If a user is setup for Voice Call, the user enters User ID and password as described

previously, but will then the following prompt will be displayed. The users’ phone will then receive a voice

call; user then follows the prompt and enters the displayed passcode via the phone keypad.

4.2 Configuration of OneSwipe (Optional)

Customise the SSL WebVPN portal with OneSwipe-specific details: Configuration >> Remote Access VPN >> Clientless SSL VPN Access >> Portal >> Customization

Highlight DfltCustomization and click Edit and select Title Panel from the Logon Page menu

In the Text box, enter the following HTML code:

SSL VPN Service <img src="/+CSCOU+/oneswipe.gif" onclick="se_oneswipe_click()" onload="var button = document.getElementsByName('Login')[0];button.id =

'Login';se_oneswipe_username='username';se_oneswipe_pin='password';se_oneswipe_passc ode='secondary_password';se_oneswipe_submit='Login';">

<div id="se_oneswipe_status"></div>

<canvas id="se_oneswipe_canvas" width="400" height="300" style="display:none"></canvas>

<div id="outdiv"></div>

<script type="text/javascript" src="/+CSCOU+/oneswipe.js"></script>

Click OK and then click Web Contents from the Portal menu. Select Import and import the oneswipe.gif and oneswipe.js files from the link below into the default web contents folder. For each file, select the option stating that no authentication is required.

4.3 User Experience - OneSwipe

Select ‘Swipe’ from the phone Soft Token

Enter your PIN /Password into the PIN / Password field and click ‘Done’.

Browse to ASA Clientless SSL WebVPN portal

Click on the “OneSwipe” button and scan the QR code using your webcam. UserID, password and passcode are passed to the Cisco ASA

User is presented with Cisco Web Portal

5.0 Troubleshooting RADIUS connection

Navigate to AAA setup, go to AAA server, select the SecurEnvoy AAA server and “Test authentication” Enter Domain UserID in username field and domain password; click “OK” to continue.

User is then prompted to enter a 6 digit passcode.

Click OK