Change Citrix API Connection Port to 443
    • Dark
      Light
    • PDF

    Change Citrix API Connection Port to 443

    • Dark
      Light
    • PDF

    Article Summary

    To increase the level of security of your environment, you can change your Citrix OData API connection ports from 80 (HTTP) to 443 (HTTPS). The following article explains how to configure ControlUp to make your Citrix API connections work properly.

    Prerequisite

    To verify that Citrix OData API listens to port 443 (HTTPS), browse to the following URL with your DDC:

    https://[My DDC]/Citrix/Monitor/OData/v1/Data/Machines

    If the Citrix OData API does listen to port 443, an XML file opens with all the site machine data, or a page where you can query the data.
    If the Citrix OData API doesn't listen to port 443, the page fails to open. This means that the Citrix OData API listens to port 80 and the prerequisite isn't met.

    To Change Citrix API Connection Port to 443:

    1. From the Home ribbon, click Add EUC Environment, and select Citrix Virtual Apps and Desktops from the Solutions / Platforms dropdown. Identity which machine(s) will connect to the API.
      EUCCitrix
    2. For the Real-Time Console and Data Collector machine(s), use the following registry settings:
      Registry Key: HKEY_LOCAL_MACHINE\SOFTWARE\Smart-X\ControlUp\Agent
      Relevant Value: XenDesktop Data Collection
      Data Type: REG_DWORD
      Possible Data Values: "EnableOdataOverSSL"=dword:00000001"ODataPort"=dword:000001bb
    3. For the ControlUp Monitor machine(s), use the following registry settings:
      Registry Key: HkEY_USERS\S-1-5-20\SOFTWARE\Smart-X\ControlUp\Agent
      Relevant Value: XenDesktop Data Collection
      Data Type: REG_DWORD
      Possible Data Values: "EnableOdataOverSSL"=dword:00000001"ODataPort"=dword:000001bb
    4. Open Services and restart the Console, ControlUp Agent, and Monitor services.
      RestartService
    5. In the EUC Environment Connection window, verify the Broker Name / IP, select port 80, and click OK.
      The connection works properly.
    Important!

    If you don't select port 80, the connection fails.


    Was this article helpful?

    What's Next