Product Documentation

Enabling Connections Between Device Manager and App Controller

Oct 20, 2015

If you are using Device Manager with App Controller to provide apps to your Worx Home users, you will need to configure the Device Manager server and App Controller to communicate.

For secure communication between Device Manager and App Controller, install secure signed certificates. App Controller needs to initiate communication with Device Manager and App Controller must validate the server certificate from Device Manager. When Device Manager initiates communication with App Controller, it needs to validate the server certificate from App Controller. This handshake fails if the issuer of the certificate is not trusted on both systems.

If you select Allow Secure Communication in the App Controller management console, Device Manager communicates with App Controller on a secure port (for example: 443). This secure communication requires public certificates on both servers, and requires that the ports are open in both directions.

The communication between Device Manager and App Controller are RESTful API calls if the traffic occurs over port 80. The typical communication is App Controller communicating with Device Manager that the user needs an application from Worx Home. Device Manager could also contact App Controller to find out if App Controller exists and if the user is part of an Active Directory group that synchronized with App Controller.

Note: To allow users to connect to Windows-based apps or virtual desktops, users must have Citrix Receiver installed on their devices.

After you configure Device Manager and App Controller to communicate, you can then test the connection.

To configure Device Manager to connect to App Controller

Important: You must configure settings in Device Manager before configuring settings in App Controller.
  1. Log in to the XenMobile Device Manager web console.
  2. Click Options.
  3. In the Options dialog box, in select Modules Configuration > AppC Webservice API, enter the App Controller fully qualified domain name (FQDN) and a shared key.

    You will enter the same shared key in App Controller.

  4. Select Enable App Controller.
    Note: Do not click Test Connectivity until you have configure Device Manager settings in the App Controller management console.
  5. Click Save.

To configure App Controller to connect to Device Manager

  1. In the App Controller management console, click the Settings tab.
  2. In the navigation pane, click XenMobile MDM.
  3. In the details pane, next to XenMobile Device Manager Configuration, click Edit.
  4. In Host, enter the Device Manager IP address or FQDN.
  5. In Port, leave the default of 80 or enter your own.
  6. In Shared Key, enter the key you configured on Device Manager.
  7. Select Allow secure access to secure the connection between App Controller and Device Manager.
  8. Select Require Device Manager enrollment to require that all user devices are enrolled and managed by Device Manager.
  9. Click Test Connection to test the connection to Device Manager.

    If the test fails, make sure your settings in App Controller and Device Manager match.

  10. Click Save.

To test the connection between Device Manager and App Controller

When you finish configuring the connection in App Controller, you need to test the connection from Device Manager.

  1. In the Device Manager web console, in the Options dialog box, select Modules Configuration > AppC Webservice API, and then click Check connection to test communication between Device Manager and App Controller.
  2. When Device Manager establishes the connection, click Close.