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.
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.
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.
If you have an on-premise IdP, the app connector Management page looks as follows.
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 |
|---|---|
| Name | App connector name. |
| Connection Status | Whether app connector is connected or disconnected. |
| Description | App connector description, if any. |
| Add App Connector | To add a new app connector. |
| Last Synced | The date on which app connector was last synced on. |
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. |
| Connection Status | Whether app connector is connected or disconnected. |
| Image | To install the app connector, download the app-connector.zip file. Extract the contents of this zip file. Follow the instructions in README.txt file to install the app connector. |
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 |
|---|---|---|
 |
Download | To download the app-connector.zip file. |
 |
Edit | To edit the app connector name and description. |
 |
Delete | To delete the app connector. After deleting the app connector, refer the ReadMe.txt file to uninstall the app connector from the On-Premise system. |
 |
Side bar | To view the details of the app connector. |
- The app connectors can be sorted alphabetically by clicking the sorting symbol next to the Name column.
- Bulk action: Select the check boxes in front of the app connector names to perform bulk delete action on selected app connectors.
Adding an app connector
To add a new app connector, follow these steps.
- Go to the Seqrite HawkkProtect portal. Navigate to App Connector Management in the left navigation pane.
- Click Add App Connector. A new page appears. Enter the following details on this page.
- Enter the app connector name.
- Enter the app connector description.
- Select the site from the drop-down menu.
This is the domain name where the organizational applications/ services are hosted. - After this is done, click Add.
A success prompt is displayed on screen and you are navigated to App Connector Management page. - Download the docker image by clicking the ‘Download’ option, displayed on the extreme right when you hover over the app connector name in the available app connector list.
- Copy this image on the system where you will host the App Connector.
- Choose a system in your organizational network which has connectivity with the private applications and an on-premise AD server, if any.
- Unzip the app connector image and look for the installation script.
- The folder contains separate installation scripts per OS. Execute the script on the selected system.
- Verify if it does not throw any errors.
- Check the App Connector status on the administration console as well.
- For more information, you can go through the README file.
App Connector Details
Enter the following app connector details.
App Connector Other Details
In other details, enter the following information.
Note:
If the app connector version is upgraded, then you need to redeploy the app connector with latest downloadable image.
Working with an App Connector
Once you add the App Connector, follow these steps.
Note: The system should have docker installed.
Note: ☛
If the DNS of the app connector machine or docker is 8.8.8.8, then you need to edit the installation scripts (shell scripts) and add – – net host in the ‘docker run’ command inside the OS specific script file as shown in the following image.
Important Links