App Connectors

Print Friendly, PDF & Email

The App Connector is a Docker container that runs on any Linux/Windows/Mac computer with Docker installed, making it infrastructure agnostic. This also allows it to be hosted on any cloud provider or on-premises. It establishes a single, reliable reverse tunnel connection to the HawkkProtect site, which is hosted on a cloud platform.

App Conncetor running in Docker Container

Only outbound Internet access is needed for App Connector. From a security viewpoint, inbound Internet connectivity to an app connector host is not necessary or recommended. You can restrict outbound ports to port 443 as required.

App connector working_new

Ensure that the app connector has permission and routing rules to access private applications/services as well as the on-premise AD server (if any). The App Connector host computer will resolve and redirect applications configured on the Application Catalog page.

A user can access private organizational applications using the app connector deployed in the organizational network. App connectors allow the user to safely access private organizational applications without the use of VPN.

On this page, all the app connectors that connect HawkkProtect to your application servers are listed. The following details are displayed on this page.

Column Name Description
App Connector Groups Vertical Quick Filter By using these quick filters, you can easily view the associated app connectors. Clicking on any group will display its associated app connectors, ensuring high availability. Look for a green indicator next to the name, signifying the active app connector.
Name App Connector name.
Status Whether the App Connector is connected or disconnected.
Version The Version of the App Connector. It displays the version of the app connector. If it is not the latest version, an indication appears, suggesting that an upgrade to the latest version is necessary.
Last Sync The date on which the App Connector was last synced on.

App Connector Status Indicators on the HawkkAgent Screen

  • Upon the connection between AppConnector and the site, the status is indicated as ‘Connected to Site’.
  • When the AppConnector and HawkkAgent establish a connection, the status is displayed as ‘Connected to HawkkAgent’.
  • In the event of the AppConnector and HawkkAgent being disconnected, the status is denoted as ‘Offline’

Email Notifications

Email notifications are sent when there is a change in the status (active/passive) of the app connector.

Click the Name column to sort the available app connectors in alphabetical order.

When you click on any app connector, the following information is displayed in the right pane.

Field Name Description
Name App connector name.
Description App connector description, if any.
Status Whether the App Connector is connected or disconnected.
Device Name The host name of the device on which the App Connector is installed.
App Connector Group The group name to which the App Connector belongs.
Version The version of the App Connector.
Last Sync The date on which the App Connector was last synced on.
Registration Timestamp Timestamp of App Connector registration with ACS (Agent Communication Service).

Actions available with app connectors

When you hover over each app connector name, the following options are displayed on extreme right.

Action Icon Action Label Description
Edit Edit To edit details of the App Connector.
Uninstall Uninstall To uninstall the App Connector.
right arrow View details To view details of the App Connector in the right pane.

You can sort App connectors alphabetically by clicking the sorting symbol next to the Name column. Quick filters are also available with filtering options like All, Unassigned, Connected, and Not Connected.

App Connector Upgrade

You can receive notifications about an app connector upgrade through three channels:

  1. The upgrade toast message on the Visibility Page.

    Toast Message

    When a new App Connector version is available, a toast message will appear on the Visibility Page. To upgrade, click Upgrade, read the instructions, and confirm by clicking Upgrade again. This single click action upgrades all App Connectors across endpoints.

  2. An indicator next to the version on the App Connector page.

    App Connector Upgrade Info Icon

  3. An email notification

  4. You can see the status of the upgrade triggered through Action Logs which typically progresses through the following stages.

    • Initiated
    • Sent
    • Successful

    If the upgrade attempt fails, you can retry the upgrade process.

    Retry Upgrade Process

    • In the right panel, an option is provided to retry the app connector upgrade. Clicking on ‘Upgrade App Connector’ sends the app connector upgrade command, which can be verified in the action log.
    • After a successful upgrade, the status is recorded as ‘Successful’ in the App Connector Action Logs. After a successful upgrade, the ‘Upgrade App Connector’ button in the right panel will be disabled (greyed out) only if the command is in the initiated, sent, or pending state. Once the upgrade is successful, the button will be removed.
    • In the action logs, you have visibility into the upgrade actions, as well as logs for any retry attempts (Reattempt upgrade).

    Ensure you monitor the status indicators and version information regularly to maintain an efficient and up-to-date system.

    Uninstalling App Connector

    To uninstall an App Connector, follow these steps:

    1. Navigate to the App Connectors section in the left navigation menu and then click on the App Connectors tab.
    2. Find the specific App Connector you want to uninstall and hover over it. You will see an option labeled Uninstall.
    3. Click Uninstall. This action will remove the selected App Connector, including any associated files, the Docker image, and system tray entries.
Was this page helpful?