ESET Connect
ESET Connect seznam změn je k dispozici pouze v angličtině. |
ESET Connect is the public REST API for ESET Business Cloud Products. REST APIs communicate via HTTPs requests to perform standard database functions like creating, reading, updating, and deleting records within a resource.
Early Access Program for ESET Connect, new API Gateway ESET Connect enable users (our clients and partners from Enterprise, SMB and MSP segments) to use data from our products for other third-party solutions. With ESET Connect, companies can commoditize data and operational components per call by opening up specific functionality of ESET products through an API. |
Early Access Program
Registration
To join the Early Access Program to use the APIs, you must complete the registration form. During the process, you must provide the IP range used for communication. Only users with authorized IP addresses have access to the documentation.
Using APIs
When you receive a notification from Product Manager, you can use the APIs.
Using the API with Swagger
Swagger UI provides complete pre-fabricated API calls:
Automation API calls support following client tasks:
•Isolate computer from network
•End computer isolation from network
•On-Demand Scan
•Shut down computer
•Stop managing (Uninstall ESET Management Agent)
•Software Uninstall (Third-party antivirus software)
•Operating system update
•Run command
REST APIs support only manual trigger type, which means starting ASAP. You cannot create tasks with other trigger types (for example, starting periodically) in REST API. GetDeviceTasks record does not display any other trigger types other than manual. |
You can define task type via task.action.name attribute:
task.action.name |
task |
---|---|
StartNetworkIsolation |
Isolate computer from network |
EndNetworkIsolation |
End computer isolation from network |
OnDemandScan |
On-demand scan |
ShutdownComputer |
Shut down computer |
StopManaging |
Stop managing (Uninstall ESET Management Agent) |
ThirdPartyAVRemove |
Software Uninstall (Third-party antivirus software) |
SystemUpdate |
Operating system update |
RunCommand |
Run command |
In case of OnDemandScan and ShutdownComputer, you can configure additional task settings via task.action.params:
{ "@type": "type.googleapis.com/Era.Common.DataDefinition.Task.OS.ShutdownComputer", "restart": false, "actions": { "cancelAction": false, "postpone": "OneHour" } } |
•restart—if true, computer is restarted, if false computer is shutdown. •actions—allowed actions for device users, postpone and cancel. •cancelAction—true if user will be able to cancel the action or false if not. •postpone—option to postpone action; possible postpone options are: Cannot (Default value) OneHour ThreeHours FiveHours OneDay ThreeDays SevenDays FifteenDays TwentyDays ThirtyDays |
OnDemandScan parameters:
{ "@type": "type.googleapis.com/Era.Common.DataDefinition.Task.ESS.OnDemandScan", "scanProfile": "InDepth", "customProfileName": "", "scanTargets": [ "" ], "cleaningEnabled": false, "shutdownEnabled": false, "shutdownLocked": false, "powerActions": { "cancelAction": false "postpone": "OneHour", } } |
•cleaningEnabled—true if cleaning is enabled. •customProfileName—custom profile name for custom scan profile. •scanProfile—scan profile that will be used during the scan; possible scan profiles are: InDepth InDepth Smart ContextMenu MyProfile Custom •scanTargets—list of scan targets. Empty list or an item equals 'eset://AllTargets', which means the full scan. •shutdownEnabled—true if shutdown is enabled after scan completion. •shutdownLocked—true if shutdown is enforced after scan (cannot be canceled). •powerActions—allowed actions for device users, postpone and cancel; possible postpone options are: Cannot (Default value) OneHour ThreeHours FiveHours OneDay ThreeDays SevenDays FifteenDays TwentyDays ThirtyDays |
You can see the result of OnDemandScan in task_runs[:]result. Example of scan result:
"result": { "scannedTargets": "", "scanned": 0, "infected": 0, "cleaned": 0, "severity": "LOG_INFORMATION", "@type": "type.googleapis.com/Era.Common.DataDefinition.Task.OnDemandScanResult" } |
•scannedTargets—list of scanned targets separated by semicolon. •scanned—the number of scanned files. •infected—the number of infected files. •cleaned—the number of cleaned files. •severity—severity of scan task. |
SystemUpdate parameters:
{ "@type": "type.googleapis.com/Era.Common.DataDefinition.Task.OS.SystemUpdate", "acceptEula": false, "installOptionalUpdates": false, "allowReboot": false, "rebootActions": { "cancelAction": false, "postpone": "OneHour" } } |
•acceptEula—true if automatic EULA acceptance is allowed if it is requested by any of the updates (only Windows platform). •installOptionalUpdates—true if optional updates should be also installed (only Windows platform). •allowReboot—true if reboot is allowed if it is requested by any of the updates. •cancelAction—true if user will be able to cancel the reboot action or false if not. postpone—option to postpone reboot action; possible postpone options are: Cannot (Default value) OneHour ThreeHours FiveHours OneDay ThreeDays SevenDays FifteenDays TwentyDays ThirtyDays |
RunCommand parameters:
{ "@type": "type.googleapis.com/Era.Common.DataDefinition.Task.OS.RunCommand", "commandLine": "", "currentDirectory": "" } |
commandLine—platform dependent command line that will be put into script file and executed. currentDirectory—working directory for script file. |
Task examples
Use the following examples with your own UUIDs and task settings. Device domain calls provide the UUID of groups and devices. |