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 Configure PowerFolder 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 PowerFolder, you must:

Add a RADIUS Client Resource in AuthPoint

From the AuthPoint management UI:

  1. From the navigation menu, select Resources. Click Add Resource.
    The Add Resource page opens.

  1. From the Type drop-down list, select RADIUS Client.
    Additional fields appear.

  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 Configure PowerFolder 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 a Group in AuthPoint

You must have at least one user group in AuthPoint to configure MFA. If you already have a group, you do not have to add another group.

To add a group to AuthPoint:

  1. From the navigation menu, select Groups.
  2. Click Add Group.
    The New Group page appears.

Screenshot that shows the Groups page.

  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.

Screen shot of the New Group page.

  1. Click Save.
    Your group is listed on the Groups page.

Screenshot of the Save button on the New Group page.

Add an Authentication Policy to AuthPoint

Authentication policies specify which resources users can authenticate to and which authentication methods they can use (Push, QR code, and OTP).

You must have at least one authentication policy in AuthPoint that includes the PowerFolder RADIUS client resource. If you already have authentication policies, you do not have to create a new authentication policy. You can add this resource to your existing authentication policies.

Users that do not have an authentication policy for a specific resource cannot authenticate to log in to that resource.

To configure an authentication policy:

  1. From the navigation menu, select Authentication Policies.
  2. Click Add Policy.

Screenshot of the Add Policy button on the Authentication Policies page.

  1. Type a name for this policy.
  2. From the Select the authentication options drop-down list, select Authentication options and select the Password and Push check boxes.

    OTP authentication is only supported for local AuthPoint users. To configure OTP authentication, you must create a separate authentication policy for local AuthPoint users that requires the password and OTP authentication options.

    QR code authentication is not supported for RADIUS client resources.

  1. Select which groups this policy applies to. You can select more than one group. To configure this policy to apply to all groups, select All Groups.
  2. Select the resource that you created in the previous section. If you want this policy to apply to additional resources, select each resource this policy applies to. To configure this policy to apply to all resources, select All Resources.

Screenshot of the Add Policy page with the groups and resources selected

  1. (Optional) If you have configured policy objects such as a Network Location, select which policy objects apply to this policy. When you add a policy object to a policy, the policy only applies to user authentications that match the conditions of the policy objects. For example, if you add a Network Location to a policy, the policy only applies to user authentications that come from that Network Location. Users who only have a policy that includes a Network Location do not get access to the resource when they authenticate outside of that Network Location (because they do not have a policy that applies, not because authentication is denied).

    For RADIUS authentication, policies that have a Network Location do not apply because AuthPoint does not have the IP address of the user.

    If you configure policy objects, we recommend that you create a second policy for the same groups and resources without the policy objects. The policy with the policy objects should have a higher priority.

Screenshot of the Policy Objects drop-down list.

  1. Click Save.
    Your policy is created and added to the end of the policy list.

    When you create a new policy, we recommend that you review the order of your policies. AuthPoint always adds new policies to the end of the policy list.

Screenshot of the Save button on the Add Policy page.

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. From 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.

    If you already have a RADIUS server installed that uses port 1812 or 1645, you must use a different port for the AuthPoint Gateway.

  4. From 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.