PowerFolder Integration with AuthPoint

Deployment Overview

This document describes how to set up AuthPoint multi-factor authentication (MFA) for Active Directory users.

PowerFolder must already be configured and deployed before you set up MFA with AuthPoint.

Integration Summary

The hardware and software used in this guide include:

  • PowerFolder Server v14.11.100.20
  • AuthPoint Gateway v5.3.1.184 or higher
  • Windows Server 2016 with Microsoft Network Policy Server (NPS) and Active Directory Domain Services

PowerFolder Configuration for RADIUS Authentication

AuthPoint communicates with various cloud-based services and service providers with the RADIUS protocol. This diagram shows an overview of the configuration required for RADIUS authentication.

The topology diagram

Before You Begin

Before you begin these procedures, make sure that:

  • You have installed and configured Active Directory Domain Services
  • You have installed Network Policy and Access Services, which includes Network Policy Server (NPS)

Configure Microsoft NPS Server

To enable users synced from Active Directory to successfully authenticate with MS-CHAPv2, you must configure Microsoft Network Policy Server (NPS). NPS is required to validate the user credentials from MS-CHAPv2 RADIUS requests against Active Directory.

You must register NPS in the Active Directory domain.

For instructions to configure Active Directory Domain Services, see the Microsoft documentation for Active Directory.

  1. On the Windows server, run Server Manager.
  2. Select Tools > Network Policy Server.
    The Network Policy Server console appears.
  3. Select RADIUS Clients and Servers > RADIUS Clients.
  4. Right-click RADIUS Clients and select New.
    The New RADIUS Client window appears.
  5. In the Friendly name text box, type a name.
  6. In the Address (IP or DNS) text box, type the IP address of the AuthPoint Gateway. In our example, the IP address of the AuthPoint Gateway is 192.168.100.20.
  7. In the Shared secret and Confirm shared secret text boxes, type a shared secret key. This key is used to communicate with the RADIUS server (AuthPoint Gateway).

    You must use the same shared secret key when you configure your PowerFolder in the PowerFolder Integration with AuthPoint section and your RADIUS client resource in the Add a RADIUS Client Resource in AuthPoint section.

  8. Screen shot of nps, picture1

  9. Click OK.
  10. Screen shot of nps, picture 2

  11. Select Polices > Connection Request Policies. Make sure the default policy is enabled.
  12. Screen shot of nps, picture 3

  13. Right-click Network Policies and select New.
    The New Network Policy window appears.
  14. In the Policy Name text box, type a name for this policy. In our example, we type ecotest.
  15. Click Next.
  16. In the Specify Conditions section, click Add.
  17. Select User Groups. Click Add > Add Groups.
  18. In the Enter the object name to select text box, type the group name. The name of this group must match the name of the Active Directory group your users belong to.
  19. Click OK.
  20. Click OK.
  21. Click Next.
  22. Click Next.
  23. In the Configure Authentication Methods section, clear the User can change password after it has expired check box.
  24. Click Next.
  25. Click Next.
  26. Click Next.
  27. Click Finish.
  28. Right-click NPS (Local) and select Register server in Active Directory.
  29. Click OK.
  30. Click OK.

Configure PowerFolder

  1. Log in to the PowerFolder Server web UI as an admin at http://<PowerFolder Server host name or IP address:8080>.
  2. Click Preferences.
  3. For Authentication, click Configure.
    The Edit Authentication Preferences page appears.
  4. Select the Authentication order tab.
  5. Move RADIUS and Database from the Inactive authentication methods section to the Active authentication methods section.

Screenshot of RADIUS and Database set as active authentication methods.

  1. Select the RADIUS tab.
  2. From the RADIUS drop-down list, select MSCHAPV2.
  3. In the Hostname text box, type the IP address and port of the AuthPoint Gateway. In our example, the IP address of the AuthPoint Gateway is 192.168.100.20 and the default port is 1812.
  4. In the Shared secret text box, type a shared secret key. This is the password that the RADIUS server (AuthPoint Gateway) and the RADIUS client (PowerFolder) will use to communicate.

Screenshot of the RADIUS settings.

  1. Click Save.

Configure AuthPoint

Before AuthPoint can receive authentication requests from the PowerFolder, you must add a RADIUS client resource for PowerFolder in AuthPoint. You must also assign an access policy for the PowerFolder resource to the user group(s) that must authenticate and you must bind the PowerFolder resource to the AuthPoint Gateway.

Add a RADIUS Client Resource in AuthPoint

From the AuthPoint management UI:

  1. From the navigation menu, select Resources.
  2. From the Choose a Resource Type drop-down list, select RADIUS Client. Click Add Resource.

  1. In the Name text box, type a descriptive name for the resource.
  2. In the RADIUS client trusted IP or FQDN text box, type the IP address that your RADIUS client uses to send RADIUS packets to the AuthPoint Gateway.
  3. From the Value sent for RADIUS attribute 11 (Filter-Id) drop-down list, you can choose to send the user's AuthPoint group or the user's Active Directory groups.
  4. In the Shared Secret text box, type the shared secret key that you specified in the Configure Microsoft NPS Server and PowerFolder Integration with AuthPoint section. This is the password that the RADIUS server (AuthPoint Gateway) and the RADIUS client (PowerFolder) will use to communicate.
  5. To configure the RADIUS client resource to accept MS-CHAPv2 authentication requests, click the Enable MS-CHAPv2 toggle.
    Additional fields appear.
  6. In the NPS RADIUS Server trusted IP or FQDN text box, type the IP address or fully qualified domain name (FQDN) of the NPS RADIUS server.
  7. In the Port text box, type 1812.

    If NPS and the Gateway are installed on the same server, the port that the Gateway uses to communicate with NPS must be different than the port that the Gateway uses to communicate with the RADIUS client.

  8. In the Timeout In Seconds text box, type 30.
  9. Screenshot of the RADIUS client resource settings in AuthPoint.

  10. Click Save.

Add an Access Policy to AuthPoint

You must have at least one user group in AuthPoint for authentication with Powerfolder, and you must assign an access policy for the Powerfolder resource to that group. If you already have a group, you do not have to add another group.

In the AuthPoint management UI:

  1. From the navigation menu, select Groups.
  2. To add a new group, click Add Group. If you already have a group that you want to use, click the Name of your group to edit it.

  1. In the Name text box, type a descriptive name for the group.
  2. (Optional) In the Description text box, type a description of the group.

  1. In the Access Policy section, click Add Policy.

  1. In the Add Policy dialog box, from the Resource drop-down list, select the resource you want to add an access policy for.
  2. (Optional) To require that users type their password before they authenticate for this resource, select the Require Password Authentication toggle.
  3. For the authentication options allowed, select Push. This is the authentication method that users in this group use when they authenticate.

    The access policy for a RADIUS client resource that uses MS-CHAPv2 can only use the push authentication method. You cannot use the OTP authentication method if MS-CHAPv2 is enabled.

  1. Click Add.
    The access policy for your resource is added to the list.

  1. Click Save.

Bind the RADIUS Resource to a Gateway

To use RADIUS authentication with AuthPoint, you must have the AuthPoint Gateway installed on your corporate network and you must assign your RADIUS resources to the Gateway in the AuthPoint management UI. The Gateway functions as a RADIUS server.

If you have not already configured and installed the AuthPoint Gateway, see About Gateways.

To assign your RADIUS resources to the Gateway:

  1. From the navigation menu, select Gateway.
  2. Select the Name of the Gateway.
  3. In the RADIUS section, in the Port text box, type the port number used to communicate with the Gateway. The default ports are 1812 and 1645.
  4. In the Select a RADIUS resource drop-down list, select your RADIUS client resource.
  5. Click Save.

Sync Users to AuthPoint from Active Directory

You must create AuthPoint user accounts for your users. To sync users from Active Directory, you must add an LDAP external identity and create one or more queries.

In AuthPoint, LDAP external identities represent external user databases. They connect to user databases to get user account information and validate passwords. The queries you add to an external identity specify which users to sync from your Active Directory or LDAP database. They pull user information and create AuthPoint user accounts for the users that are found.

For detailed instructions to sync users from Active Directory, see Sync Users from Active Directory or LDAP.

Test the Integration

To test AuthPoint MFA with PowerFolder, you authenticate with a mobile token on your mobile device. For RADIUS resources with MS-CHAPv2 enabled, you authenticate with a push notification (you receive a push notification in the mobile app that you must approve to authenticate).

  1. Start the PowerFolder client.
  2. In the Username/Email text box, type the user name or email address associated with your AuthPoint user account. This should be a user that is synced from Active Directory or an LDAP database.
  3. In the Password text box, type your password.

Screenshot of the PowerFolder login screen.

  1. Click Next.
  2. Approve the authentication request that is sent to your mobile device.

    The first log in to PowerFolder will fail. PowerFolder then creates an account with the user name or email that you just used to log in.

  3. Log in to PowerFolder Server with the administrator account.
  4. Select Accounts.
  5. Find the account that PowerFolder just created and activate it.
  6. Repeat the Steps 1—5 to authenticate and log in to PowerFolder.

Screenshot that shows a successful log in.