LoginTC Integration Guide

Deployment Overview

LoginTC® provides cloud-based authentication through the RADIUS protocol.

This document describes how to integrate LoginTC two-factor authentication with a WatchGuard Firebox and the WatchGuard Mobile VPN with SSL client.

Integration Summary

The hardware and software used in this guide include:

  • WatchGuard Firebox
    • Fireware v12.8.1
  • LoginTC RADIUS Connector
    • Version 3.0.5
  • LoginTC Cloud
  • LoginTC Token
  • RADIUS Server

Test Topology

The Test Topology diagram

Before You Begin

Before you begin these procedures, make sure that you configure the user and client on the RADIUS server.

The user name on the RADIUS server must be the same as the user name in LoginTC Cloud and the WatchGuard Firebox.

Configure LoginTC Cloud

To configure LoginTC Cloud:

  1. Log in to LoginTC Cloud.

Screenshot of the LoginTC Cloud configure page

  1. Click Create Your First Domain.
    The Create Domain page opens.

Screenshot of the Create Domain page

  1. In the Name text box, type the domain name.
  2. In the Icon section, select an icon from the list, or to use a custom icon, select Upload from Computer.
  3. Click Create.

Screenshot of the Domain Created dialog box

  1. Click Create User.

Screenshot of the Users page

  1. Click Create Your First User.

Screenshot of the Create User page

  1. In the Personal Details section, type the Username, Name, and Email address of the user.
  2. Click Create.

Screenshot of the User Created dialog box

  1. Click Issue Token.

Screenshot of the WatchGuardEco Members page

  1. In the Actions column, click Issue Token.

Screenshot of the token

  1. Use the code in the Activation Code column to activate your token. For information on how to set up your token, see the Testing section in the LoginTC documentation.

Screenshot of the Token Provisioned dialog box

  1. Click Create Application.

Screenshot of the Create Application page

  1. Type WatchGuard in the filter.
  2. Select WatchGuard SSL VPN.


Screenshot of the Application Created dialog box

  1. Click Configure Connector.

Screenshot of the Configure Connector page

  1. Copy and save the Application ID and Application API Key to use when you configure the RADIUS connector.

Install LoginTC RADIUS Connector

For LoginTC RADIUS Connector installation instructions, see the Installation section in the LoginTC documentation.

After installation, you must:

  • Set the login Password.

  • Configure the IP Address.

Screenshot of the LoginTC Network Configuration page

  • Configure the DNS.

Screenshot of the LoginTC DNS Configuration page

  • Check that the Web Server starts.

Screenshot of the Web Server status page

To view the status of the configuration, select Status.

Screenshot of the LoginTC status page

Configure the RADIUS Connector

To configure the RADIUS Connector:

  1. Log in to LoginTC RADIUS Connector Web. The default user name is logintc-user.

Screenshot of the LoginTC radius connector login dialog box

Screenshot of the LoginTC Configurations page

  1. Click Create Your First Configuration.

Screenshot of the LoginTC Settings page

  1. In the Application ID text box, type the Application ID you copied previously in the Configure LoginTC Cloud steps.
  2. In the Application API Key text box, type the Application API Key you copied previously in the Configure LoginTC Cloud steps.
  3. Click Test.
    If the test is successful, a success message appears.
  4. Click Next.

Screenshot of the LoginTC First Factor page

  1. In the First Factor section, select the first authentication factor to use with LoginTC. In our example, we select RADIUS.
  2. In the Host text box, type the IP address of the RADIUS server.
  3. In the Port text box, type the port number that your RADIUS server uses for communication. The default is 1812.
  4. In the Secret text box, type the shared secret used by the RADIUS server and the LoginTC RADIUS Connector.
  5. Click Test.
    If the test is successful, a success message appears.
  6. Click Save.

Screenshot of the LoginTC Passthrough page

  1. To specify which users LoginTC challenges, select Static List.
  2. In the LoginTC Challenge Users text box, type one or more user names. In our example, we use EcoTest as our user.
  3. Click Next.

Screenshot of the LoginTC Client and Encryption page

  1. In the Name text box, type the name of the client.
  2. In the IP Address text box, type the IP address of the client IP address of the Firebox Trusted or Optional interface.
  3. In the Secret text box, type the shared secret used by the RADIUS client and the LoginTC RADIUS Connector.
  4. For the other options, do not change the default settings.
  5. Click Test.
    If the test is successful, a success message appears.
  6. Click Save.

Screenshot of the LoginTC test configurations page

Configure the WatchGuard Firebox

To configure your Firebox for RADIUS authentication:

  1. Log in to Fireware Web UI.

Screenshot of the Firebox Athentication Servers page

  1. Select Authentication > Servers > RADIUS.
  2. Click Add.

Screenshot of the Firebox Server Settings page

  1. In the Domain Name text box, type the domain name. In our example, we use FreeRadius.
  2. In the Primary Server Settings section, select Enable RADIUS Server.
  3. In the IP Address text box, type the IP address of the RADIUS server. In this guide, we use the IP address of the LoginTC Radius Connector.
  4. In the Shared Secret and Confirm Secret text boxes, type the shared secret used by the RADIUS client (Firebox) and the LoginTC RADIUS Connector.
  5. In the Timeout text box, type 30.
  6. For other options, do not change the default settings.
  7. Click Save.
  8. Select VPN > Mobile VPN.
  9. In the SSL section, click Configure.

Screenshot of the Firebox Mobile VPN with SSL Configure page

  1. Select the Activate Mobile VPN with SSL check box.
  2. In the Primary text box, type the IP address of your Firebox external interface.
  3. Select the Authentication tab.
  4. To make FreeRadius the default authentication server, select FreeRadius. Click Move Up.
  5. In the Users and Groups section, from the Create New drop-down list, select FreeRadius and User.
  6. Click Add.
    The Add User or Group dialog box opens.

Screenshot of the Add User or Group dialog box

  1. In the Name text box, type the user name.
  2. In the Description text box, type the description.
  3. From the Authentication Server drop-down list, select FreeRadius.
  4. Click Save.
    Your new user appears in the User and Groups list.

Screenshot of the Firebox Authentication Server Settings page

  1. Click Save.
  2. Select VPN > Mobile VPN.
    The Mobile VPN page opens.

Screenshot of the download client page

  1. To downland the Mobile VPN with SSL VPN client, in the SSL section, click Download Client.

Test the Integration

To test the integration:

  1. Install and open the Mobile VPN with SSL client.

Screenshot of the SSL VPN client login dialog box

  1. In the Server text box, type the FQDN or IP address of the Firebox external interface.
  2. In the User name text box, type the user name.
  3. In the Password text box, type the password.
  4. Click Connect.
    Your LoginTC token receives a push request.

Screenshot of the EcoTest dialog box

  1. Click Approve.
    You are connected successfully.