LoadMaster Duo Integration Guide

Updated: June 26, 2023 19:16

1 LoadMaster Duo Two Factor Authentication

In this guide we will configure Duo Push along with username and password validation through Active Directory to implement a two factor authentication for our sample application. In this example, the authentication used with the application server is Kerberos Constrained Delegation (KCD).

Once configured the user flow for accessing the application will look like this:

The flow is outlined below:

1. The user provides their username and password.

2. The LoadMaster queries the Duo RADIUS proxy for the user.

3. A connection to Duo Security is established.

4. An authentication request is sent to the user's Duo app.

5. The user validates the request on the app.

6. The LoadMaster performs pre-authentication using the supplied username and password with the Local Domain Controller.

7. Authentication is successful.

8. The resource is accessed through Kerberos Constrained Delegation.

1.1 Add an Application to Duo

First you must log in to the Duo Admin Panel and navigate to Applications > Protect an application. Click Radius. Then, follow the remaining steps in the sub-sections below.

RADIUS is the only required application that should be listed in the Duo Admin Panel.

1.1.1 Install Duo Auth Proxy on Linux

The following Duo guide outlines the steps on installing Duo Authentication Proxy: Authentication Proxy - Reference.

Below is an example configuration using CentOS with Wget installed:

yum install gcc make libffi-devel perl zlib-devel

wget https://dl.duosecurity.com/duoauthproxy-latest-src.tgz

tar xzf duoauthproxy-latest-src.tgz

cd duoauthproxy-5.1.1-7484191-src/

make

cd duoauthproxy-build/

./install

At this point step through the prompts, for example:

In what directory do you wish to install the Duo Authentication Proxy?

[/opt/duoauthproxy]

Enter the name of a user account under which the Authentication Proxy should be run. We recommend a non-privileged and locked down account.

Or you can press <Enter> and our default locked down user will be created for you:

[duo_authproxy_svc]

Enter the name of a group under which the Authentication Proxy logs will be readable. Or press <Enter> and a default group will be created for you:

[duo_authproxy_grp]

1.1.2 Create an Application in Duo

To create an application in Duo, follow these steps:

1. Log in to Duo and go to Dashboard > Applications > Protect an Application and search for radius.

2. Set the app Name and Users that can access the app.

3. Copy the values for:

- Integration key

- Secret key

- API hostname

1.1.3 Configure Duo Auth Proxy and Start

To configure the Duo auth proxy, you must modify the authproxy.cfg file. For example:

vi /opt/duoauthproxy/conf/authproxy.cfg

Below is an example configuration containing the details copied above in addition to the interface address of the LoadMaster which is the RADIUS Client (radius_ip_1) and the RADIUS shared secret to use (radius_secret_1).

The configuration file should contain the following:

[main]

debug=true

test_connectivity_on_startup=true

[duo_only_client]

[radius_server_auto]

ikey=DIS1YSDW3KSFRKLX2W1S

skey=eEqgB1BUP7dfasdasdasdhAPDZOSwLvLp

api_host=api-e0c2593d.duosecurity.com

radius_ip=10.1.151.61

radius_secret_1=Hummingbird

client=duo_only_client

port=1812

In the example above:

The radius_ip is the LoadMaster's IP address (or the shared IP address in a High Availability (HA) configuration).
The radius_secret_1 is a chosen password. This is required to be configured on the LoadMaster as the RADIUS Shared Secret in the SSO Domain configuration of the domain LDAPDUO which is mentioned below.

1.1.3.1 Add a Firewall Rule to Allow Inbound RADIUS

This may vary across Linux OSS:

firewall-cmd --add-service=radius --permanent

sudo firewall-cmd --reload

1.1.3.2 Start Duo Auth Proxy

Whenever changes are made the configuration you must stop and start the process.

[root@localhost log]# /opt/duoauthproxy/bin/authproxyctl start

Running The Duo Authentication Proxy Connectivity Tool. This may take several minutes...

[info] Testing section 'main' with configuration:

[info] {'debug’: ‘True’, test_connectivity_on_startup': 'true'}

[info] There are no configuration problems

[info] -----------------------------

[info] Testing section 'duo_only_client' with configuration:

[info] {‘debug’: ‘True’}

[info] There are no configuration problems

[info] -----------------------------

[info] Testing section 'radius_server_auto' with configuration:

[info] {'api_host': 'api-e0c2593d.duosecurity.com',

'client': 'duo_only_client',

'ikey': 'DIS1YSDW3KSFRKLX2W1S',

'port': '1812',

'radius_ip_1': '10.1.151.61',

'radius_secret_1': '*****',

'skey': '*****[40]'}

[info] There are no configuration problems

[info] -----------------------------

[info] Testing section 'main' with configuration:

[info] {‘debug’: ‘True’, 'test_connectivity_on_startup': 'true'}

[info] There are no connectivity problems with the section.

[info] -----------------------------

[info] Testing section 'duo_only_client' with configuration:

[info] {‘debug’: ‘True’}

[info] No testing to be done for section.

[info] -----------------------------

[info] Testing section 'radius_server_auto' with configuration:

[info] {'api_host': 'api-e0c2593d.duosecurity.com',

'client': 'duo_only_client',

'ikey': 'DIS1YSDW3KSFRKLX2W1S',

'port': '1812',

'radius_ip_1': '10.1.151.61',

'radius_secret_1': '*****',

'skey': '*****[40]'}

[info] The RADIUS Server has no connectivity problems.

[info] -----------------------------

[info] SUMMARY

[info] No issues detected

The results have also been logged in /opt/duoauthproxy/log/connectivity_tool.log

Checking updates for Duo Authentication Proxy...

[info] No updates detected. Your Duo Authentication Proxy is up to date.

1.1.4 Configure the LoadMaster

Create an SSO domain using LDAP and RADIUS. To do this, follow the steps below:

1. In the LoadMaster User Interface (UI), go to Certificates & Security > LDAP Configuration.

2. Specify the name of the LDAP endpoint configuration and click Add.

3. Configure the settings of the LDAP endpoint as needed.

4. In the LoadMaster UI, go to Virtual Services > Manage SSO.

5. Enter the name of the SSO configuration in the text box under Add new Client Side Configuration and click Add.

The LDAP server does not need to be the same as the RADIUS server. For example, it can be an LDAP Windows Server that is already used in the domain.

6. Select RADIUS and LDAP as the Authentication Protocol.

7. Select the relevant LDAP Endpoint.

8. Configure the other settings as needed.

The RADIUS Shared Secret should be the same as the one configured for radius_secret_1 as mentioned in the Configure Duo Auth Proxy and Start section.

9. In the LoadMaster UI, go to Virtual Services > View/Modify Services.

10. Click Modify on the relevant Virtual Service (or add a new one).

11. Expand the ESP Options section.

12. Select the Enable ESP check box.

13. Select the relevant SSO Domain.

14. Configure any other settings as needed.

Any Real Server can be added to this service now. There are no additional configuration or installation requirements needed on the Real Server.

1.2 Create the Duo Image Set

The default Dual Factor Authentication SSO Image Set contains two authentication fields for authentication:

For Duo, this image set should be edited to one field of user/password, because the second authentication is using the Duo RADIUS proxy for the authentication.

The image prompt has no other functionality other than to indicate that connection to Duo has been established successfully. When the DUO image displays after login, a notification on the mobile device should have been received.

In this example, the custom image form is modified to include just one Username and one Password input field and an image is added to indicate to the user that they must approve access (on their mobile device) in response to the initiated Duo push.

The image being displayed in this example is PhoneApprove.png and must be added to the custom image set manifest directory as described in the following section.

For details on how to modify a custom image set, refer to the following document: Custom Authentication Form Technical Note. The edits to the Dual Factor Authentication – Custom files are described in this document.

Two files must be modified: MANIFEST and lm_initial_dfa.html.

1.2.1 Add the Image Name to the Manifest

Add the image used to the manifest and include in the imageset/Duo directory, for example, PhoneApprove.png.

# Default manifest of all files that are part of the logon

# screens.

#ident "$Id: DFA.manifest 16042 2018-02-28 10:16:37Z phil $ "

# Format is "filename filetype".

# The first file is the initial login screen

# The second file is the logout screen.

lm_initial_dfa.html

lm_logout_dfa.html Text/html

lm_sso.js

espblank.gif

espbottom.gif

esptop.gif

favicon.ico

kmgerror.gif

kmgexleft.gif

kmgexlogo.gif

kmgexright.gif

kmgleft.gif

kmgright.gif

kmgstyle.css

PhoneApprove.png

When imagesets are created they exist within an imageset folder. Each specific imageset has its own folder within the imageset folder.

1.2.2 Modify lm_initial_dfa.html

1.2.2.1 Add JavaScript

Within the <head> portion of the page, add the following JavaScript to enable dynamic display of the Duo image and hiding of the button once credentials are entered.

Add:

function picture(){

var pic = "/lm_auth_proxy?LMimage=PhoneApprove.png"

document.getElementById('bigpic').src = pic.replace('90x90', '225x225');

document.getElementById('bigpic').style.display='block';

}

</script>

function hidebutton(button){

button.style.visibility = "hidden";

}

1.2.2.2 Edit Username

Replace:

With:

1.2.2.3 Remove remotecredsid

Remove the following section because there is no need for separate remote credentials:

<td class="nowrap"><label for="remotecreds"><b>Remote Credentials</b></label></td>

</tr>

1.2.2.4 Replace dpasscodeid

Replace :

<td class="nowrap"><label for="dpasscode">Passcode:</label></td>

</td>

</tr>

With :

</td>

</tr>

1.2.2.5 Remove interncredsid

Remove the second username field:

<td class="nowrap"><label for="interncreds"><b>Internal Credentials</b></label></td>

</tr>

1.2.2.6 Remove Displaying of the Internal Username

Remove displaying of the internal username because we will reuse a single username.

Replace:

<td class="nowrap"><label for="username">Internal Username:</label></td>

</td>

</tr>

With:

<tr id="userid" style="display:none"><td class="nowrap"><label for="username">Ignore Username:</label></td>

</td>

</tr>

This field is not being used. The first username is used for both RADIUS and LDAP authentication.

1.2.2.7 Update the Internal Password Field

Update the internal password field to simply call it password.

Replace:

<td class="nowrap"><label for="password">Internal Password:</label></td>

</td>

</tr>

With:

<td class="nowrap"><label for="password">Password:</label></td>

</td>

</tr>

1.2.2.8 Replace the Final Row

Replace :

<tr>

</td>

</tr>

With :

<tr>

</td>

</tr>

</tr>

1.2.2.9 Example of the Updated File

A complete example of an updated file is as follows:

<!DOCTYPE html>

<html>

<head>

<title>Kemp Login Screen</title>

body

{

font-family:Tahoma,Arial,Helvetica;

font-size:70%;

}

input, button

{

font-family:Tahoma,Arial,Helvetica;

}

.mid

{

font-size:70%;

}

input, button, label, table

{

font-size:100%;

}

</style>

var xx_msg10 = "Login Failed - The security service has blocked your request. Please contact your System Administrator.<br><br>";

var xx_msg11 = "Login Failed - Please make sure that both your remote and internal credentials are correct, and then try again.<br><br>";

</script>

function picture(){

var pic = "/lm_auth_proxy?LMimage=PhoneApprove.png"

document.getElementById('bigpic').src = pic.replace('90x90', '225x225');

document.getElementById('bigpic').style.display='block';

}

</script>

function hidebutton(button){

button.style.visibility = "hidden";

}

</script>

</head>

<tr>

<td style="width:100%">To use LoadMaster ESP Login, javascript must be enabled in your browser.</td>

</tr>

</table>

</div>

</noscript>

<tr>

</tr>

</table>

</td>

</tr>

<tr>

<tbody>

<tr>

</table>

</td>

</tr>

<span style="display:none" id="expired_msg">Your password has expired.</span>

<span style="display:none" id="exp_p_msg">Password will expire in </span>

<a id="reset_link" href="#">Click Here</a>

</td></tr>

</table>

</td>

</tr>

<tr>

</table>

</td>

</tr>

<tr>

<td>

<col>

<tbody>

</td><td class="align"><label for="pubr">This is a public or shared computer</label></td>

</tr>

</td><td class="align"><label for="pubp">This is a private computer</label></td>

</tr>

<td class="nowrap"><label for="dusername">Username:</label></td>

</td>

</tr>

</td>

</tr>

<td class="nowrap"><label for="username">Ignore Username:</label></td>

</td>

</tr>

<td class="nowrap"><label for="password">Password:</label></td>

</td>

</tr>

<tr>

</td>

</tr>

</tr>

</tbody>

</table>

</td>

</tr>

</tbody>

</table>

<tr>

<td class="tdConn" style="padding-top:0px;">Secured by LoadMaster</td>

</tr>

<tr>

</tr>

</table>

</td>

</tr>

<tr>

<tr>

</tr></table>

</td>

</tr>

</tbody>

</table>

</form>

</body>

</html>

<!DOCTYPE html>

<html>

<head>

<title>Kemp Login Screen</title>

body

{

font-family:Tahoma,Arial,Helvetica;

font-size:70%;

}

input, button

{

font-family:Tahoma,Arial,Helvetica;

}

.mid

{

font-size:70%;

}

input, button, label, table

{

font-size:100%;

}

</style>

var xx_msg10 = "Login Failed - The security service has blocked your request. Please contact your System Administrator.<br><br>";

var xx_msg11 = "Login Failed - Please make sure that both your remote and internal credentials are correct, and then try again.<br><br>";

</script>

function picture(){

var pic = "/lm_auth_proxy?LMimage=PhoneApprove.png"

document.getElementById('bigpic').src = pic.replace('90x90', '225x225');

document.getElementById('bigpic').style.display='block';

}

</script>

function hidebutton(button){

button.style.visibility = "hidden";

}

</script>

</head>

<tr>

<td style="width:100%">To use LoadMaster ESP Login, javascript must be enabled in your browser.</td>

</tr>

</table>

</div>

</noscript>

<tr>

</tr>

</table>

</td>

</tr>

<tr>

<tbody>

<tr>

</table>

</td>

</tr>

<span style="display:none" id="expired_msg">Your password has expired.</span>

<span style="display:none" id="exp_p_msg">Password will expire in </span>

<a id="reset_link" href="#">Click Here</a>

</td></tr>

</table>

</td>

</tr>

<tr>

</table>

</td>

</tr>

<tr>

<td>

<col>

<tbody>

</td><td class="align"><label for="pubr">This is a public or shared computer</label></td>

</tr>

</td><td class="align"><label for="pubp">This is a private computer</label></td>

</tr>

<td class="nowrap"><label for="dusername">Username:</label></td>

</td>

</tr>

</td>

</tr>

<tr id="userid" style="display:none"><td class="nowrap"><label for="username">Ignore Username:</label></td>

</td>

</tr>

<td class="nowrap"><label for="password">Password:</label></td>

</td>

</tr>

<tr>

</td>

</tr>

</tr>

</tbody>

</table>

</td>

</tr>

</tbody>

</table>

<tr>

<td class="tdConn" style="padding-top:0px;">Secured by LoadMaster</td>

</tr>

<tr>

</tr>

</table>

</td>

</tr>

<tr>

<tr>

</tr></table>

</td>

</tr>

</tbody>

</table>

</form>

</body>

</html>

2 References

For further details, refer to the following Duo document: Authentication Proxy - Reference.

Last Updated Date

This document was last updated on 01 March 2023.

Download PDF File

Was this article helpful?

1 out of 1 found this helpful

Kemp Support, how can we help?

LoadMaster Duo Integration Guide

Contents

1 LoadMaster Duo Two Factor Authentication

1.1 Add an Application to Duo

1.1.1 Install Duo Auth Proxy on Linux

1.1.2 Create an Application in Duo

1.1.3 Configure Duo Auth Proxy and Start

1.1.3.1 Add a Firewall Rule to Allow Inbound RADIUS

1.1.3.2 Start Duo Auth Proxy

1.1.4 Configure the LoadMaster

1.2 Create the Duo Image Set

1.2.1 Add the Image Name to the Manifest

1.2.2 Modify lm_initial_dfa.html

1.2.2.1 Add JavaScript

1.2.2.2 Edit Username

1.2.2.3 Remove remotecredsid

1.2.2.4 Replace dpasscodeid

1.2.2.5 Remove interncredsid

1.2.2.6 Remove Displaying of the Internal Username

1.2.2.7 Update the Internal Password Field

1.2.2.8 Replace the Final Row

1.2.2.9 Example of the Updated File

2 References

Last Updated Date

Comments

In this document

Kemp Resources