Orbital Requirements

Supported Platforms

  • Windows

    • Windows 10 (1803 or later) / 11

    • Windows Server 2012 / 2012 R2 / 2016 / 2019 / 2022

    • Windows 10 IoT Enterprise

  • macOS

    • macOS 10.15 / 11 / 12 / 13 / 14

      Apple Silicon is supported when running macOS 11 or later.

  • Linux Distributions

    • Red Hat Enterprise Linux (and compatible distributions) 7 (7.2 or later) / 8 / 9

    • Ubuntu 18.04 / 20.04 / 22.04

    • Oracle Linux (UEK) 7 / 8

    • Debian 10 / 11

    • Amazon Linux 2

Supported Browsers

Orbital supports the latest version and one prior version of the:

  • Apple Safari

  • Google Chrome

  • Mozilla Firefox

Network Connectivity

To use Orbital on your Windows, Mac, and Linux connectors, you must allow access to these servers over TCP 443:

  • Orbital Updates - orbital.amp.cisco.com

  • Orbital Queries - ncp.orbital.amp.cisco.com

  • Orbital Installer - update.orbital.amp.cisco.com

Proxy Support

When deployed from Cisco Secure Endpoint (within Policies), Orbital supports the use of proxies for Linux, macOS, and Windows operating systems. Proxy configurations are inherited from the Secure Endpoint Windows, macOS, and Linux connectors. For more details, refer to the Policies topics.

Orbital does not support the use of SSL proxies and will not function if the proxy performs SSL decryption. It is recommended that Orbital network traffic not be subjected to SSL decryption.

When deployed from Cisco Secure Client, the Orbital nodes on Windows, macOS, and Linux will discover proxy configurations in the orders described below and use the first method that successfully connects to the Orbital back end.

Windows (Orbital node version 2.42 and later)

  1. Direct connection to the Internet

  2. Environment variables
    The Orbital node will read proxy settings from these environment variables:

    1. HTTPS_PROXY (or https_proxy)

    2. HTTP_PROXY (or http_proxy)

    3. FTP_PROXY (or ftp_proxy)

    4. NO_PROXY (or no_proxy)

  3. IE Proxy Config: AutoDetect (WPAD)

    The Orbital node will read the proxy auto-configuration (PAC) file via:

    1. DHCP-based WPAD (i.e., configuring DHCP option 252)

    2. DNS-based WPAD (e.g., hosting the PAC file at wpad.domain.com)

  4. IE Proxy Config: AutoConfig URL (PAC)
    The Orbital node will read the proxy auto-configuration (PAC) file hosted at a given URL.

    • Configure the URL of the PAC file. On your PC, go to Settings > Network & Internet > Proxy and select Set up in the Automatic proxy setup section.

  5. IE Proxy Config: Manual
    The Orbital node will read proxy settings configured directly in settings.

    • Configure proxy settings. On your PC, go to Settings > Network & Internet > Proxy and select Set up in the Manual proxy setup section

  6. WinHTTP Default
    The Orbital node will read proxy settings configured in the operating system via the netsh winhttp command.

macOS (Orbital node version 2.44 and later)

  1. Direct connection to the Internet

  2. Environment variables

    The Orbital node will read proxy settings from these environment variables:

    1. HTTPS_PROXY (or https_proxy)

    2. HTTP_PROXY (or http_proxy)

    3. FTP_PROXY (or ftp_proxy)

    4. NO_PROXY (or no_proxy)

  3. PAC auto-configuration

    The Orbital node will read the proxy auto-configuration (PAC) file hosted at a given URL

    • Configure a PAC file. Go to System Settings > Network > [Network Service] > Details > Proxies, enable Automatic Proxy Configuration, and enter the PAC file URL.

  4. WPAD - Auto Discovery

    The Orbital node will read the proxy auto-configuration (PAC) file via:

    • DHCP based WPAD (i.e., configuring DHCP option 252)

    • DNS based WPAD (e.g., hosting the PAC file at wpad.domain.com)

  5. Manual proxy settings

    Go to System Settings > Network, select your network service (Wi-Fi or Ethernet), click Details, > Proxies, and enter the necessary information.

Linux (Orbital node version 2.44 and later)

  1. Direct connection to the Internet

  2. Environment variables

    The Orbital node will read proxy settings from these environment variables:

    • HTTPS_PROXY (or https_proxy)

    • HTTP_PROXY (or http_proxy)

    • FTP_PROXY (or ftp_proxy)

    • NO_PROXY (or no_proxy)

  3. PAC environment variables

    The Orbital node will read the location of a PAC file from a URL stored in these environment variables:

    • PAC_URL

    • auto_proxy

  4. GNOME proxy settings

    Go to Settings > Network (or Network & Proxy), click Network Proxy, and select Manual, then enter the necessary information.

     

More Info