Joe Sandbox Operation
The web format of this guide reflects the most current release. Guides for older iterations are available in PDF format.
Integration Details
ThreatQuotient provides the following details for this integration:
Current Integration Version | 1.1.1 |
Compatible with ThreatQ Versions | >= 3.6.0 |
Support Tier | ThreatQ Supported |
Introduction
The Joe Sandbox operation submits files, and URLs, for analysis in Joe Sandbox Cloud. After the report has run, you can get the details of the analysis, upload the report to ThreatQ, along with all the IOCs generated from the malware detonation in the sandbox.
The operation provides the following actions:
- Get URL Report - retrieves Reports from Joe Sandbox.
- Submit URL Sample - submits a URL to Joe Sandbox for analysis.
- Get File Report - retrieves Reports from Joe Sandbox.
- Submit File - submits a File to Joe Sandbox for analysis.
The operation is compatible URL type indicators and Files.
Installation
This integration can be installed in the My Integration section of your ThreatQ instance. See the Adding an Integration topic for more details.
Configuration
ThreatQuotient does not issue API keys for third-party vendors. Contact the specific vendor to obtain API keys and other integration-related credentials.
To configure the integration:
- Navigate to your integrations management page in ThreatQ.
- Select the Operation option from the Type dropdown (optional).
- Click on the integration entry to open its details page.
- Enter the following parameter under the Configuration tab:
Parameter Description API Key API Key for authenticating with Joe Sandbox. - Review any additional settings, make any changes if needed, and click on Save.
- Click on the toggle switch, located above the Additional Information section, to enable it.
Actions
The operation provides the following actions:
Action | Description | Object Type | Object Subtype |
---|---|---|---|
Get URL Report | Retrieves Reports from Joe Sandbox. | Indicator | URL |
Submit URL Sample | Submits a URL to Joe Sandbox for analysis. | Indicator | URL |
Get File Report | Retrieves Reports from Joe Sandbox. | File | N/A |
Submit File | Submits a File to Joe Sandbox for analysis. | File | N/A |
Change Log
- Version 1.1.1
- Added functionality to work over a proxy.
- Version 1.1.0
- Updated the integration to use the latest Joe Sandbox SDK v3.13.0.
- Enhanced the exception handling, and added docstrings.
- Version 1.0.1
- Initial Release
PDF Guides
Document | ThreatQ Version |
---|---|
Joe Sandbox Operation Guide v1.1.1 | 3.6.0 or Greater |
Joe Sandbox Operation Guide v1.1.0 | 3.6.0 or Greater |
Joe Sandbox Operation Guide v1.0.1 | 3.6.0 or Greater |