Developer Guidelines
3.54.0
Search this version
Developer Guidelines
Developer Guidelines
METADEFENDER IT ACCESS APIs
Archived APIs
Title
Message
Create new category
What is the title of your new category?
Edit page index title
What is the title of the page index?
Edit category
What is the new title of your category?
Edit link
What is the new title and URL of your link?
Account Policy
Copy Markdown
Open in ChatGPT
Open in Claude
| API version | 2.0 |
|---|---|
| Last Update | 6/15/2015 |
| Authentication | YES |
| Response Format | JSON |
| HTTP Method | GET |
| Rate limited | YES |
| Requests per rate limit | 10/min |
Use this API to retrieve default device policy
API URL
xxxxxxxxxxhttps://gears.opswat.com/o/api/v2/account/policyRequest Parameters
| Key | Datatype | Parameter Type | Required | Description | Default |
|---|---|---|---|---|---|
| access_token | string | Header | Yes | access token which archived from OAuth authentication step |
Response HTTP Code
See APIs
Response Parameters
| Key | Datatype | Description |
|---|---|---|
| policy | object | Policy configuration |
| policy.<category> | object | detailed configuration of a category |
| policy.<category>.<policy> | object | detailed policy in a category |
| policy.<category>.<policy>.desc | string | policy description |
| policy.<category>.<policy>.alert | int | Indicate if this policy is considered as an issue |
| policy.<category>.<policy>.critical | int | Indicates if this policy is considered as a critical issue |
| policy.<category>.<policy>.remediation | int | Indicates if a remediation option is turned on |
| policy.<category>.apply_to | object | Indicates if this option is applying to any device type |
| policy.<category>.apply_to.laptop | int | Indicates if this option is applying to laptop devices |
| policy.<category>.apply_to.desktop | int | Indicates if this option is applying to desktop devices |
| policy.<category>.apply_to.server | int | Indicates if this option is applying to server devices |
| policy.<category>.apply_to.vm | int | Indicates if this option is applying to virtual machine devices |
Example
Request Example
xxxxxxxxxxhttps://gears.opswat.com/o/api/v2/account/policy?access_token=TEST7P9ZMJ2LBF8AMOMJLFNPMMLO953AVQ4C9YFF52R61234Response Example
xxxxxxxxxx{ "policy": { "Cloud_Storage": { "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "Running": { "desc": "Report if Running", "critical": 1, "alert": 1, "remediation": 1 }, "Installed": { "desc": "Report if Installed", "critical": 1, "alert": 1, "remediation": 1 } }, "Developer_Tool": { "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "Running": { "desc": "Report if Running", "critical": 1, "alert": 1, "remediation": 1 }, "Installed": { "desc": "Report if Installed", "critical": 1, "alert": 1, "remediation": 1 } }, "Hard_Disk_Encryption": { "EncryptionAlgorithm": { "desc": "Consider unencrypted unless using: ", "alert": 1 }, "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "PartiallyEncrypt": { "desc": "Consider volumes encrypted when product reports \"Partially encrypted\"", "alert": 1 }, "Installed": { "desc": "Report if no encryption application is installed", "critical": 1, "alert": 1 }, "AdditionalVolume": { "desc": "Report if additional volumes are not encrypted by an approved application", "critical": 1, "alert": 1 }, "SystemVolume": { "desc": "Report if system volume is not encrypted by an approved application", "critical": 1, "alert": 1 }, "SuspendedEncrypt": { "desc": "Consider volumes encrypted when product reports \"Encryption protection suspended\"", "alert": 1 } }, "Uninstaller": { "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "Running": { "desc": "Report if Running", "critical": 1, "alert": 1, "remediation": 1 }, "Installed": { "desc": "Report if Installed", "critical": 1, "alert": 1, "remediation": 1 } }, "Antiphishing": { "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "BrowserProtection": { "desc": "Require at least one antiphishing product to be enabled", "critical": 1, "alert": 1 } }, "Media_Player": { "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "Running": { "desc": "Report if Running", "critical": 1, "alert": 1, "remediation": 1 }, "Installed": { "desc": "Report if Installed", "critical": 1, "alert": 1, "remediation": 1 } }, "Patch_Mangement_Agent": { "Enabled": { "desc": "Report if third party patch client is disabled", "critical": 1, "alert": 1 }, "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "Installed": { "desc": "Report if no third party patch client is installed", "critical": 1, "alert": 1 } }, "Toolbars": { "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "Running": { "desc": "Report if Running", "critical": 1, "alert": 1, "remediation": 1 }, "Installed": { "desc": "Report if Installed", "critical": 1, "alert": 1, "remediation": 1 } }, "SystemSecurity": { "apply_to": { "vm": 1, "laptop": 0, "desktop": 0, "server": 0 }, "Passcode": { "desc": "Report if passcode is disabled", "critical": 0, "alert": 1 }, "OutOfDate": { "desc": "Report if system is not authentic", "critical": 0, "alert": 1 } }, "PublicFileSharing": { "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "Running": { "desc": "Report if public file sharing is running", "critical": 1, "alert": 1, "remediation": 1 }, "Installed": { "desc": "Report if public file sharing application is installed", "critical": 1, "alert": 1, "remediation": 1 } }, "OSUpdate": { "Enabled": { "desc": "Report if automatic updating is disabled", "critical": 1, "alert": 1 }, "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "OutOfDate": { "desc": "Report if OS is not up-to date", "critical": 1, "alert": 1 } }, "Recording_Web_Meeting": { "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "Running": { "desc": "Report if Running", "critical": 1, "alert": 1, "remediation": 1 }, "Installed": { "desc": "Report if Installed", "critical": 1, "alert": 1, "remediation": 1 } }, "Firewall": { "Enabled": { "desc": "Require at least one personal firewall to be enabled", "critical": 1, "alert": 1, "remediation": 1 }, "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 } }, "Instant_Messegener": { "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "Running": { "desc": "Report if Running", "critical": 1, "alert": 1, "remediation": 1 }, "Installed": { "desc": "Report if Installed", "critical": 1, "alert": 1, "remediation": 1 } }, "Antivirus": { "Enabled": { "desc": "Require real time protection from at least one antivirus product", "critical": 0, "alert": 1, "remediation": 0 }, "DefinitionTime": { "desc": "Require at least one antivirus product to have definitions less than 3 days old", "critical": 0, "alert": 1, "remediation": 0 }, "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "Installed": { "desc": "Report if no antivirus application is installed", "critical": 0, "alert": 1 }, "ThreatsDetected": { "desc": "Report if at least one antivirus has detected any threats in the last 7 days", "critical": 0, "alert": 1 }, "SystemScan": { "desc": "Require full system scan from at least one antivirus in the last 7 days", "critical": 0, "alert": 1 } }, "Cleaner_Optimizer": { "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "Running": { "desc": "Report if Running", "critical": 1, "alert": 1, "remediation": 1 }, "Installed": { "desc": "Report if Installed", "critical": 1, "alert": 1, "remediation": 1 } }, "VPN_Client": { "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "Running": { "desc": "Report if Running", "critical": 1, "alert": 1, "remediation": 1 }, "Installed": { "desc": "Report if Installed", "critical": 1, "alert": 1, "remediation": 1 } }, "Hard_Drive": { "apply_to": { "vm": 0, "laptop": 0, "desktop": 0, "server": 0 }, "AvailableSpace": { "desc": "Report if available hard drive space is less than 10%", "critical": 1, "alert": 1 } }, "BackupClient": { "Activity": { "desc": "Report if no backup activity in the last 3 days", "critical": 1, "alert": 1 }, "apply_to": { "vm": 1, "laptop": 1, "desktop": 0, "server": 1 }, "Installed": { "desc": "Report if no backup application is installed", "critical": 1, "alert": 1 } }, "Unclassified_PUA": { "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "Running": { "desc": "Report if Running", "critical": 1, "alert": 1, "remediation": 1 }, "Installed": { "desc": "Report if Installed", "critical": 1, "alert": 1, "remediation": 1 } }, "System": { "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "Password": { "desc": "Report if password protection is off", "critical": 1, "alert": 1 }, "LockScreen": { "desc": "Report if lock screen timeout is over 10 minutes", "critical": 1, "alert": 1 } }, "Remote_Control": { "apply_to": { "vm": 1, "laptop": 1, "desktop": 1, "server": 1 }, "Running": { "desc": "Report if Running", "critical": 1, "alert": 1, "remediation": 1 }, "Installed": { "desc": "Report if Installed", "critical": 1, "alert": 1, "remediation": 1 } } }}VariableType to search · ESC to discard
GlossaryType to search · ESC to discard
InsertType to search · ESC to discard
No matches
Last updated on
Was this page helpful?
Next to read:
Delete Devicenull
Discard Changes
Do you want to discard your current changes and overwrite with the template?
Archive Synced Block
Message
Create new Template
What is this template's title?
Delete Template
Message