Deployment
CounterMeasures
Add CounterMeasure plugins you created to the /usr/share/onsight/countermeasures directory. To create a custom CounterMeasure, see Create a custom CounterMeasure.
Custom metrics
See Creating a custom metric plugin.
Install plugins automatically during OnSight installation
You can also host created plugins centrally and have them installed automatically during OnSight installation, so that you do not have to manually manage them post-install. To do this, you must define the custom_plugin_url or countermeasure_plugin_url in the OnSight manifest file. The value of this variable can be a compressed archive (.zip, .tar or .tgz) or a single python file (with a .py extension). The hosted plugins will automatically be re-fetched once an hour. The downloaded files are then saved in either:
-
/usr/share/onsight/custom-metrics
-
/usr/share/onsight/countermeasures
You can download plugins manually through the OnSight CLI:
onsight download-custom-plugin
Usage: onsight download-custom-plugin [OPTIONS]
Download custom plugins from custom_plugin_url specified in the manifest file. custom_plugin_url can be set or changed with --url option. The url can be a compressed archive (.zip, .tar or .tgz) or a single python file (with a .py extension).
Options:
--url TEXT
--help Show this message and exit.
onsight download-countermeasure-plugin
Usage: onsight download-custom-plugin [OPTIONS]
Download custom countermeasure plugins from custom_countermeasure_url specified in the manifest file. custom_countermeasure_url can be set or changed with --url option. The url can be a compressed archive (.zip, .tar or .tgz) or a single python file (with a .py extension).
Options:
--url TEXT
--help Show this message and exit.