10.1 Connecting to a New ActiveSync Server

10.1.1 Prerequisites

A backend Exchange Server should be configured with user mailboxes.

10.1.2 Procedure

  1. On the Getting Started with Mobile Management page, navigate to the ActiveSync Servers section and click New > ActiveSync Server. Alternatively, from the left hand side navigation pane of ZCC, click Configuration > ActiveSync tab.

  2. In the ActiveSync Servers panel, click New to display the New ActiveSync Server dialog box.

  3. Fill in the following fields:

    • Server: Specify a display name for the ActiveSync Server. This can be any name you want for display purposes. It does not have to match the actual server name.

    • Address: Specify the hostname or IP address of the ActiveSync Server.

    • Domain: Specify the registration domain that is associated with the ActiveSync Server.

    • Port: Specify the listening port for the ActiveSync Server.

    • Use SSL: Select this option to enforce a secure connection with the ActiveSync Server.

    • Enable Modern Authentication: Select the Enable Modern Authentication check box if the email server uses Modern Authentication for user authentication.

      NOTE:If you enable Modern Authentication for the ActiveSync Server,

      • ZENworks Server will not be functioning as a proxy server.

      • The Test Authentication and Use SSL buttons will be grayed out.

      IMPORTANT:The Enable Modern Authentication option is available on ZENworks 2020 Update 3 - FTF 956 and above.

    • Link to User Source: Select the ZENworks user source (LDAP directory) with which you want the ActiveSync Server to be associated.

      When a user enrolls a device using the domain name, the user is authenticated via the user source and directed to the ActiveSync Server.

      If multiple ActiveSync Servers are linked to the same user source, you can specify the order in which the servers are contacted. You can re-order the user sources by navigating to Users > <User Source> > Details > Mobile Management > Linked ActiveSync Servers.

  4. Test user authentication to the ActiveSync Server:

    1. Click Test Authentication.

    2. Specify the credentials for an active account on the ActiveSync Server.

      NOTE:The user name is required. You can specify the user name in the following two formats:

      • domain\user name (example.com\testuser1)

      • email ID format (testuser1@example.com)

    3. Click Test.

    4. If the test is successful, click Close.

      If the test fails, specify the user name and password again, or try a different user name and password. If the test fails again, verify that the server address and port are correct, then retry the test.

      IMPORTANT:For email based authentication, the email address should be present in the configured user source for successful ActiveSync enrollment on the device. For users of the GroupWise email system, you need to publish these email addresses to eDirectory. For details, you can refer to the GroupWise Documentation.

  5. Save the ActiveSync Server connection:

    1. Click Create Server.

    2. If you are prompted to accept the ActiveSync Server’s certificate (because a secure connection is being used), click Accept.

      If you are unsure of the certificate, you can click View Certificate to review it. If you choose to reject the certificate, you are returned to the Create ActiveSync Server dialog box.

  6. Run the following configure action on all primary servers after configuring the ActiveSync Server in a zone:

    microfocus-zenworks-configure -c HTTPMethodSettingConfigureAction

    By default, the HTTP method OPTIONS is disabled in ZENworks. You must run the microfocus-zenworks-configure -c HTTPMethodSettingConfigureAction configure action to support ActiveSync communication.

You can delete or edit the parameters of the ActiveSync Server. To edit the parameters of the ActiveSync server, click an ActiveSync Server and modify the parameters. If the ActiveSync Server that you want to modify is already configured with a Mobile Email Policy, then you have to republish or reassign the policy after modifying the server details.

You can delete a configured ActiveSync Server by selecting the server and clicking Delete. To delete an ActiveSync server that is configured with an Mobile Email policy, you have to change the ActiveSync Server in the Mobile Email Policy and then delete the ActiveSync Server.

NOTE:You must run the microfocus-zenworks-configure -c HTTPMethodSettingConfigureAction configure action if you are removing an ActiveSync Server.