Contents

Related Topics

Configure Active Directory Authentication

Active Directory is the Microsoft® Windows-based application of an LDAP directory structure. Active Directory lets you expand the concept of domain hierarchy used in DNS to an organizational level. It keeps information and settings for an organization in a central, easy-to-access database. You can use an Active Directory authentication server to enable your users to authenticate to your Firebox with their current network credentials. For Active Directory authentication to work correctly, you must configure both your Firebox and the Active Directory server.

When you configure Active Directory authentication, you can specify one or more Active Directory domains that your users can select when they authenticate. You can add an unlimited number of domains.

For each domain, you can add up to two Active Directory servers: one primary server and one backup server. If the first server you add fails, the second server is used to complete authentication requests. When you add an Active Directory server, you can select whether to specify the IP address or the DNS name of each server.

If you configure more than one Active Directory domain and you use Single Sign-On (SSO) to enable your users to select from the available Active Directory domains and authenticate, your users must install the SSO Client, or you must use the Event Log Monitor or Exchange Monitor. For more information, see About Active Directory Single Sign-On (SSO) and Install the WatchGuard Single Sign-On (SSO) Client.

If your users authenticate with the Active Directory authentication method, their distinguished names (DN) and passwords are hashed but not encrypted. To use Active Directory authentication and encrypt user credentials, you can select the LDAPS (LDAP over SSL) option. When you use LDAPS, the traffic between the LDAPS client on your Firebox and your Active Directory server is secured by an SSL tunnel. When you enable this option, you can also choose whether to enable the LDAPS client to validate the Active Directory server certificate. If you choose to use LDAPS and you specify the DNS name of your server, make sure the search base you specify includes the DNS name of your server.

The Active Directory server can be located on any Firebox interface. You can also configure your device to use an Active Directory server available through a VPN tunnel. For more information, see Active Directory Authentication Through a BOVPN Tunnel.

PhoneFactor authentication is a multiple-factor authentication system that uses phone calls to determine the identity of users. Because it uses more than one out-of-band method (phone calls, text messages, and push notifications) and an OATH passcode, PhoneFactor provides flexible options for users and a single multiple-factor platform to manage.

If you use PhoneFactor authentication with your Active Directory server, you can configure the timeout value in the Active Directory authentication server settings to specify when out-of-bound PhoneFactor authentication occurs. For PhoneFactor authentication, you must set the timeout value to more than 10 seconds.

Before you begin, make sure your users can successfully authenticate to your Active Directory server. You can add, edit, or delete the Active Directory domains and servers defined in your Firebox configuration.

Add an Active Directory Authentication Domain and Server

To add an Active Directory domain and server, from Fireware Web UI:Closed
  1. Select Authentication > Servers.
    The Authentication Servers page appears.
  2. From the Server list, select Active Directory.
    The Active Directory server settings appear.

Screen shot of the Authentication Servers page, with the Active Directory tab selected

  1. Click Add.
    The Add page appears.

Screen shot of the Add page for an Active Directory domain

  1. In the Domain Name text box, type the domain name to use for this Active Directory server.
    The domain name must include a domain suffix. For example, type example.com, not example.
  2. From the Primary drop-down list, select IP Address or DNS Name.
  3. In the text box, type the IP address or DNS name of this Active Directory server.
  4. In the Port text box, type the TCP port number for the device to use to connect to the Active Directory server. Tip!The default port number is 389. If you enable LDAPS, you must select port 636.

    5. If your Active Directory server is a global catalog server, it can be useful to change the default port. For more information, see Change the Default Port for the Active Directory Server.

  5. To add another Active Directory server to this domain:
    1. From the Secondary (Optional) drop-down list, select IP Address or DNS Name.
    2. In the text box, type the IP address or DNS name of the secondary Active Directory server.
    3. In the Port text box, specify the TCP port number for the device to use to connect to the Active Directory server.

    For more information, see Use a Backup Authentication Server.

  6. In the Timeout text box, type or select the number of seconds the device waits for a response from the Active Directory server before it closes the connection and tries to connect again.
  7. In the Dead Time text box, type a time after which an inactive server is marked as active again.
  8. From the Dead Time drop-down list, select Minutes or Hours to set the duration.

    After an authentication server has not responded for a period of time, it is marked as inactive. Additional authentication attempts do not try this server until it is marked as active again.

  9. In the Search Base text box, type the location in the directory to begin the search. Tip!The standard format for the search base setting is: ou=<name of organizational unit>,dc=<first part of the distinguished server name>,dc=<any part of the distinguished server name that appears after the dot>.

    For more information about how to use a search base to limit the directories on the authentication server where the device can search for an authentication match, see Find Your Active Directory Search Base.

  10. In the Group String text box, type the attribute string that is used to hold user security group information on the Active Directory server. If you have not changed your Active Directory schema, the security group string is always memberOf.
  11. From the Login Attribute drop-down list, select an Active Directory login attribute to use for authentication.

    The login attribute is the name used for the bind to the Active Directory database. The default login attribute is sAMAccountName. If you use sAMAccountName, you do not have to specify a value for the DN of Searching User and Password of Searching User settings.

      1. In the DN of Searching User text box, type the distinguished name (DN) for a search operation.

        If you keep the login attribute of sAMAccountName, you do not have to type anything in this text box.

        If you change the login attribute, you must add a value in the DN of Searching User text box. You can use any user DN with the privilege to search LDAP/Active Directory, such as an administrator. However, a weaker user DN with only the privilege to search is usually sufficient.
        For example: cn=Administrator,cn=Users,dc=example,dc=com

      2. In the Password of Searching User text box, type the password associated with the distinguished name for a search operation.
  12. To enable secure SSL connections to your Active Directory server, select the Enable LDAPS check box.
  13. If you enable LDAPS but did not set the Port value to the default port for LDAPS, a port message dialog box appears. To use the default port, click Yes. To use the port you specified, click No.
  14. To verify the certificate of the Active Directory server is valid, select the Validate server certificate check box.
  15. To specify optional attributes for the primary LDAP server, complete the Active Directory Server Optional Settings section.

    For more information about how to configure optional settings, see About Active Directory Optional Settings.

  16. Click Save.
To add an Active Directory domain and server, from Policy Manager:Closed
  1. Click the Authentication Servers icon.
    Or, select Setup > Authentication > Authentication Servers.
    The Authentication Servers dialog box appears.
  2. Select the Active Directory tab.
    The Active Directory settings appear.

screenshot of Authentication Servers Active Directory tab

  1. Click Add.
    The Add Active Directory Domain dialog box appears.

Screen shot of the Add Active Directory Domain dialog box

  1. In the Domain Name text box, type the domain name to use for this Active Directory server.
    The domain name must include a domain suffix. For example, type example.com, not example.
  2. Click Add.
    The Add IP/DNS Name dialog box appears.

  1. From the Choose Type drop-down list, select IP Address or DNS Name.
  2. In the Value text box, type the IP address or DNS name of this Active Directory server.
  3. In the Port text box, type or select the TCP port number for the device to use to connect to the Active Directory server.
    The default port number is 389. If you enable LDAPS, you must select port 636.

    If your Active Directory server is a global catalog server, it can be useful to change the default port. For more information, see Change the Default Port for the Active Directory Server.

  4. Click OK.
    The IP address or DNS name you added appears in the Add Active Directory Domain dialog box.
    Screen shot of the Add Active Directory Domain dialog box, with Active Directory server IP addresses
  5. To add another Active Directory server to this domain, repeat Steps 3–9. You can add up to two servers.

    Make sure the shared secret is the same on all the Active Directory servers you specify.

  6. In the Timeout text box, type or select the number of seconds the device waits for a response from the Active Directory server before it closes the connection and tries to connect again.

    If your Active Directory server is a global catalog server, it can be useful to change the default port. For more information, see Change the Default Port for the Active Directory Server.

  7. In the Dead Time text box, type or select a time after which an inactive server is marked as active again.
  8. From the Dead Time drop-down list, select minutes or hours to set the duration. After an authentication server has not responded for a period of time, it is marked as inactive. Additional authentication attempts do not try this server until it is marked as active again.
  1. In the Search Base text box, type the location in the directory to begin the search.

    The standard format for the search base setting is: ou=<name of organizational unit>,dc=<first part of the distinguished server name>,dc=<any part of the distinguished server name that appears after the dot>

    To limit the directories on the authentication server where the device can search for an authentication match, you can set a search base. We recommend that you set the search base to the root of the domain. This enables you to find all users and all security groups to which those users belong.

    For more information, see Find Your Active Directory Search Base.

  2. In the Group String text box, type the attribute string that is used to hold user security group information on the Active Directory server. If you have not changed your Active Directory schema, the security group string is always memberOf.
  3. In the Login Attribute text box, type or select an Active Directory login attribute to use for authentication.

    The login attribute is the name used for the bind to the Active Directory database. The default login attribute is sAMAccountName. If you use sAMAccountName, you do not have to specify a value for the DN of Searching User and Password of Searching User settings.

  4. In the DN of Searching User text box, type the distinguished name (DN) for a search operation.

    If you keep the login attribute of sAMAccountName, you do not have to type anything in this text box.

    If you change the login attribute, you must add a value in the DN of Searching User text box. You can use any user DN with the privilege to search LDAP/Active Directory, such as an administrator. However, a weaker user DN with only the privilege to search is usually sufficient.
    For example: cn=Administrator,cn=Users,dc=example,dc=com

  5. In the Password of Searching User text box, type the password associated with the distinguished name for a search operation.
  6. To enable secure SSL connections to your Active Directory server, select the Enable LDAPS check box.
  7. If you enable LDAPS but did not set the Port value to the default port for LDAPS, a port message dialog box appears. To use the default port, click Yes. To use the port you specified, click No.
  8. To verify the certificate of the Active Directory server is valid, select the Validate server certificate check box.
  9. To specify optional attributes for the primary LDAP server, click Optional Settings.

    For more information about how to configure optional settings, see the next section.

  10. To add another Active Directory domain, repeat Steps 3–20. Make sure the shared secret is the same on all the Active Directory domains you specify.
  11. Click OK.
  12. Save the Configuration File.

About Active Directory Optional Settings

Fireware can get additional information from the directory server (LDAP or Active Directory) when it reads the list of attributes in the server’s search response. This lets you use the directory server to assign extra parameters to the authenticated user sessions, such as timeouts and Mobile VPN with IPSec address assignments. Because the data comes from LDAP attributes associated with individual user objects, you are not limited to the global settings specified in the device configuration file. You can set these parameters for each individual user.

For more information, see Use Active Directory or LDAP Optional Settings.

Test the Connection to the Server

To make sure that your Firebox can connect to your Active Directory server and successfully authenticate your users, from Fireware Web UI, you can test the connection to your authentication server. You can also use this feature to determine whether a specific user is authenticated and to get authentication group information for that user.

You can test the connection to your authentication server with one of these methods:

  • Go to the Authentication Servers page for your server
  • Navigate directly to the Server Connection page in Fireware Web UI
  • Connect to the Authentication Portal on port 4100

To navigate to the Server Connection page from the Authentication Servers page:

  1. Click Test Connection for LDAP and Active Directory.
    The Server Connection page appears.
  2. Follow the instructions in the Server Connection topic to test the connection to your server.

For instructions to navigate directly to the Server Connection page in Fireware Web UI, see Server Connection.

To connect to the Authentication Portal to verify that authentication is working, go to https://[Firebox IP address]:4100.

Edit an Existing Active Directory Domain

When you edit the settings for an Active Directory domain, you can change all of the details for the domain except for the domain names of the Active Directory servers configured in the domain. To change the name of a domain, you must remove the server with the incorrect name and add a new server.

To edit an Active Directory domain from the Fireware Web UI Authentication Servers page:Closed
  1. In the Active Directory domains list, select the server to change.

Screen shot of the Authentication Servers, Active Directory page with a domain selected

  1. Click Edit.
    The Active Directory / Edit page appears.

Screen shot of the Edit page for an Active Directory server

  1. To add an IP address or DNS name to the server for this domain, follow the instructions in the previous section.
  2. Update the settings for your Active Directory server.
To edit an Active Directory domain from the Policy Manager Authentication Servers dialog box:Closed
  1. In the Active Directory domains list, select the server to change.

Screenshot of the Authentication Servers dialog box, Active Directory tab

  1. Click Edit.
    The Edit Active Directory Domain dialog box appears.

  1. To add an IP address or DNS name to the server for this domain, click Add and follow the instructions in the previous section.
  2. To remove an IP address or DNS name from the server for this domain, select the entry in the IP Address / DNS Name list and click Remove.
  3. Update the settings for your Active Directory server.

Delete an Active Directory Domain

To delete an Active Directory domain from the Fireware Web UI Authentication Servers page:

  1. From the Server list, select Active Directory.
    The Active Directory page appears.
  2. In the Active Directory domains list, select the domain to delete.
  3. Click Remove.
    A confirmation message appears.
  4. Click Yes.
    The server is removed from the list.

To delete an Active Directory domain from the Policy Manager Authentication Servers dialog box:

  1. In the Active Directory domains list, select the domain to delete.
  2. Click Remove.
    A confirmation message appears.
  3. Click Yes.
    The server is removed from the list.

See Also

About Third-Party Authentication Servers

Change the Default Port for the Active Directory Server

Give Us Feedback  •   Get Support  •   All Product Documentation  •   Technical Search

© 2018 WatchGuard Technologies, Inc. All rights reserved. WatchGuard, the WatchGuard logo, WatchGuard Dimension, Firebox, Core, Fireware, and LiveSecurity are registered trademarks or trademarks of WatchGuard Technologies in the United States and/or other countries.