Citrix Endpoint Management

Prepare to enroll devices and deliver resources

Important:

Before proceeding, be sure to complete all the tasks described in Onboarding and resource setup.

Keep your users informed about upcoming changes. See Welcome to your Citrix Endpoint Management User Adoption Kit.

Endpoint Management supports various enrollment options. This article covers the basic setup required to enable all supported devices to enroll. The following diagram summarizes the basic setup.

Workflow diagram for preparing an environment for device enrollment

For a list of supported devices, see Supported device operating systems.

Set up an Apple Push Notification service (APNs) certificate for iOS devices

Important:

Apple support for the APNs legacy binary protocol ends as of March 31, 2021. Apple recommends that you use the HTTP/2-based APNs provider API instead. As of release 20.1.0, Citrix Endpoint Management supports the HTTP/2-based API. For more information, see the news update, “Apple Push Notification Service Update” in https://developer.apple.com/. For help with checking connectivity to APNs, see Connectivity checks.

Endpoint Management requires an Apple Push Notification service (APNs) certificate from Apple to enroll and manage iOS devices. Endpoint Management also requires an APNs certificate for Secure Mail for iOS push notifications.

Set up Firebase Cloud Messaging (FCM) for Android devices

Firebase Cloud Messaging (FCM) controls how and when Android devices connect to the Endpoint Management service. Any security action or deployment command triggers a push notification. The notification prompts users to reconnect to Endpoint Management.

  • FCM setup requires that you configure your Google account. To create Google Play credentials, see Manage your developer account information. You also use Google Play to add, buy, and approve apps for deployment to the Android Enterprise workspace on a device. You can use Google Play to deploy your private Android apps, public apps, and third-party apps.

  • To set up FCM, see Firebase Cloud Messaging.

Set up Endpoint Management AutoDiscovery service

The AutoDiscovery service simplifies the enrollment process for users through email-based URL discovery. The AutoDiscovery service also provides features such as enrollment verification, certificate pinning, and other benefits for Citrix Workspace customers. The service, hosted in Citrix Cloud, is an important part of many Endpoint Management deployments.

With the AutoDiscovery service, users:

  • Can use their corporate network credentials to enroll their devices.
  • Don’t need to enter details about the Endpoint Management server address.
  • Enter their user name in user principal name (UPN) format. For example, user@mycompany.com.

We recommend that you use the AutoDiscovery service for high-security environments. The AutoDiscovery service supports public key certificate pinning, which prevents man-in-the-middle attacks. Certificate pinning ensures that the certificate signed by your enterprise is used when Citrix clients communicate with Endpoint Management. To configure certificate pinning for your Endpoint Management sites, contact Citrix Support. For information about certificate pinning, see Certificate pinning.

To access the AutoDiscovery service, navigate to https://adsui.cloud.com (commercial) or https://adsui.cem.cloud.us (government).

Prerequisites

  • The new AutoDiscovery service in Citrix Cloud requires the latest version of Secure Hub:
    • For iOS, Secure Hub version 21.1.0 or later
    • For Android, Secure Hub version 21.2.1 or later

      Devices running on earlier versions of Secure Hub might experience interruptions in service.

  • To access the new AutoDiscovery service, you must have a Citrix Cloud administrator account with full access. The AutoDiscovery service doesn’t support administrator accounts with custom access. If you don’t have an account, see Sign up for Citrix Cloud.

    Citrix migrated all existing AutoDiscovery records to Citrix Cloud without a disruption in service. The migrated records don’t automatically appear in the new console. You must reclaim domains in the new AutoDiscovery service to prove ownership. For more information, see CTX312339.

  • Before starting using the AutoDiscovery service for your Endpoint Management deployments, verify and claim your domain. You can claim up to 10 domains. The claim associates the verified domain with the AutoDiscovery service. To claim more than 10 domains, open an SRE ticket or contact Citrix Technical Support.
  • Use the MAM Port setting instead of Citrix Gateway FQDN to direct MAM traffic to your data center. If you enter a fully qualified domain name along with the port of your Citrix Gateway, the client device uses the configuration from the MAM Port setting.
  • If an ad blocker prevents the site from opening, ensure that you disable the ad blocker for the entire website.

Claim a domain

  1. On the Claims > Domains tab, click Add Domain.

    Add a domain

  2. In the dialog box that appears, enter the domain name of your Endpoint Management environment and then click Confirm. Your domain appears in Claims > Domains.

    Claim a domain

  3. On the domain you added, click the ellipsis menu and select Verify Domain to start the verification process. The Verify your domain page appears.

    Start the verification

  4. On the Verify your domain page, follow the instructions to verify that you own the domain.

    Verify your domain

    1. Click Copy to copy the DNS token to the clipboard.

    2. Create a DNS TXT record in the zone file for your domain. To do so, go to your domain hosting provider portal and add the DNS token you copied.

      The following screenshot shows a domain hosting provider portal. Your portal may look different.

      Verify your domain

    3. In Citrix Cloud, on the Verify your domain page, click Start DNS Check to start detecting your DNS TXT record. If you want to verify the domain later, click Verify Domain Later.

    The verification process generally takes about an hour. However, it can take up to two days to return a response. It is OK for you to log out and log in again during the status check.

    After the configuration completes, the status of your domain changes from Pending to Verified.

  5. After you claim your domain, provide information about the AutoDiscovery service. Click the ellipsis menu on the domain you added and then click Add Endpoint Management Info. The AutoDiscovery Service Information page appears.

  6. Enter the following information and then click Save.

    • Endpoint Management Server FQDN: Enter the fully qualified domain name of the Endpoint Management server. For example: example.xm.cloud.com. This setting is used for MDM and MAM control traffic.

    • Citrix Gateway FQDN: Enter the fully qualified domain name of Citrix Gateway, in the form FQDN or FQDN:port. For example: example.com. This setting is used to direct MAM traffic to your data center. For MDM-only deployments, leave this field blank.

      Note:

      Citrix recommends that you use the MAM Port setting instead of Citrix Gateway FQDN to control MAM traffic. If you enter a fully qualified domain name along with the port of your Citrix Gateway, the client device uses the configuration from the MAM Port setting.

    • Instance Name: Enter the instance name of the Endpoint Management server you configured above. If you are unsure about your instance name, leave the default value, zdm.

    • MDM Port: Enter the port used for MDM control traffic and MDM enrollment. For cloud-based services, the default is 443.

    • MAM Port: Enter the port used for MAM control traffic, MAM enrollment, iOS enrollment, and app enumeration. For cloud-based services, the default is 8443.

Request AutoDiscovery for Windows devices

If you plan to enroll Windows devices, do the following:

  1. Contact Citrix Support and create a support request to enable Windows AutoDiscovery.

  2. Obtain a publicly signed, non-wildcard SSL certificate for enterpriseenrollment.mycompany.com. The mycompany.com portion is the domain that contains the accounts that users use to enroll. Attach the SSL certificate in .pfx format and its password to the support request created in the previous step.

    To use more than one domain to enroll Windows devices, you can also use a multi-domain certificate with the following structure:

    • A SubjectDN with a CN that specifies the primary domain it serves (for example, enterpriseenrollment.mycompany1.com).
    • The appropriate SANs for the remaining domains (for example, enterpriseenrollment.mycompany2.com, enterpriseenrollment.mycompany3.com, and so on).
  3. Create a canonical name (CNAME) record in your DNS and map the address of your SSL certificate (enterpriseenrollment.mycompany.com) to autodisc.xm.cloud.com.

    When a Windows device user enrolls using a UPN, the Citrix enrollment server:

    • Provides the details of your Endpoint Management server.
    • Instructs the device to request a valid certificate from Endpoint Management.

At this point, you can enroll all supported devices. Proceed to the next section to prepare to deliver resources to devices.

Integrate with Azure AD Conditional Access

You can configure Endpoint Management to apply Azure AD Conditional Access support to Office 365 applications. This feature lets you deploy the Zero Trust methodology to device users when deploying Office 365 applications. You can use device state, risk score, location, and device protections to apply automated actions and define access to the Office 365 applications on managed Android Enterprise and iOS devices.

To enforce Azure AD device compliance, you must configure Conditional Access policies for individual Office 365 applications. You can restrict user access to specific Office 365 applications on non-managed and non-compliant devices and permit access to individual applications only on managed and compliant devices.

Prerequisites

  • For this integration, you must have a valid Azure AD premium subscription, including Intune and Microsoft Office 365 licenses.
  • Secure Hub version 21.4.0 and later
  • Configure Azure AD as an identity provider (IdP) in Citrix Cloud, and then set Citrix identity as the IdP type for Endpoint Management. For information, see Authentication with Azure Active Directory through Citrix Cloud.
  • Consent to the Citrix Multi-tenant AAD application to allow mobile applications to authenticate with the AAD client app. Only required if the Azure Global Administrator set the value for Users can register applications to No. Configure this setting in the Azure portal under Azure Active Directory > Users > User Settings. To provide consent, see Configure Endpoint Management for Azure AD Compliance Management.
  • Install the Microsoft Authenticator application on the device before starting the Azure AD device registration process.
  • For the Android Enterprise platform, configure a web browser app as the required public store app.
  • Disable the Security defaults setting in the Azure AD console. When you start Azure AD configuration, you will replace security defaults with more granular Azure AD Conditional Access policies. For more information about security defaults, see the Microsoft documentation.

Configure device compliance through Azure AD Conditional Access policies

The general steps to configure device compliance through Azure AD Conditional Access policies are as follows:

  1. Endpoint Management configuration:
    • In the Microsoft Endpoint Manager admin center, add Citrix Workspace device compliance as the compliance partner for each device platform and assign user groups.
    • In Endpoint Management, synchronize information from the Microsoft Endpoint Manager admin center.
  2. Azure AD configuration: In the Azure AD portal, set Conditional Access policies for individual Office 365 apps.

  3. Endpoint Management configuration: After configuring Conditional Access policies for Office 365 apps, add the Microsoft Authenticator app and Office 365 apps as public app store apps in Endpoint Management. Assign these public apps to the delivery group and set them as required apps.

Configure Endpoint Management for Azure AD compliance management

  1. Sign in to the Microsoft Endpoint Manager admin center and navigate to Tenant administration > Connectors and tokens > Device compliance management. Click Add compliance partner and choose Citrix Workspace device compliance as the compliance partner for each device platform. Then assign user groups.

    The Microsoft Endpoint Manager admin center

  2. In Endpoint Management, go to Settings > Azure AD compliance management.
  3. Optionally, set global consent so that users don’t need to provide consent on each device. Next to Client App consent, click Provide consent. Enter your global admin Azure AD credentials and follow the prompts to provide global consent for the client apps.
  4. Click Connect to sync information from the Microsoft Endpoint Manager admin center.

    Sync information from the Microsoft Endpoint Manager admin center

    A dialog box prompts you to accept the permissions for this configuration. Click Accept. After the configuration completes, synchronized device platforms appear in the list.

    Permission request

Configure Conditional Access policies in Azure AD

In the Azure AD portal, configure Conditional Access policies for Office 365 apps to enforce device compliance. Go to Devices > Conditional Access > Policies > New policy. For more information, see the Microsoft documentation.

To configure device compliance for Intune managed apps:

Configure apps in Endpoint Management

After configuring Conditional Access policies for Office 365 apps, add the Microsoft Authenticator app and Office 365 apps as public app store apps in Endpoint Management. Assign these public apps to the delivery group and set them as required apps. For information, see Add a public app store app.

User authentication workflow

  1. A new user must enroll a device into Endpoint Management using Azure AD credentials. Users, who previously enrolled with Azure AD credentials, don’t need to re-enroll their devices.
  2. Endpoint Management pushes Microsoft Authenticator and configured Office 365 apps to a device as required apps. If you configured a web browser app as the required public store app for Android platform, Endpoint Management pushes it to the user device as well.
  3. Secure Hub automatically installs and displays all apps managed through Endpoint Management.
  4. When a user tries to sign in to any available Office 365 app, the device prompts the user to tap the Azure AD registration link to start the registration process.
  5. After the user taps the registration link, the Microsoft authenticator app opens. The user enters Azure AD credentials and agrees to the device enrollment terms. Then the Microsoft authenticator app closes and Secure Hub reopens.
  6. Secure Hub displays a message that Azure AD device registration is complete. The user can now use Microsoft apps to access their cloud resources.

    After the registration completes, Azure AD marks the device as managed and compliant in the console.

Default device policies and mobile productivity apps

If you onboard starting with Endpoint Management 19.5.0 or later, we preconfigure a few device policies and mobile productivity apps. That configuration enables you to:

  • Immediately deploy basic functionality to devices
  • Start with the recommended baseline configurations for a secure workspace

For the Android, Android Enterprise, iOS, macOS, and Windows Desktop/Tablet platforms, your site contains these preconfigured device policies:

  • Passcode device policy: The Passcode device policy is On, with all default passcode settings enabled.

  • App inventory device policy: The App inventory device policy is On.

  • Restrictions device policy: The Restrictions device policy is On, with all default restrictions settings enabled.

Those policies are in the AllUsers delivery group, which contains all Active Directory and local users. We recommend that you use the AllUsers delivery group only for initial testing. Then, create your delivery groups and disable the AllUsers delivery group. You can reuse the preconfigured device policies and apps in your delivery groups.

All Endpoint Management device policies are documented under Device policies. That article includes information about how to use the console to edit device policies. For information about some commonly used device policies, see Device policies and Use Case Behavior.

For the iOS and Android platforms, your site contains these preconfigured mobile productivity apps:

  • Secure Mail
  • Secure Web
  • Citrix Files

Those apps are in the AllUsers delivery group.

For more information, see About mobile productivity apps.

Continue your Endpoint Management configuration

After you complete the basic setup for device enrollment, how you configure Endpoint Management varies widely based on your use cases. For example:

  • What are your security requirements and how do you want to balance those requirements with user experience?
  • Which device platforms do you support?
  • Do users own their devices or use corporate-owned devices?
  • What device policies do you want to push to devices?
  • What types of apps do you provide users?

This section helps you navigate through the many configuration choices by directing you to articles in this documentation set.

As you complete configuration in third-party sites, make note of the information and its location, for reference when you configure Endpoint Management console settings.