Although disabled by default, the Appliance can run a script to support third party add-ons such as external reporting or monitoring agents. Appliance Customizations Scripts are sometimes required in enterprise deployments. However it is not recommended to run scripts on appliances such as Appgate SDP as they can compromise the security of the system. As such Appgate SDP appliances has these type of scripts disabled completely to prevent their malicious use. Appliance Customizations Scripts can be enabled if required when an appliance is created - either in cz-setup or when the seed file is generated.
Before you start
Each appliance can have only one script configured. If two separate functions need to be performed then the script call the two sub-functions which themselves should be included in the script.
There is a limit 200MB for all customizations configured. This is set to limit the amount of data that needs to be synced via BDR.
The .zip file must meet specific requirements set out in Adding third party executables.
Customization scripts must be enabled for the appliance. If they are not enabled then this is done using cz-config.
Running the customization
Once uploaded, the script can be selected in the appliances' settings under Miscellaneous. Once selected, these will then be under the control of cz-configd and will be started/stopped and monitored in a similar way to all the other process running.
Is an appliance customized?
If an appliance has a customization selected then this will be shown in the Dashboard under Version there a (c) will be shown.
By clicking on the Status of the appliance the detailed view window will show which specific customization is in use.
Use the Appliance Customizations form to:
View all the Appliance Customizations you have configured in the Collective.
Upload new Appliance Customizations.
Perform actions using the action buttons provided (See below).
Action Buttons
Action buttons are accessed by clicking the three dots to the right of each line item in the table or from the <Actions> button within the item. They are contextual, changing depending on the type of item and the state of the item.
Download Customization. Downloads the zip archive for the customization.