Zimperium v2
Fetch and investigate mobile security alerts, generated based on anomalous or unauthorized activities detected on a user's mobile device. Compatible with Zimperium 5.X API version.
Network Security · Zimperium
Details
| ID | Zimperium v2 |
|---|---|
| Provider | Liberty Strategic Capital |
| Category | Network Security |
| From Version | 6.9.0 |
| Docker Image | demisto/python3:3.12.13.10116658 |
| Supported Modules | Agentix XSIAM |
README
Fetch and investigate mobile security alerts, generated based on anomalous or unauthorized activities detected on a user’s mobile device.
This integration was integrated and tested with version v.5.24.0 of Zimperium v2.
This is the default integration for this content pack when configured by the Data Onboarder in Cortex XSIAM.
Some changes have been made that might affect your existing content.
If you are upgrading from a previous version of this integration, see Breaking Changes.
Configure Zimperium v2 in Cortex
| Parameter | Description | Required |
|---|---|---|
| Server URL (e.g., https://mtduat.zimperium.com) | True | |
| Client ID | True | |
| Client Secret | True | |
| Fetch incidents | False | |
| Search Params (e.g, severityName=CRITICAL,teamId=myId) | Comma-separated list of search parameters and its values. Same as for the “zimperium-threat-search” command. | False |
| Max fetch | False | |
| First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days) | False | |
| Advanced: Minutes to look back when fetching | Use this parameter to determine how far back to look in the search for incidents that were created before the last run time and did not match the query when they were created. | False |
| Trust any certificate (not secure) | False | |
| Use system proxy settings | False | |
| Module | The module of the application the API is pointing to. Default is “ZIPS”. This parameter is optional but recommended. Leave empty to omit the module parameter from requests. | False |
| Incident type |
Commands
You can execute these commands from the CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.
zimperium-users-search
Search users. Only a user created as a “Team admin” is authorized to perform this request. Also, it will only get information about the teams that this user is associated with. Users that are not part of any team (such as account admin) won’t appear in the response.
Base Command
zimperium-users-search
Input
| Argument Name | Description | Required |
|---|---|---|
| user_id | The ID of the user to search. | Optional |
| page_size | Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. | Optional |
| page | Page number. Default is 0. | Optional |
| limit | Number of total results to return. Default is 50. | Optional |
| team_id | Used to filter the user data by the team the user belongs to. | Optional |
| The email of the user to search. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| Zimperium.User.id | String | The ID of the Zimperium user. |
| Zimperium.User.created | Date | The date and time that the user was created. |
| Zimperium.User.email | String | The email address of the user. |
| Zimperium.User.firstName | String | The first name of the user. |
| Zimperium.User.languagePreference | Unknown | The language preference for the user. |
| Zimperium.User.lastLogin | Unknown | The time of the last login of the user. |
| Zimperium.User.lastName | String | The last name of the user. |
| Zimperium.User.middleName | Unknown | The middle name of the user. |
| Zimperium.User.modified | Date | The date and time that the user was modified. |
| Zimperium.User.notificationEmail | String | The email address for the user’s notifications. |
| Zimperium.User.phone | Unknown | The phone number of the user. |
| Zimperium.User.role.id | String | The role identifier of the user. |
| Zimperium.User.role.name | String | The role name of the user. |
| Zimperium.User.role.scopeBounds | String | The role scope for a user. |
| Zimperium.User.teams.id | String | The ID of the team of the user. |
| Zimperium.User.teams.name | String | The name of the team of the user. |
| Zimperium.User.validated | Boolean | The user’s validated status. |
Command example
!zimperium-users-search user_id="1" team_id="1"
Context Example
{
"Zimperium": {
"User": {
"created": "2024-01-21T11:02:08.789+00:00",
"email": "email1@email.com",
"firstName": "name",
"id": "1",
"languagePreference": null,
"lastLogin": null,
"lastName": "name",
"middleName": null,
"modified": "2024-01-21T11:02:08.789+00:00",
"notificationEmail": "email1@email.com",
"phone": null,
"role": {
"id": "1",
"name": "Team Admin",
"scopeBounds": "TEAM_BOUNDED"
},
"teams": [
{
"id": "1",
"name": "Default"
}
],
"validated": false
}
}
}
Human Readable Output
Users Search Results
Id First Name Last Name Created Role Teams 1 name name email1@email.com 2024-01-21T11:02:08.789+00:00 scopeBounds: TEAM_BOUNDED
name: Team Admin
id: 1{‘name’: ‘Default’, ‘id’: ‘1’}
zimperium-devices-search
Search devices.
Base Command
zimperium-devices-search
Input
| Argument Name | Description | Required |
|---|---|---|
| device_id | The ID of the device to search for. | Optional |
| page_size | Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. | Optional |
| page | Page number. Default is 0. | Optional |
| limit | Number of total results to return. Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| Zimperium.Device.accountId | String | The account identifier of the device. |
| Zimperium.Device.activationName | String | The activation name of the device. |
| Zimperium.Device.additionalDeviceInfo | Unknown | The additional device information. |
| Zimperium.Device.agentType | Number | The agent type of the device. |
| Zimperium.Device.appStatus | String | The app status. |
| Zimperium.Device.appVersions | Unknown | The app version of the device. |
| Zimperium.Device.bundleId | Unknown | The bundle identifier of the device. |
| Zimperium.Device.created | Date | The date and time that the device was created. |
| Zimperium.Device.deleted | Boolean | Whether the device was deleted. |
| Zimperium.Device.developerOptionsOn | Boolean | Whether the developer options are on. |
| Zimperium.Device.deviceOwner.email | String | The email address of the device owner. |
| Zimperium.Device.fullType | String | The device’s full type. |
| Zimperium.Device.groupId | String | The device group identifier. |
| Zimperium.Device.id | String | The unique identifier of the device. |
| Zimperium.Device.lastSeen | Date | The time when the device was last seen. |
| Zimperium.Device.lockScreenUnprotected | Boolean | Whether the device’s lockscreen is unprotected or not. |
| Zimperium.Device.model | String | The model of the device. |
| Zimperium.Device.os.id | Number | The operating system identifier of the device. |
| Zimperium.Device.os.maxOsVersion | String | The maximum operating system version of the device. |
| Zimperium.Device.os.name | String | The operating system name. |
| Zimperium.Device.os.osVersionId | Number | The operating system version identifier of the device. |
| Zimperium.Device.os.policyCompliant | Boolean | Whether the operating system policy is compliant in the device. |
| Zimperium.Device.os.type | String | The operating system type of the device. |
| Zimperium.Device.os.version | String | The operating system version of the device. |
| Zimperium.Device.processed | Boolean | Whether the device is processed. |
| Zimperium.Device.processedAt | Date | The date and time that the device was processed. |
| Zimperium.Device.riskPosture | Number | The risk posture of the device. |
| Zimperium.Device.riskPostureName | String | The risk posture name of the device. |
| Zimperium.Device.teamId | String | The team ID of the device. |
| Zimperium.Device.teamName | String | The team name of the device. |
| Zimperium.Device.threatState | Unknown | The threat state information. |
| Zimperium.Device.zappInstance.agentType | Number | The agent type of the device. |
| Zimperium.Device.zappInstance.buildNumber | String | The build number of the zappInstance. |
| Zimperium.Device.zappInstance.bundleId | String | The bundle identifier of the zappInstance. |
| Zimperium.Device.zappInstance.groupId | String | The Zimperium device group identifier for the zappInstance. |
| Zimperium.Device.zappInstance.id | String | The ID of the zappInstance. |
| Zimperium.Device.zappInstance.lastSeen | Date | The last seen timestamp for the zappInstance. |
| Zimperium.Device.zappInstance.name | String | The name of the zappInstance. |
| Zimperium.Device.zappInstance.policiesInfo | String | The policies information. |
| Zimperium.Device.zappInstance.version | String | The version of the zappInstance. |
| Zimperium.Device.zappInstance.zappId | String | The ID of the zappInstance. |
| Zimperium.Device.zappInstance.zbuildNumber | String | The Zimperium device’s zappInstance. |
| Zimperium.Device.zappInstance.zversion | String | The device’s zappInstance version. |
| Zimperium.Device.zdeviceId | String | The zdevice ID. |
| Zimperium.Device.appVersions.appVersionId | String | The app version ID of the device. |
| Zimperium.Device.appVersions.bundleId | String | The bundle identifier of the app versions. |
| Zimperium.Device.os.maxOsPatchDate | String | The max patch date of operating system of the device. |
| Zimperium.Device.os.patchDate | Date | The operating system patch date of the device. |
| Zimperium.Device.threatState.numberOfCriticalThreats | Number | The number of critical threats detected on the device. |
| Zimperium.Device.zappInstance.permissionsState | Unknown | The permissions state on the device. |
| Zimperium.Device.dormancyProcessed | Boolean | The device’s dormancy processed status. |
| Zimperium.Device.os.versionUpgradeable | Boolean | The operating system version upgradeable for the device. |
| Zimperium.Device.threatState | Unknown | The threat state of the device. |
| Zimperium.Device.zappInstance.policiesInfo | Unknown | The device policies info. |
| Zimperium.Device.isJailbroken | Boolean | Whether the endpoint’s device is jailbroken or not. |
Command example
!zimperium-devices-search device_id="5"
Context Example
{
"Zimperium": {
"Device": {
"accountId": "2",
"additionalDeviceInfo": [],
"agentType": 2,
"appStatus": "ACTIVE",
"appVersions": [],
"bundleId": "com.zimperium",
"created": 1703082619686,
"deleted": false,
"developerOptionsOn": true,
"deviceOwner": {
"email": "email"
},
"dormancyProcessed": false,
"fullType": "iPhone14,5",
"groupId": "1",
"id": "5",
"lastSeen": 1703083587626,
"lockScreenUnprotected": true,
"model": "iphone145",
"os": {
"id": 2,
"maxOsVersion": "17.2",
"name": "ios",
"osVersionId": 57106,
"policyCompliant": false,
"type": "iOS",
"version": "16.3",
"versionUpgradeable": true
},
"processed": true,
"processedAt": 1703082624526,
"riskPosture": 2,
"riskPostureName": "ELEVATED",
"teamId": "1",
"teamName": "Default",
"threatState": {
"addOrRemoveCritical": false,
"addOrRemoveRisky": false,
"criticalThreats": [],
"hadCriticalMitigation": false,
"hadRiskyMitigation": false,
"numberOfRiskyThreats": 5,
"riskyThreats": [
"5"
]
},
"zappInstance": [
{
"agentType": 2,
"buildNumber": "202",
"bundleId": "com.zimperium",
"externalTrackingId1": "",
"externalTrackingId2": "",
"groupId": "1",
"id": "3",
"lastSeen": 1703083587626,
"name": "MTD",
"policiesInfo": [
{
"deployedAt": 1702300970000,
"downloadedAt": 1703082621000,
"hash": "0d",
"type": "Threat iOS"
}
],
"serverlessDetection": false,
"version": "5.2.16",
"zappId": "c2",
"zbuildNumber": "202",
"zversion": "5.2.16"
}
],
"zdeviceId": "AF"
}
}
}
Human Readable Output
Device Search Results
Risk Posture Name Id Model Os Bundle Id Last Seen ELEVATED 5 iphone145 id: 2
name: ios
type: iOS
version: 16.3
versionUpgradeable: true
maxOsVersion: 17.2
osVersionId: 57106
policyCompliant: falsecom.zimperium 2023-12-20 14:46:27
zimperium-report-get
Gets a report.
Base Command
zimperium-report-get
Input
| Argument Name | Description | Required |
|---|---|---|
| importance | The importance of the threat. Possible values are: Low, Medium, High, All. Default is High. | Optional |
| app_version_id | The ID of the app version for which to get a JSON report. Can be retrieved using the zimperium-app-version-list command, in the field “Zimperium.AppVersion.id”. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| Zimperium.Report.ContentInformation | String | The content of the report. |
| Zimperium.Report.glob | Number | The glob pattern for the Zimperium report. |
| Zimperium.Report.platform | String | The platform on which the report was created. |
| Zimperium.Report.report.androidAnalysis | String | The android analysis of the report. |
| Zimperium.Report.report.appProperties | String | The app properties. |
| Zimperium.Report.report.certificate | String | The certificate. |
| Zimperium.Report.report.communications | String | The communications. |
| Zimperium.Report.report.contentInformation | String | The content information of the report. |
| Zimperium.Report.report.distribution | String | The report distribution. |
| Zimperium.Report.report.jsonVersion | String | The JSON version of the report. |
| Zimperium.Report.report.riskProfile | String | The risk profile. |
| Zimperium.Report.report.scanDetails | Unknown | The description of the scan details for the report. |
| Zimperium.Report.report.scanVersion | Unknown | The scan version of the Zimperium report. |
| Zimperium.Report.report.vulnerabilities | Unknown | The vulnerabilities found in the report. |
| Zimperium.Report.result | Number | The Zimperium report result. |
Command example
!zimperium-report-get app_version_id="61" importance="Low"
Context Example
{
"Zimperium": {
"Report": {
"ContentInformation": "Copyright 2024 Zimperium",
"glob": 1,
"platform": "android",
"report": {
"androidAnalysis": {},
"appProperties": {
"extra": {
"itunesAppID": ""
},
"md5": "1",
"name": "Name",
"packageName": "com.url",
"packageSize": 101918436,
"platform": "android",
"sdkVersion": 22,
"sha1": "1",
"sha256": "1",
"version": "2.12.0",
"versionCode": "1"
},
"certificate": {
"SHA1 fingerprint": "1",
"SHA256 fingerprint": "1",
"issuer": {
"CN": "CN",
"O": "O"
},
"owner": {
"CN": "CN",
"O": "O"
}
},
"contentInformation": {
"copyright": "Copyright 2024 Zimperium"
},
"distribution": {
"marketData": []
},
"jsonVersion": "https://json-schema.org/draft/2020-12/schema",
"riskProfile": {
"malwareDetection": "",
"malwareFamily": "",
"malwareName": "",
"overallRisk": "High",
"privacyRisk": 30,
"securityRisk": 79
},
"scanDetails": [
{
"compliance": [],
"description": "The app is using unity",
"importance": "Low",
"kind": "Code Analysis",
"location": [],
"riskType": "security"
}
],
"scanVersion": {
"dynamicScan": false,
"ruleVersion": "1",
"scanDateTime": "2023-12-19T18:49:01+0000",
"scanEngine": "2.6.7",
"scanSucces": "Done",
"scanTargetOS": "android",
"scoreDateTime": "2023-12-19T18:49:00+0000"
},
"vulnerabilities": {}
},
"result": 1
}
}
}
Human Readable Output
Report
Risk Type Kind Description Location Importance security Code Analysis The app is using unity Low privacy Capabilities This app implements the SDK. This SDK has functionality that could create screenshots or screen recordings and potentially send them off device too an external resource. com.sdk Low privacy Backup This app has disabled the backup feature in Android. This can assist in protecting sensitive information from being exposed in the backup location. Low
Base Command
zimperium-threat-search
Input
| Argument Name | Description | Required |
|---|---|---|
| after | The date in the criteria after which the threat occurred. | Required |
| before | The date in the criteria before which the threat occurred. | Optional |
| search_params | A comma-separated list of parameter and their values by which to filter your request. For example: ‘device.os.version=7.1.1,vectorName=Device’. The parameters table is available under “Threat API Details” section in the “Threats” section, of the Zimperium API documentation, or on the website at https://mtduat.zimperium.com/ziap-docs/zips-docs/api/api_details_threat.html#optional-search-parameters-supported. | Optional |
| team_id | Used to filter the user data by the team the user belongs to. | Optional |
| os | Used to filter by the operating system. Possible values are: ios, android. | Optional |
| severity | The severity of the threat. Possible values are: LOW, NORMAL, ELEVATED, CRITICAL. | Optional |
| page_size | Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. | Optional |
| page | Page number. Default is 0. | Optional |
| limit | Number of total results to return. Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| Zimperium.Threat.id | String | The ID of the threat. |
| Zimperium.Threat.accountId | String | The account identifier of the threat. |
| Zimperium.Threat.activationName | String | The activation name of the threat. |
| Zimperium.Threat.agentType | Number | The agent type for the threat. |
| Zimperium.Threat.arpTablesInfo | Unknown | The ARP tables information for the devices. |
| Zimperium.Threat.categoryId | Number | The category of the threat. |
| Zimperium.Threat.classification | Number | The classification of the threat. |
| Zimperium.Threat.classificationName | String | The classification name for the threat. |
| Zimperium.Threat.detectionFiles | Unknown | The threat detection files. |
| Zimperium.Threat.device.id | String | The unique identifier of the device. |
| Zimperium.Threat.device.mamDeviceId | String | The mobile application management (MAM) ID of the device. |
| Zimperium.Threat.device.mdmDeviceId | String | The mobile device management (MDM) ID of the device. |
| Zimperium.Threat.device.model | String | The model of the device the threat was detected on. |
| Zimperium.Threat.device.os.id | Number | The operating system identifier of the device the threat was detected on. |
| Zimperium.Threat.device.os.name | String | The operating system name for the device. |
| Zimperium.Threat.device.os.version | String | The operating system version of the device. |
| Zimperium.Threat.device.zdeviceId | String | The zDevice ID of the device. |
| Zimperium.Threat.deviceId | String | The unique identifier of the device the threat was detected on. |
| Zimperium.Threat.deviceOwner | String | The owner of the device. |
| Zimperium.Threat.eventProcessedTimestamp | Date | The timestamp when the threat event was processed. |
| Zimperium.Threat.eventReceivedTimestamp | Date | The timestamp when the threat event was received. |
| Zimperium.Threat.generalInfo.actionTriggered | String | The threat action triggered on a threat. |
| Zimperium.Threat.generalInfo.bssid | String | The Basic Service Set Identifier (BSSID) of the threat. |
| Zimperium.Threat.generalInfo.deviceTimestamp | Date | The timestamp of the endpoint’s device. |
| Zimperium.Threat.generalInfo.jailbreakReasons | String | The jailbreak reasons for the threat. |
| Zimperium.Threat.generalInfo.ssid | String | The service set identifier (SSID) for the threat. |
| Zimperium.Threat.generalInfo.timeInterval | Number | The time interval for a threat. |
| Zimperium.Threat.groupId | String | The ID of the threat group. |
| Zimperium.Threat.lastModified | Date | The time the threat was last modified. |
| Zimperium.Threat.mitigationEvents | Unknown | The mitigation events for the threat. |
| Zimperium.Threat.nearByNetworks | Unknown | The nearby networks for the threat. |
| Zimperium.Threat.networkStatistics | Unknown | The Zimperium threat network statistics. |
| Zimperium.Threat.os | String | The operating system. |
| Zimperium.Threat.policiesInfo.deployedAt | Date | The date that the threat policy was deployed. |
| Zimperium.Threat.policiesInfo.downloadedAt | Date | The date when the threat policy was downloaded. |
| Zimperium.Threat.policiesInfo.hash | String | The hash of the threat policy information. |
| Zimperium.Threat.policiesInfo.type | String | The threat policy type. |
| Zimperium.Threat.processList.parentProcessId | String | The parent process ID for a threat’s process. |
| Zimperium.Threat.processList.processId | String | The process ID for the threat process. |
| Zimperium.Threat.processList.processName | String | The process name for the threat. |
| Zimperium.Threat.processList.service | String | The services associated with the process list. |
| Zimperium.Threat.processList.user | String | The users and processes that are involved in the threat process. |
| Zimperium.Threat.responses.eventId | String | The unique identifier for an event in the threat response. |
| Zimperium.Threat.responses.responseId | Number | The response identifier for a threat’s response. |
| Zimperium.Threat.responses.timestamp | Date | The timestamp of the threat response. |
| Zimperium.Threat.runningServices | Unknown | The running services. |
| Zimperium.Threat.severity | Number | The severity of the threat. |
| Zimperium.Threat.severityName | String | The severity name of the threat. |
| Zimperium.Threat.simulated | Boolean | Is the threat simulated. |
| Zimperium.Threat.state | Number | The threat state. |
| Zimperium.Threat.suspiciousUrlInfo | Unknown | The suspicious URL information. |
| Zimperium.Threat.teamId | String | The ID of the threat team for an incident. |
| Zimperium.Threat.teamName | String | The threat team name for the Incident. |
| Zimperium.Threat.threatTypeId | Number | The threat type identifier for the threat. |
| Zimperium.Threat.threatTypeName | String | The threat type for the threat. |
| Zimperium.Threat.timestamp | Date | The timestamp of the threat. |
| Zimperium.Threat.timestampInfo | Unknown | The timestamp information of the threat. |
| Zimperium.Threat.vector | Number | The threat vector for the incident. |
| Zimperium.Threat.vectorName | String | The vector name for a threat. |
| Zimperium.Threat.zappId | String | The Zimperium threat app identifier. |
| Zimperium.Threat.zappInstance | Unknown | The threat Zapp instance information. |
| Zimperium.Threat.zappInstanceId | String | The Zapp threat instance ID. |
| Zimperium.Threat.zeventId | String | The Zimperium threat event identifier. |
| Zimperium.Threat.arpTablesInfo | Unknown | The ARP tables info for the threat. |
| Zimperium.Threat.locationInfo.geoPoint.lat | Number | The latitude of the geoPoint. |
| Zimperium.Threat.locationInfo.geoPoint.lon | Number | The longitude of the geoPoint. |
| Zimperium.Threat.locationInfo.source | String | The threat’s source location information. |
| Zimperium.Threat.generalInfo.expectedOsVersion | String | The expected operating system version for the threat. |
| Zimperium.Threat.generalInfo.vulnerableOsVersion | String | The vulnerable operating system version for the threat. |
| Zimperium.Threat.generalInfo.vulnerableSecurityPatch | String | The vulnerable security patch for the endpoint. |
| Zimperium.Threat.mitigatedAt | Date | The date when the Threat was mitigated. |
Command example
!zimperium-threat-search after="3 month" team_id="33" limit=1
Context Example
{
"Zimperium": {
"Threat": {
"accountId": "25",
"activationName": "user@email.com",
"agentType": 2,
"arpTablesInfo": {
"before": [
{
"ip": "1.1.1.1",
"mac": "1.1.1.1"
}
]
},
"categoryId": 15,
"classification": 1,
"classificationName": "CRITICAL",
"detectionFiles": [],
"device": {
"id": "6",
"mamDeviceId": "",
"mdmDeviceId": "",
"model": "ONEPLUS A5000",
"os": {
"id": 1,
"name": "ANDROID",
"version": "7.1.1"
},
"zdeviceId": "5"
},
"deviceId": "6",
"deviceOwner": "user@email.com",
"eventProcessedTimestamp": 1702393167374,
"eventReceivedTimestamp": 1702393167359,
"generalInfo": {
"actionTriggered": "Silent Alert",
"deviceTimestamp": 1702393165000,
"jailbreakReasons": "SELinux disabled",
"timeInterval": 8
},
"groupId": "37",
"id": "d7",
"lastModified": 1702393165000,
"mitigationEvents": [],
"nearByNetworks": [],
"networkStatistics": [],
"os": "android",
"policiesInfo": [
{
"deployedAt": 1701806956000,
"downloadedAt": 1702393157000,
"type": "App Policy Android v2"
}
],
"processList": [
{
"parentProcessId": "1585",
"processId": "7839",
"processName": "com.zimperium",
"service": "n/a",
"user": "1"
}
],
"responses": [
{
"eventId": "1",
"responseId": 3,
"timestamp": 1702393165000
}
],
"runningServices": [],
"severity": 3,
"severityName": "CRITICAL",
"simulated": false,
"state": 1,
"suspiciousUrlInfo": {},
"teamId": "33",
"teamName": "Default",
"threatTypeId": 37,
"threatTypeName": "SYSTEM TAMPERING",
"timestamp": 1702393165000,
"timestampInfo": {
"timestamp": 1702393165000,
"toTheDay": 1702339200000,
"toTheHour": 1702389600000,
"toTheMinute": 1702393140000,
"toTheSecond": 1702393165000
},
"vector": 2,
"vectorName": "Device",
"zappId": "40",
"zappInstance": {
"buildNumber": "230829190",
"bundleId": "com.zimperium",
"id": "63",
"name": "MTD",
"version": "5.2.14",
"zbuildNumber": "23082919",
"zversion": "5.2.14"
},
"zappInstanceId": "63",
"zeventId": "a1"
}
}
}
Human Readable Output
Threat Search Result
Id Severity Name State Vector Name Threat Type Name Os Device Owner Device Id Team Name Timestamp d7 CRITICAL 1 Device SYSTEM TAMPERING android user@email.com 6 Default 2023-12-12 14:59:25
zimperium-app-version-list
List the app versions.
Base Command
zimperium-app-version-list
Input
| Argument Name | Description | Required |
|---|---|---|
| bundle_id | The bundle ID of the app for which to get its app version. | Optional |
| page_size | Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. | Optional |
| page | Page number. Default is 0. | Optional |
| limit | Number of total results to return. Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| Zimperium.AppVersion.id | String | The ID of the threat. |
| Zimperium.AppVersion.accountId | String | The account identifier for the Zimperium app version. |
| Zimperium.AppVersion.bundleId | String | The bundle identifier for the Zimperium app version. |
| Zimperium.AppVersion.classification | String | The classification of the Zimperium app version. |
| Zimperium.AppVersion.created | Date | When the app version was created. |
| Zimperium.AppVersion.hash | String | The hash of the Zimperium app version. |
| Zimperium.AppVersion.name | String | The name of the Zimperium app version. |
| Zimperium.AppVersion.platform | String | The platform on which the Zimperium app version is running. |
| Zimperium.AppVersion.platformId | Number | The platform identifier for the Zimperium app version. |
| Zimperium.AppVersion.privacy | String | The privacy setting for the app version. |
| Zimperium.AppVersion.privacyRisk | Number | The privacy risk for the Zimperium app version. |
| Zimperium.AppVersion.processState | String | The process state of the app version. |
| Zimperium.AppVersion.reportRequestId | String | The Zimperium app version report request ID. |
| Zimperium.AppVersion.riskVersion | String | The risk version of the Zimperium app version. |
| Zimperium.AppVersion.security | String | The security of the Zimperium app version. |
| Zimperium.AppVersion.securityRisk | Number | The security risk of the Zimperium app version. |
| Zimperium.AppVersion.source | String | The Zimperium app version source. |
| Zimperium.AppVersion.updatedOn | Date | The date and time when the app version was updated. |
| Zimperium.AppVersion.version | String | The version of the Zimperium app version. |
| Zimperium.AppVersion.developerName | String | The developer name for the Zimperium app version. |
| Zimperium.AppVersion.developerSignature | String | The developer signature for the Zimperium app version. |
| Zimperium.AppVersion.filename | String | The filename of the Zimperium app version. |
| Zimperium.AppVersion.managed | Boolean | Whether the app version is managed. |
Command example
!zimperium-app-version-list bundle_id="com.url"
Context Example
{
"Zimperium": {
"AppVersion": [
{
"accountId": "2",
"bundleId": "com.url",
"classification": "LEGIT",
"created": 1702304668599,
"hash": "E3",
"id": "7",
"name": "Name",
"platform": "android",
"platformId": 1,
"privacy": "Low",
"privacyRisk": 30,
"processState": "AVAILABLE",
"reportRequestId": "E3",
"riskVersion": "2.12.0",
"security": "High",
"securityRisk": 79,
"source": "UPLOAD",
"updatedOn": 1702308488217,
"version": "2.12.0"
},
{
"accountId": "2",
"bundleId": "com.url",
"classification": "LEGIT",
"created": 1702305485276,
"developerName": "TShih",
"developerSignature": "02",
"filename": "/tmp/sample",
"hash": "04",
"id": "61",
"managed": false,
"name": "Name",
"platform": "android",
"platformId": 1,
"privacy": "Low",
"privacyRisk": 30,
"processState": "AVAILABLE",
"riskVersion": "2.12.0",
"security": "High",
"securityRisk": 79,
"source": "GLOBAL",
"updatedOn": 1702308488294,
"version": "2.12.0"
}
]
}
}
Human Readable Output
App Version List
Id Name Bundle Id Version Platform Security Privacy Classification Developer Name Created Updated On 7 Name com.url 2.12.0 android High Low LEGIT 2023-12-11 14:24:28 2023-12-11 15:28:08 61 Name com.url 2.12.0 android High Low LEGIT TShih 2023-12-11 14:38:05 2023-12-11 15:28:08
zimperium-get-devices-by-cve
Gets a devices associated with a specific CVE.
Base Command
zimperium-get-devices-by-cve
Input
| Argument Name | Description | Required |
|---|---|---|
| cve_id | The ID of the CVE which is input. | Required |
| after | The date in the criteria after which the threat occurred. | Optional |
| before | The date in the criteria before which the threat occurred. | Optional |
| team_id | Used to filter the user data by the team the user belongs to. | Optional |
| page_size | Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. | Optional |
| page | Page number. Default is 0. | Optional |
| limit | Number of total results to return. Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| Zimperium.DeviceByCVE.id | String | The ID of the device. |
| Zimperium.DeviceByCVE.cveId | String | The ID of the CVE. |
| Zimperium.DeviceByCVE.os.id | Number | The operating system identifier of the device. |
| Zimperium.DeviceByCVE.os.maxOsPatchDate | String | The device operating system max patch date. |
| Zimperium.DeviceByCVE.os.maxOsVersion | String | The device operating system max version. |
| Zimperium.DeviceByCVE.os.name | String | The operating system name of the device. |
| Zimperium.DeviceByCVE.os.osVersionId | Number | The operating system version identifier of the device. |
| Zimperium.DeviceByCVE.os.patchDate | Date | The patch date for of the operating system. |
| Zimperium.DeviceByCVE.os.policyCompliant | Boolean | Whether the operating system policy is compliant with the device. |
| Zimperium.DeviceByCVE.os.type | String | The operating system type of the device. |
| Zimperium.DeviceByCVE.os.version | String | The operating system version of the device. |
| Zimperium.DeviceByCVE.os.versionUpgradeable | Boolean | Whether the operating system version was upgradeable. |
| Zimperium.DeviceByCVE.teamId | String | The team ID of the device. |
| Zimperium.DeviceByCVE.zdeviceId | String | The zdevice ID of the device. |
Command example
!zimperium-get-devices-by-cve cve_id="CVE-2021-1886" limit=1
Context Example
{
"Zimperium": {
"DeviceCVE": {
"id": "6",
"cveId": "CVE-2021-1886",
"os": {
"id": 1,
"maxOsPatchDate": "20200901",
"maxOsVersion": "10",
"name": "android",
"osVersionId": 57063,
"patchDate": "2017-09-01",
"policyCompliant": false,
"type": "Android",
"version": "7.1.1",
"versionUpgradeable": true
},
"teamId": "33",
"zdeviceId": "5"
}
}
}
Human Readable Output
Devices Associated with CVE-2021-1886
Id Zdevice Id Team Id Os 6 5 33 id: 1
name: android
type: Android
version: 7.1.1
patchDate: 2017-09-01
versionUpgradeable: true
maxOsVersion: 10
maxOsPatchDate: 20200901
osVersionId: 57063
policyCompliant: false
zimperium-devices-os-version
Gets devices associated with a specific operating system version.
Base Command
zimperium-devices-os-version
Input
| Argument Name | Description | Required |
|---|---|---|
| os_version | The name of the version which is input. Can be retrieved using zimperium-devices-search command under “Zimperium.Device.os.version”. | Required |
| os_patch_date | The date of the patch for a specific version. The date format is YYYY-MM-DD. This field is only applicable to Android. If you include this field, only CVEs for Android are returned since this value does not apply to iOS. | Optional |
| deleted | This is used to request the devices that have been deleted. Possible values are: true, false. | Optional |
| after | The date in the criteria after which the threat occurred. | Optional |
| before | The date in the criteria before which the threat occurred. | Optional |
| team_id | This is used to filter the data to their respective teams. | Optional |
| page_size | Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. | Optional |
| page | Page number. Default is 0. | Optional |
| limit | Number of total results to return. Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| Zimperium.DeviceOsVersion.id | String | The ID of the device. |
| Zimperium.DeviceOsVersion.os.id | Number | The operating system identifier of the device. |
| Zimperium.DeviceOsVersion.os.maxOsPatchDate | String | The device operating system max patch date. |
| Zimperium.DeviceOsVersion.os.maxOsVersion | String | The device operating system max version. |
| Zimperium.DeviceOsVersion.os.name | String | The operating system name of the device. |
| Zimperium.DeviceOsVersion.os.osVersionId | Number | The operating system version identifier of the device. |
| Zimperium.DeviceOsVersion.os.patchDate | Date | The patch date of the device’s operating system. |
| Zimperium.DeviceOsVersion.os.policyCompliant | Boolean | Whether the endpoint’s operating system is compliant with the policy. |
| Zimperium.DeviceOsVersion.os.type | String | The operating system type. |
| Zimperium.DeviceOsVersion.os.version | String | The operating system version. |
| Zimperium.DeviceOsVersion.os.versionUpgradeable | Boolean | Whether the device’s operating system is upgradeable. |
| Zimperium.DeviceOsVersion.teamId | String | The team ID of the device. |
| Zimperium.DeviceOsVersion.zdeviceId | String | The zdevice ID of the device. |
Command example
!zimperium-devices-os-version os_version="9"
Context Example
{
"Zimperium": {
"DeviceOsVersion": {
"id": "2a",
"os": {
"id": 1,
"maxOsPatchDate": "20230501",
"maxOsVersion": "13",
"name": "android",
"osVersionId": 57062,
"patchDate": "2019-08-05",
"policyCompliant": false,
"type": "Android",
"version": "9",
"versionUpgradeable": true
},
"teamId": "1",
"zdeviceId": "a8"
}
}
}
Human Readable Output
Device Os Version
Id Team Id Os 2a 1 id: 1
name: android
type: Android
version: 9
patchDate: 2019-08-05
versionUpgradeable: true
maxOsVersion: 13
maxOsPatchDate: 20230501
osVersionId: 57062
policyCompliant: false
zimperium-get-cves-by-device
Gets the CVEs associated with a specific device.
Base Command
zimperium-get-cves-by-device
Input
| Argument Name | Description | Required |
|---|---|---|
| device_id | The device ID to get CVEs for. | Required |
| page_size | Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. | Optional |
| page | Page number. Default is 0. | Optional |
| limit | Number of total results to return. Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| Zimperium.CVEByDevice.id | String | The ID of the CVE. |
| Zimperium.CVEByDevice.deviceId | String | The ID of the device. |
| Zimperium.CVEByDevice.activeExploit | Boolean | Whether the CVE is active or not. |
| Zimperium.CVEByDevice.exploitPocUrl.exploitPocUrls | Unknown | The exploit POC URLs for the CVE. |
| Zimperium.CVEByDevice.severity | String | The severity of a CVE on the device. |
| Zimperium.CVEByDevice.type | String | The CVE type. |
| Zimperium.CVEByDevice.url | String | The URL of the CVE. |
Command example
!zimperium-get-cves-by-device device_id="2a"
Context Example
{
"Zimperium": {
"CVEDevice": [
{
"activeExploit": false,
"exploitPocUrl": {
"exploitPocUrls": []
},
"id": "CVE-2019-2173",
"severity": "High",
"type": "Elevation of privilege",
"url": "https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-2173",
"deviceId": "2a"
},
{
"activeExploit": false,
"exploitPocUrl": {
"exploitPocUrls": []
},
"id": "CVE-2019-2176",
"severity": "Critical",
"type": "Remote code execution",
"url": "https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-2176",
"deviceId": "2a"
}
]
}
}
Human Readable Output
CVE on Device 2a
Id Type Severity Url Active Exploit Exploit Poc Url CVE-2019-2173 Elevation of privilege High https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-2173 false exploitPocUrls: CVE-2019-2176 Remote code execution Critical https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2019-2176 false exploitPocUrls:
zimperium-vulnerability-get
Gets the vulnerabilities.
Base Command
zimperium-vulnerability-get
Input
| Argument Name | Description | Required |
|---|---|---|
| page_size | Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. | Optional |
| page | Page number. Default is 0. | Optional |
| limit | Number of total results to return. Default is 50. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| Zimperium.Vulnerability.id | String | The ID of the vulnerability. |
| Zimperium.Vulnerability.blueBorneVulnerable | Boolean | Whether the operating system is blue born vulnerable. |
| Zimperium.Vulnerability.cveCount | Number | Number of CVEs on the operating system. |
| Zimperium.Vulnerability.lastCveSync | Date | The date of the last CVE sync. |
| Zimperium.Vulnerability.os | Number | The vulnerability operating system. |
| Zimperium.Vulnerability.osPatchDate | Unknown | The max patch date of operating system. |
| Zimperium.Vulnerability.osRiskChecksum | String | The operating system risk checksum. |
| Zimperium.Vulnerability.osVersion | String | The operating system version. |
| Zimperium.Vulnerability.osVersionAndPatchDate | String | The operating system version and the patch date. |
| Zimperium.Vulnerability.risk | String | The risk classification. |
Command example
!zimperium-vulnerability-get limit=1
Context Example
{
"Zimperium": {
"Vulnerability": {
"blueBorneVulnerable": false,
"cveCount": 432,
"id": 56745,
"lastCveSync": 1707218387516,
"os": 2,
"osPatchDate": null,
"osRiskChecksum": "6A",
"osVersion": "14.6",
"osVersionAndPatchDate": "14.6",
"risk": "Critical"
}
}
}
Human Readable Output
Vulnerabilities List
Id Os Os Version And Patch Date Os Version Os Patch Date Risk Cve Count Last Cve Sync Os Risk Checksum Blue Borne Vulnerable 56745 2 14.6 14.6 Critical 432 2024-02-06 11:19:47 6A false
zimperium-policy-group-list
Get policy groups.
Base Command
zimperium-policy-group-list
Input
| Argument Name | Description | Required |
|---|---|---|
| module | The module parameter is required to get the groups related to EMM connection or ZIPS connection. If provided, this command argument takes priority over the integration’s “Module” parameter. Default is “ZIPS”. Possible values are: EMM, ZIPS. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| Zimperium.PolicyGroup.id | String | The ID of the policy group. |
| Zimperium.PolicyGroup.accountId | String | The account identifier for the policy group’s content. |
| Zimperium.PolicyGroup.appPolicyId | String | The app policy ID of the policy group. |
| Zimperium.PolicyGroup.appSettingsId | String | The app settings ID of the policy group. |
| Zimperium.PolicyGroup.brandingPolicyId | Unknown | The branding policy identifier of the policy group. |
| Zimperium.PolicyGroup.created | Date | The date and time the policy group was created. |
| Zimperium.PolicyGroup.description | String | The description of the policy group. |
| Zimperium.PolicyGroup.dormancyPolicyId | String | The dormancy policy identifier of the policy group. |
| Zimperium.PolicyGroup.emmConnectionId | Unknown | The enterprise mobile management (EMM) connection ID of the policy group. |
| Zimperium.PolicyGroup.emmGroupId | Unknown | The enterprise mobile management (EMM) group ID of the policy group. |
| Zimperium.PolicyGroup.emmPriority | Unknown | The enterprise mobile management (EMM) priority of the policy group. |
| Zimperium.PolicyGroup.extensionPolicyId | String | The extension policy identifier of the policy group. |
| Zimperium.PolicyGroup.content.global | Boolean | Whether the policy group is global. |
| Zimperium.PolicyGroup.knoxPolicyId | Unknown | The Knox policy ID of the policy group. |
| Zimperium.PolicyGroup.modified | Date | The date and time when the policy group was last modified. |
| Zimperium.PolicyGroup.name | String | The name of the policy group. |
| Zimperium.PolicyGroup.networkPolicyId | String | The network policy ID of the policy group. |
| Zimperium.PolicyGroup.osRiskPolicyId | String | The operating system risk policy ID of the policy group. |
| Zimperium.PolicyGroup.phishingPolicyId | String | The phishing policy identifier of the policy group. |
| Zimperium.PolicyGroup.privacyId | String | The privacy identifier of the policy group. |
| Zimperium.PolicyGroup.team.id | String | The ID of the team associated with the policy group. |
| Zimperium.PolicyGroup.team.name | String | The team name of the policy group. |
| Zimperium.PolicyGroup.trmId | String | The Threat Response Matrix (TRM) ID of the policy group. |
| Zimperium.PolicyGroup.team | Unknown | The policy group’s team information. |
zimperium-policy-privacy-get
Get a privacy policy by its identifier.
Base Command
zimperium-policy-privacy-get
Input
| Argument Name | Description | Required |
|---|---|---|
| policy_id | The identifier of the policy. Can be retrieved using zimperium-policy-group-list in the Zimperium.PolicyGroup.privacyId field. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| Zimperium.PolicyPrivacy.id | String | The policy privacy identifier. |
| Zimperium.PolicyPrivacy.accountId | String | The account identifier of the policy. |
| Zimperium.PolicyPrivacy.assigned | Boolean | Whether the policy privacy is assigned. |
| Zimperium.PolicyPrivacy.created | Date | The date and time the policy was created. |
| Zimperium.PolicyPrivacy.global | Boolean | Whether the policy settings are global. |
| Zimperium.PolicyPrivacy.groups | String | The groups the policy are associated with. |
| Zimperium.PolicyPrivacy.jsonHash | String | The JSON hash for the policy privacy policy. |
| Zimperium.PolicyPrivacy.locationAccuracy | Number | The location accuracy for the policy. |
| Zimperium.PolicyPrivacy.modified | Date | The date and time when the policy was modified. |
| Zimperium.PolicyPrivacy.name | String | The name of the policy. |
| Zimperium.PolicyPrivacy.protoHash | String | The hash of the policy. |
| Zimperium.PolicyPrivacy.rules | Unknown | The policy rules list. |
| Zimperium.PolicyPrivacy.rules.id | String | The ID of the rule. |
| Zimperium.PolicyPrivacy.team | Unknown | The team for the policy. |
| Zimperium.PolicyPrivacy.teamId | Unknown | The team ID the policy is associated with. |
Command example
!zimperium-policy-privacy-get policy_id="a2"
Context Example
{
"Zimperium": {
"PolicyPrivacy": {
"accountId": "2",
"assigned": true,
"created": "2023-12-05T20:09:16.621+00:00",
"global": true,
"groups": [
{
"accountId": "2",
"created": "2024-01-22T11:37:36.749+00:00",
"description": "test",
"emm": false,
"global": false,
"groupActivations": [],
"id": "65",
"modified": "2024-01-22T11:37:36.749+00:00",
"name": "Test",
"staticFilesWritten": "2024-02-05T06:00:03.460+00:00",
"userActivations": [],
"zapps": []
},
{
"accountId": "2",
"created": "2023-12-05T20:09:16.621+00:00",
"description": "Default Group",
"emm": false,
"global": true,
"groupActivations": [],
"id": "37",
"modified": "2023-12-05T20:09:16.621+00:00",
"name": "Default Group",
"staticFilesWritten": "2024-02-06T06:00:37.129+00:00",
"userActivations": [
{
"id": "40"
}
],
"zapps": []
}
],
"id": "a2",
"jsonHash": "7d",
"locationAccuracy": 0,
"modified": "2023-12-05T20:09:16.853+00:00",
"name": "Default",
"rules": [
{
"collectibleId": 0,
"id": "3b",
"shouldCollect": false
}
],
"staticFilesWritten": "2023-12-05T20:09:19.079+00:00",
"team": null,
"teamId": null
}
}
}
Human Readable Output
Privacy Policy
Id Name Created Modified a2 Default 2023-12-05T20:09:16.621+00:00 2023-12-05T20:09:16.853+00:00
zimperium-policy-threat-get
Get a threat policy by its identifier.
Base Command
zimperium-policy-threat-get
Input
| Argument Name | Description | Required |
|---|---|---|
| policy_id | The identifier of the policy. Can be retrieved using zimperium-policy-group-list in the Zimperium.PolicyGroup.trmId field. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| Zimperium.PolicyThreat.id | String | The identifier of the policy. |
| Zimperium.PolicyThreat.accountId | String | The account identifier of the policy. |
| Zimperium.PolicyThreat.androidJsonHash | String | The Android JSON hash. |
| Zimperium.PolicyThreat.androidProtoHash | String | The Android Proto hash. |
| Zimperium.PolicyThreat.assigned | Boolean | Whether the policy is assigned. |
| Zimperium.PolicyThreat.created | Date | The date and time the policy threat was created. |
| Zimperium.PolicyThreat.deploymentDate | Date | The date when the policy deployment occurred. |
| Zimperium.PolicyThreat.global | Boolean | Whether the policy settings are global. |
| Zimperium.PolicyThreat.groups | Unknown | The groups the policy are associated with. |
| Zimperium.PolicyThreat.iosJsonHash | String | IOS JSON hash. |
| Zimperium.PolicyThreat.iosProtoHash | String | IOS Proto hash. |
| Zimperium.PolicyThreat.isDeployed | Boolean | Whether the policy threat is deployed or not. |
| Zimperium.PolicyThreat.modified | Date | The date and time when the policy was modified. |
| Zimperium.PolicyThreat.name | String | The name of the policy. |
| Zimperium.PolicyThreat.rules | Unknown | The policy rules list. |
| Zimperium.PolicyThreat.rules.id | String | The ID of the policy rule. |
Command example
!zimperium-policy-threat-get policy_id="er"
Context Example
{
"Zimperium": {
"PolicyThreat": {
"accountId": "2",
"androidJsonHash": "eb",
"androidProtoHash": "4f",
"assigned": true,
"created": "2023-12-05T20:09:16.621+00:00",
"deploymentDate": "2023-12-05T20:09:18.474+00:00",
"emm": false,
"global": true,
"groups": [
{
"accountId": "2",
"created": "2024-01-22T11:37:36.749+00:00",
"description": "test",
"emm": false,
"global": false,
"groupActivations": [],
"id": "65",
"modified": "2024-01-22T11:37:36.749+00:00",
"name": "Test",
"staticFilesWritten": "2024-02-05T06:00:03.460+00:00",
"userActivations": [],
"zapps": []
},
{
"accountId": "2",
"created": "2023-12-05T20:09:16.621+00:00",
"description": "Default Group",
"emm": false,
"global": true,
"groupActivations": [],
"id": "37",
"modified": "2023-12-05T20:09:16.621+00:00",
"name": "Default Group",
"staticFilesWritten": "2024-02-06T06:00:37.129+00:00",
"userActivations": [
{
"id": "40"
}
],
"zapps": []
}
],
"id": "er",
"iosJsonHash": "eb",
"iosProtoHash": "4f",
"isDeployed": true,
"modified": "2023-12-05T20:09:17.184+00:00",
"name": "Default",
"rules": [
{
"alertUser": false,
"customResponses": [],
"id": "b9",
"legacyMdmMitigationAction": null,
"legacyMdmThreatAction": null,
"mdmMitigationAction": null,
"mdmMitigationTarget": null,
"mdmThreatAction": null,
"mdmThreatTarget": null,
"responses": [],
"severity": 0,
"shouldCollect": true,
"threatTypeId": 0
}
],
"staticFilesWritten": "2023-12-05T20:09:18.129+00:00"
}
}
}
Human Readable Output
Threat Policy
Id Is Deployed Name Created Modified er true Default 2023-12-05T20:09:16.621+00:00 2023-12-05T20:09:17.184+00:00
zimperium-policy-phishing-get
Get a phishing policy by its identifier.
Base Command
zimperium-policy-phishing-get
Input
| Argument Name | Description | Required |
|---|---|---|
| policy_id | The identifier of the policy. Can be retrieved using zimperium-policy-group-list in the Zimperium.PolicyGroup.phishingPolicyId field. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| Zimperium.PolicyPhishing.id | String | The identifier of the policy. |
| Zimperium.PolicyPhishing.accessControlList | Unknown | The access control list for the policy resource. |
| Zimperium.PolicyPhishing.accountId | String | The account identifier of the policy. |
| Zimperium.PolicyPhishing.allowEndUserControl | Boolean | Whether the end user is allowed to control the policy. |
| Zimperium.PolicyPhishing.contentCategoryActionList | Unknown | The content of the policy category action. |
| Zimperium.PolicyPhishing.created | Date | The date and time the policy threat was created. |
| Zimperium.PolicyPhishing.enableDnsPhishingTutorial | Boolean | Whether the DNS phishing tutorial is enabled. |
| Zimperium.PolicyPhishing.enableMessageFilterTutorial | Boolean | Whether the message filter tutorial is enabled. |
| Zimperium.PolicyPhishing.enableSafariBrowserExtensionTutorial | Boolean | Whether the Safari Browser Extension tutorial is enabled. |
| Zimperium.PolicyPhishing.global | Boolean | Whether the policy settings are global. |
| Zimperium.PolicyPhishing.groups | Unknown | The groups the policy are associated with. |
| Zimperium.PolicyPhishing.isDnsEnabled | Boolean | Whether DNS is enabled or not. |
| Zimperium.PolicyPhishing.modified | Date | The date and time when the policy was modified. |
| Zimperium.PolicyPhishing.name | String | The name of the policy. |
| Zimperium.PolicyPhishing.phishingDetectionAction | String | The phishing detection action. |
| Zimperium.PolicyPhishing.phishingPolicyType | String | The phishing policy type. |
| Zimperium.PolicyPhishing.team | Unknown | The team the policy is associated with. |
| Zimperium.PolicyPhishing.teamId | Unknown | The ID of the team. |
| Zimperium.PolicyPhishing.useLocalVpn | Boolean | Whether to use a local VPN or not. |
| Zimperium.PolicyPhishing.useRemoteContentInspection | Boolean | Whether to use remote content inspection. |
| Zimperium.PolicyPhishing.useUrlSharing | Boolean | Whether the URL sharing is enabled or not. |
Command example
!zimperium-policy-phishing-get policy_id="2"
Context Example
{
"Zimperium": {
"PolicyPhishing": {
"accessControlList": null,
"accountId": "2",
"allowEndUserControl": false,
"contentCategoryActionList": [],
"created": "2023-12-05T20:09:16.621+00:00",
"enableDnsPhishingTutorial": false,
"enableMessageFilterTutorial": true,
"enableSafariBrowserExtensionTutorial": true,
"global": true,
"groups": [
{
"accountId": "2",
"created": "2024-01-22T11:37:36.749+00:00",
"description": "test",
"emm": false,
"global": false,
"groupActivations": [],
"id": "65",
"modified": "2024-01-22T11:37:36.749+00:00",
"name": "Test",
"staticFilesWritten": "2024-02-05T06:00:03.460+00:00",
"userActivations": [],
"zapps": []
},
{
"accountId": "2",
"created": "2023-12-05T20:09:16.621+00:00",
"description": "Default Group",
"emm": false,
"global": true,
"groupActivations": [],
"id": "37",
"modified": "2023-12-05T20:09:16.621+00:00",
"name": "Default Group",
"staticFilesWritten": "2024-02-06T06:00:37.129+00:00",
"userActivations": [
{
"id": "40"
}
],
"zapps": []
}
],
"id": "2",
"isDnsEnabled": false,
"modified": "2023-12-11T13:33:08.481+00:00",
"name": "Default",
"phishingDetectionAction": "WARN",
"phishingPolicyType": "ON_DEVICE",
"team": null,
"teamId": null,
"useLocalVpn": true,
"useRemoteContentInspection": true,
"useUrlSharing": true
}
}
}
Human Readable Output
Phishing Policy
Id Name Created Modified Enable Safari Browser Extension Tutorial Enable Dns Phishing Tutorial Use Local Vpn Use Url Sharing Allow End User Control Use Remote Content Inspection Enable Message Filter Tutorial Phishing Detection Action Phishing Policy Type 2 Default 2023-12-05T20:09:16.621+00:00 2023-12-11T13:33:08.481+00:00 true false true true false true true WARN ON_DEVICE
zimperium-policy-app-settings-get
List the app versions.
Base Command
zimperium-policy-app-settings-get
Input
| Argument Name | Description | Required |
|---|---|---|
| app_settings_policy_id | The identifier of the policy. Can be retrieved using zimperium-policy-group-list in the Zimperium.PolicyGroup.appSettingsId field. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| Zimperium.PolicyAppSetting.id | String | The identifier of the policy. |
| Zimperium.PolicyAppSetting.accountId | String | The account identifier of the policy. |
| Zimperium.PolicyAppSetting.appRiskLookupEnabled | Boolean | Whether the app risk lookup is enabled or not. |
| Zimperium.PolicyAppSetting.assigned | Boolean | Whether the policy is assigned. |
| Zimperium.PolicyAppSetting.autoActivateKnox | Boolean | Whether Knox should be automatically activated. |
| Zimperium.PolicyAppSetting.autoBatteryOptimizationEnabled | Boolean | Whether the battery optimization is enabled. |
| Zimperium.PolicyAppSetting.cogitoEnabled | Boolean | Whether the cogito is enabled. |
| Zimperium.PolicyAppSetting.cogitoThreshold | Number | The cogito threshold. |
| Zimperium.PolicyAppSetting.created | Date | The date and time the policy was created. |
| Zimperium.PolicyAppSetting.dangerzoneEnabled | Boolean | Whether the danger zone is enabled or not. |
| Zimperium.PolicyAppSetting.detectionEnabled | Boolean | Whether detection is enabled. |
| Zimperium.PolicyAppSetting.forensicAnalysisEnabled | Boolean | Whether forensic analysis is enabled. |
| Zimperium.PolicyAppSetting.global | Boolean | Whether the policy is global. |
| Zimperium.PolicyAppSetting.groups | Unknown | The groups information. |
| Zimperium.PolicyAppSetting.jsonHash | String | The JSON hash of the policy. |
| Zimperium.PolicyAppSetting.modified | Date | The modified date of the policy. |
| Zimperium.PolicyAppSetting.name | String | The name of the policy. |
| Zimperium.PolicyAppSetting.phishingEnabled | Boolean | Whether phishing is enabled or not. |
| Zimperium.PolicyAppSetting.phishingLocalClassifierEnabled | Boolean | Whether the phishing local classifier is enabled. |
| Zimperium.PolicyAppSetting.phishingThreshold | Number | The phishing threshold. |
| Zimperium.PolicyAppSetting.privacySummaryEnabled | Boolean | Whether the privacy summary is enabled. |
| Zimperium.PolicyAppSetting.protoHash | String | The proto hash. |
| Zimperium.PolicyAppSetting.siteInsightEnabled | Boolean | Whether the site insight is enabled or not. |
| Zimperium.PolicyAppSetting.staticFilesWritten | Date | The date when the static files were written. |
| Zimperium.PolicyAppSetting.team | Unknown | The team name the policy is associated with. |
| Zimperium.PolicyAppSetting.teamId | Unknown | The ID of the team to which the policy belongs. |
Command example
!zimperium-policy-app-settings-get app_settings_policy_id="9e"
Context Example
{
"Zimperium": {
"PolicyAppSetting": {
"accountId": "2",
"appRiskLookupEnabled": true,
"assigned": true,
"autoActivateKnox": false,
"autoBatteryOptimizationEnabled": true,
"cogitoEnabled": true,
"cogitoThreshold": 70,
"created": "2023-12-05T20:09:16.621+00:00",
"dangerzoneEnabled": true,
"detectionEnabled": true,
"forensicAnalysisEnabled": false,
"global": true,
"groups": [
{
"accountId": "2",
"created": "2023-12-05T20:09:16.621+00:00",
"description": "Default Group",
"emm": false,
"global": true,
"groupActivations": [],
"id": "37",
"modified": "2023-12-05T20:09:16.621+00:00",
"name": "Default Group",
"staticFilesWritten": "2024-02-06T06:00:37.129+00:00",
"userActivations": [
{
"id": "40"
}
],
"zapps": []
}
],
"id": "9e",
"jsonHash": "616",
"modified": "2023-12-05T20:09:16.729+00:00",
"name": "Default",
"phishingDBRefreshMinutes": 480,
"phishingEnabled": true,
"phishingLocalClassifierEnabled": true,
"phishingThreshold": 75,
"privacySummaryEnabled": true,
"protoHash": "ea9",
"siteInsightEnabled": false,
"staticFilesWritten": "2023-12-05T20:09:17.418+00:00",
"team": null,
"teamId": null
}
}
}
Human Readable Output
Policy App Settings
Id Name Detection Enabled Cogito Enabled Cogito Threshold Phishing Enabled Phishing Threshold Phishing DB Refresh Minutes Created Modified Static Files Written Json Hash Proto Hash Dangerzone Enabled Site Insight Enabled Phishing Local Classifier Enabled App Risk Lookup Enabled Auto Battery Optimization Enabled Auto Activate Knox Privacy Summary Enabled Forensic Analysis Enabled Team Assigned Team Id Global 9e Default true true 70 true 75 480 2023-12-05T20:09:16.621+00:00 2023-12-05T20:09:16.729+00:00 2023-12-05T20:09:17.418+00:00 616 ea9 true false true true true false true false true true
zimperium-policy-device-inactivity-list
Get the policy device inactivity list.
Base Command
zimperium-policy-device-inactivity-list
Input
| Argument Name | Description | Required |
|---|---|---|
| page_size | Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. | Optional |
| page | Page number. Default is 0. | Optional |
| limit | Number of total results to return. Default is 50. | Optional |
| team_id | Used to filter the data by the team the user belongs to. If you provide this the query returns matching entries plus the policies without a team. | Optional |
Context Output
| Path | Type | Description |
|---|---|---|
| Zimperium.PolicyDeviceInactivity.teamId | String | The team ID for the policy device inactivity list. |
| Zimperium.PolicyDeviceInactivity.id | String | The policy device inactivity list ID. |
| Zimperium.PolicyDeviceInactivity.name | String | The name of the policy device inactivity list. |
Command example
!zimperium-policy-device-inactivity-list team_id="1"
Context Example
{
"Zimperium": {
"PolicyDeviceInactivity": [
{
"id": "2",
"name": "Default",
"teamId": null
},
{
"id": "ff3",
"name": "InactivityTest",
"teamId": "1"
}
]
}
}
Human Readable Output
Device Inactivity List
Id Name Team Id 2 Default ff3 InactivityTest 1
zimperium-policy-device-inactivity-get
Get policy device inactivity.
Base Command
zimperium-policy-device-inactivity-get
Input
| Argument Name | Description | Required |
|---|---|---|
| policy_id | The identifier of the policy. Can be retrieved using zimperium-policy-device-inactivity-list. | Required |
Context Output
| Path | Type | Description |
|---|---|---|
| Zimperium.PolicyDeviceInactivity.id | String | The policy device inactivity ID. |
| Zimperium.PolicyDeviceInactivity.accountId | String | The account identifier. |
| Zimperium.PolicyDeviceInactivity.created | Date | The date and time the policy was created. |
| Zimperium.PolicyDeviceInactivity.groups.id | String | The group ID. |
| Zimperium.PolicyDeviceInactivity.groups.name | String | The group name. |
| Zimperium.PolicyDeviceInactivity.inactiveAppSettings.enabled | Boolean | Whether the app settings inactivity is enabled. |
| Zimperium.PolicyDeviceInactivity.inactiveAppSettings.maxWarningsCount | Number | The maximum number of warnings that can be issued for an app. |
| Zimperium.PolicyDeviceInactivity.inactiveAppSettings | Boolean | The inactive app settings. |
| Zimperium.PolicyDeviceInactivity.modified | Date | The policy modified date. |
| Zimperium.PolicyDeviceInactivity.name | String | The name of the policy. |
| Zimperium.PolicyDeviceInactivity.pendingActivationSettings.enabled | Boolean | Whether the device’s policy setting is enabled or not. |
| Zimperium.PolicyDeviceInactivity.pendingActivationSettings.maxWarningsCount | Number | The maximum number of warnings that can be issued for the policy. |
| Zimperium.PolicyDeviceInactivity.pendingActivationSettings.sendEmailAndroid | Boolean | Whether to send an email. |
| Zimperium.PolicyDeviceInactivity.pendingActivationSettings.sendEmailIos | Boolean | Whether to send an email. |
| Zimperium.PolicyDeviceInactivity.pendingActivationSettings.timeBeforeWarningDisplayUnits | String | The time before the warning display. |
| Zimperium.PolicyDeviceInactivity.pendingActivationSettings.timeBeforeWarningSeconds | Number | The time before the warning seconds. |
| Zimperium.PolicyDeviceInactivity.pendingActivationSettings.timeBetweenWarningsDisplayUnits | String | The time interval between warning displays. |
| Zimperium.PolicyDeviceInactivity.pendingActivationSettings.timeBetweenWarningsSeconds | Number | The time in seconds between warnings. |
| Zimperium.PolicyDeviceInactivity.teamId | String | The Team ID for the policy device inactivity. |
Command example
!zimperium-policy-device-inactivity-get policy_id="ff3"
Context Example
{
"Zimperium": {
"PolicyDeviceInactivity": {
"accountId": "2",
"created": 1702305515652,
"groups": [
{
"id": "1",
"name": "GroupTest"
}
],
"id": "ff3",
"inactiveAppSettings": {
"enabled": false,
"maxWarningsCount": 2,
"notifyDevicesAndroid": false,
"notifyDevicesIos": false,
"sendEmailAndroid": false,
"sendEmailIos": false,
"timeBeforeWarningDisplayUnits": "DAYS",
"timeBeforeWarningSeconds": 259200,
"timeBetweenWarningsDisplayUnits": "DAYS",
"timeBetweenWarningsSeconds": 86400
},
"modified": 1702305515652,
"name": "InactivityTest",
"pendingActivationSettings": {
"enabled": false,
"maxWarningsCount": 2,
"sendEmailAndroid": false,
"sendEmailIos": false,
"timeBeforeWarningDisplayUnits": "DAYS",
"timeBeforeWarningSeconds": 259200,
"timeBetweenWarningsDisplayUnits": "DAYS",
"timeBetweenWarningsSeconds": 86400
},
"teamId": "1"
}
}
}
Human Readable Output
Device Inactivity
Id Name Team Id Pending Activation Settings Inactive App Settings Created Modified ff3 InactivityTest 1 enabled: false
timeBeforeWarningSeconds: 259200
timeBeforeWarningDisplayUnits: DAYS
timeBetweenWarningsSeconds: 86400
timeBetweenWarningsDisplayUnits: DAYS
maxWarningsCount: 2
sendEmailIos: false
sendEmailAndroid: falseenabled: false
timeBeforeWarningSeconds: 259200
timeBeforeWarningDisplayUnits: DAYS
timeBetweenWarningsSeconds: 86400
timeBetweenWarningsDisplayUnits: DAYS
maxWarningsCount: 2
notifyDevicesIos: false
notifyDevicesAndroid: false
sendEmailIos: false
sendEmailAndroid: false2023-12-11 14:38:35 2023-12-11 14:38:35
Breaking changes from the previous version of this integration
The following sections list the changes in this version.
Commands
The following commands were removed in this version
- zimperium-events-search - this command was replaced by zimperium-threat-search.
- zimperium-user-get-by-id - this command was replaced by zimperium-users-search.
- zimperium-device-get-by-id - this command was replaced by zimperium-devices-search.
- zimperium-app-classification-get - this command was replaced by zimperium-app-version-list.
- zimperium-devices-search - this command was removed.
- file - this command was removed.
Arguments
The following arguments were removed in this version
In the zimperium-users-search command:
- query
In the zimperium-devices-search command:
- query
In the zimperium-report-get command:
- bundle_id
- itunes_id
- app_hash
- platform
Configuration parameters
url— Server URL (e.g., https://mtduat.zimperium.com) (required)credentials— Client ID (required)isFetch— Fetch incidentsfetch_query— Search Params (e.g, severityName=CRITICAL,teamId=myId)max_fetch— Max fetchfirst_fetch— First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days)look_back— Advanced: Minutes to look back when fetchinginsecure— Trust any certificate (not secure)proxy— Use system proxy settingsmodule— ModuleincidentType— Incident typeincidentFetchInterval— Incidents Fetch Interval
Commands (16)
-
zimperium-app-version-listList the app versions.
-
zimperium-devices-os-versionGets devices associated with a specific operating system version.
-
zimperium-devices-searchSearch devices.
-
zimperium-get-cves-by-deviceGets the CVEs associated with a specific device.
-
zimperium-get-devices-by-cveGets a devices associated with a specific CVE.
-
zimperium-policy-app-settings-getList the app versions.
-
zimperium-policy-device-inactivity-getGet policy device inactivity.
-
zimperium-policy-device-inactivity-listGet the policy device inactivity list.
-
zimperium-policy-group-listGet policy groups.
-
zimperium-policy-phishing-getGet a phishing policy by its identifier.
-
zimperium-policy-privacy-getGet a privacy policy by its identifier.
-
zimperium-policy-threat-getGet a threat policy by its identifier.
-
zimperium-report-getGets a report.
-
zimperium-threat-searchSearch threats.
-
zimperium-users-searchSearch users. Only a user created as a "Team admin" is authorized to perform this request. Also, it will only get information about the teams that this user is associated with. Users that are not part of any team (such as account admin) won’t appear in the response.
-
zimperium-vulnerability-getGets the vulnerabilities.
category: Network Security provider: Liberty Strategic Capital sectionorder: - Connect - Collect commonfields: id: Zimperium v2 version: -1 configuration: - defaultvalue: https://mtduat.zimperium.com display: Server URL (e.g., https://mtduat.zimperium.com) name: url required: true type: 0 section: Connect - display: Client ID name: credentials type: 9 required: true displaypassword: Client Secret section: Connect - display: Fetch incidents name: isFetch type: 8 required: false section: Collect - display: Search Params (e.g, severityName=CRITICAL,teamId=myId) additionalinfo: Comma-separated list of search parameters and its values. Same as for the "zimperium-threat-search" command. name: fetch_query type: 0 required: false section: Collect - defaultvalue: '50' display: Max fetch name: max_fetch type: 0 required: false section: Collect - defaultvalue: 7 days display: First fetch timestamp (<number> <time unit>, e.g., 12 hours, 7 days) name: first_fetch required: false type: 0 section: Collect - display: 'Advanced: Minutes to look back when fetching' name: look_back type: 0 required: false defaultvalue: 1 additionalinfo: Use this parameter to determine how far back to look in the search for incidents that were created before the last run time and did not match the query when they were created. section: Collect - display: Trust any certificate (not secure) name: insecure type: 8 required: false section: Connect - display: Use system proxy settings name: proxy type: 8 required: false section: Connect - display: Module name: module type: 0 required: false defaultvalue: 'ZIPS' additionalinfo: 'The module of the application the API is pointing to. Default is "ZIPS". This parameter is optional but recommended. Leave empty to omit the module parameter from requests.' section: Connect - display: Incident type name: incidentType type: 13 defaultvalue: 'Zimperium Event' section: Connect - display: Incidents Fetch Interval name: incidentFetchInterval defaultvalue: '1' required: false type: 19 section: Collect advanced: true description: Fetch and investigate mobile security alerts, generated based on anomalous or unauthorized activities detected on a user's mobile device. Compatible with Zimperium 5.X API version. name: Zimperium v2 fromversion: 6.9.0 display: Zimperium v2 script: commands: - arguments: - description: The ID of the user to search. name: user_id - description: Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. name: page_size - defaultValue: '0' description: Page number. name: page - defaultValue: '50' description: Number of total results to return. name: limit - description: Used to filter the user data by the Team the user belongs to. name: team_id - description: The email of the user to search. name: email description: Search users. Only a user created as a "Team admin" is authorized to perform this request. Also, it will only get information about the teams that this user is associated with. Users that are not part of any team (such as account admin) won’t appear in the response. name: zimperium-users-search outputs: - contextPath: Zimperium.User.id description: The ID of the Zimperium user. type: String - contextPath: Zimperium.User.created description: The date and time that the user was created. type: Date - contextPath: Zimperium.User.email description: The email address of the user. type: String - contextPath: Zimperium.User.firstName description: The first name of the user. type: String - contextPath: Zimperium.User.languagePreference description: The language preference for the user. type: Unknown - contextPath: Zimperium.User.lastLogin description: The time of the last login of the user. type: Unknown - contextPath: Zimperium.User.lastName description: The last name of the user. type: String - contextPath: Zimperium.User.middleName description: The middle name of the user. type: Unknown - contextPath: Zimperium.User.modified description: The date and time that the user was modified. type: Date - contextPath: Zimperium.User.notificationEmail description: The email address for the user's notifications. type: String - contextPath: Zimperium.User.phone description: The phone number of the user. type: Unknown - contextPath: Zimperium.User.role.id description: The role identifier of the user. type: String - contextPath: Zimperium.User.role.name description: The role name of the user. type: String - contextPath: Zimperium.User.role.scopeBounds description: The role scope for a user. type: String - contextPath: Zimperium.User.teams.id description: The ID of the team of the user. type: String - contextPath: Zimperium.User.teams.name description: The name of the team of the user. type: String - contextPath: Zimperium.User.validated description: The user's validated status. type: Boolean - arguments: - description: The ID of the device to search for. name: device_id - description: Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. name: page_size - defaultValue: '0' description: Page number. name: page - defaultValue: '50' description: Number of total results to return. name: limit description: Search devices. name: zimperium-devices-search outputs: - contextPath: Zimperium.Device.accountId description: The account identifier of the device. type: String - contextPath: Zimperium.Device.activationName description: The activation name of the device. type: String - contextPath: Zimperium.Device.additionalDeviceInfo description: The additional device information. type: Unknown - contextPath: Zimperium.Device.agentType description: The agent type of the device. type: Number - contextPath: Zimperium.Device.appStatus description: The app status. type: String - contextPath: Zimperium.Device.appVersions description: The app version of the device. type: Unknown - contextPath: Zimperium.Device.bundleId description: The bundle identifier of the device. type: Unknown - contextPath: Zimperium.Device.created description: The date and time that the device was created. type: Date - contextPath: Zimperium.Device.deleted description: Whether the device was deleted. type: Boolean - contextPath: Zimperium.Device.developerOptionsOn description: Whether the developer options are on. type: Boolean - contextPath: Zimperium.Device.deviceOwner.email description: The email address of the device owner. type: String - contextPath: Zimperium.Device.fullType description: The device's full type. type: String - contextPath: Zimperium.Device.groupId description: The device group identifier. type: String - contextPath: Zimperium.Device.id description: The unique identifier of the device. type: String - contextPath: Zimperium.Device.lastSeen description: The time when the device was last seen. type: Date - contextPath: Zimperium.Device.lockScreenUnprotected description: Whether the device's lockscreen is unprotected or not. type: Boolean - contextPath: Zimperium.Device.model description: The model of the device. type: String - contextPath: Zimperium.Device.os.id description: The operating system identifier of the device. type: Number - contextPath: Zimperium.Device.os.maxOsVersion description: The maximum operating system version of the device. type: String - contextPath: Zimperium.Device.os.name description: The operating system name. type: String - contextPath: Zimperium.Device.os.osVersionId description: The operating system version identifier of the device. type: Number - contextPath: Zimperium.Device.os.policyCompliant description: Whether the operating system policy is compliant in the device. type: Boolean - contextPath: Zimperium.Device.os.type description: The operating system type of the device. type: String - contextPath: Zimperium.Device.os.version description: The operating system version of the device. type: String - contextPath: Zimperium.Device.processed description: Whether the device is processed. type: Boolean - contextPath: Zimperium.Device.processedAt description: The date and time that the device was processed. type: Date - contextPath: Zimperium.Device.riskPosture description: The risk posture of the device. type: Number - contextPath: Zimperium.Device.riskPostureName description: The risk posture name of the device. type: String - contextPath: Zimperium.Device.teamId description: The team ID of the device. type: String - contextPath: Zimperium.Device.teamName description: The team name of the device. type: String - contextPath: Zimperium.Device.threatState description: The threat state information. type: Unknown - contextPath: Zimperium.Device.zappInstance.agentType description: The agent type of the device. type: Number - contextPath: Zimperium.Device.zappInstance.buildNumber description: The build number of the zappInstance. type: String - contextPath: Zimperium.Device.zappInstance.bundleId description: The bundle identifier of the zappInstance. type: String - contextPath: Zimperium.Device.zappInstance.groupId description: The Zimperium device group identifier for the zappInstance. type: String - contextPath: Zimperium.Device.zappInstance.id description: The ID of the zappInstance. type: String - contextPath: Zimperium.Device.zappInstance.lastSeen description: The last seen timestamp for the zappInstance. type: Date - contextPath: Zimperium.Device.zappInstance.name description: The name of the zappInstance. type: String - contextPath: Zimperium.Device.zappInstance.policiesInfo description: The policies information. type: String - contextPath: Zimperium.Device.zappInstance.version description: The version of the zappInstance. type: String - contextPath: Zimperium.Device.zappInstance.zappId description: The ID of the zappInstance. type: String - contextPath: Zimperium.Device.zappInstance.zbuildNumber description: The Zimperium device's zappinstance. type: String - contextPath: Zimperium.Device.zappInstance.zversion description: The device's zappinstance version. type: String - contextPath: Zimperium.Device.zdeviceId description: The zdevice ID. type: String - contextPath: Zimperium.Device.appVersions.appVersionId description: The app version ID of the device. type: String - contextPath: Zimperium.Device.appVersions.bundleId description: The bundle identifier of the app versions. type: String - contextPath: Zimperium.Device.os.maxOsPatchDate description: The max patch date of operating system of the device. type: String - contextPath: Zimperium.Device.os.patchDate description: The operating system patch date of the device. type: Date - contextPath: Zimperium.Device.threatState.numberOfCriticalThreats description: The number of critical threats detected on the device. type: Number - contextPath: Zimperium.Device.zappInstance.permissionsState description: The permissions state on the device. type: Unknown - contextPath: Zimperium.Device.dormancyProcessed description: The device's dormancy processed status. type: Boolean - contextPath: Zimperium.Device.os.versionUpgradeable description: The operating system version upgradeable for the device. type: Boolean - contextPath: Zimperium.Device.threatState description: The threat state of the device. type: Unknown - contextPath: Zimperium.Device.zappInstance.policiesInfo description: The device policies info. type: Unknown - contextPath: Zimperium.Device.isJailbroken description: Whether the endpoint's device is jailbroken or not. type: Boolean - arguments: - description: The ID of the app version for which to get a JSON report. Can be retrieved using the zimperium-app-version-list command, in the field "Zimperium.AppVersion.id". name: app_version_id required: true - defaultValue: 'High' auto: PREDEFINED predefined: - Low - Medium - High - All description: The importance of the threat. name: importance description: Gets a report. name: zimperium-report-get outputs: - contextPath: Zimperium.Report.ContentInformation description: The content of the report. type: String - contextPath: Zimperium.Report.glob description: The glob pattern for the Zimperium report. type: Number - contextPath: Zimperium.Report.platform description: The platform on which the report was created. type: String - contextPath: Zimperium.Report.report.androidAnalysis description: The android analysis of the report. type: String - contextPath: Zimperium.Report.report.appProperties description: The app properties. type: String - contextPath: Zimperium.Report.report.certificate description: The certificate. type: String - contextPath: Zimperium.Report.report.communications description: The communications. type: String - contextPath: Zimperium.Report.report.contentInformation description: The content information of the report. type: String - contextPath: Zimperium.Report.report.distribution description: The report distribution. type: String - contextPath: Zimperium.Report.report.jsonVersion description: The JSON version of the report. type: String - contextPath: Zimperium.Report.report.riskProfile description: The risk profile. type: String - contextPath: Zimperium.Report.report.scanDetails description: The description of the scan details for the report. type: Unknown - contextPath: Zimperium.Report.report.scanVersion description: The scan version of the Zimperium report. type: Unknown - contextPath: Zimperium.Report.report.vulnerabilities description: The vulnerabilities found in the report. type: Unknown - contextPath: Zimperium.Report.result description: The Zimperium report result. type: Number - arguments: - description: The date in the criteria after which the threat occurred. name: after required: true - description: The date in the criteria before which the threat occurred. name: before - description: "A comma-separated list of parameter and their values by which to filter your request. For example: 'device.os.version=7.1.1,vectorName=Device'. The parameters table is available under 'Threat API Details' section in the 'Threats' section, of the Zimperium API documentation, or on the website at https://mtduat.zimperium.com/ziap-docs/zips-docs/api/api_details_threat.html#optional-search-parameters-supported." name: search_params isArray: true - description: Used to filter the user data by the team the user belongs to. name: team_id - auto: PREDEFINED predefined: - ios - android description: Used to filter by the operating system. name: os - auto: PREDEFINED predefined: - LOW - NORMAL - ELEVATED - CRITICAL description: The severity of the threat. name: severity - description: Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. name: page_size - defaultValue: '0' description: Page number. name: page - defaultValue: '50' description: Number of total results to return. name: limit description: Search threats. name: zimperium-threat-search outputs: - contextPath: Zimperium.Threat.id description: The ID of the threat. type: String - contextPath: Zimperium.Threat.accountId description: The account identifier of the threat. type: String - contextPath: Zimperium.Threat.activationName description: The activation name of a threat. type: String - contextPath: Zimperium.Threat.agentType description: The agent type for the threat. type: Number - contextPath: Zimperium.Threat.arpTablesInfo description: The ARP tables information for the devices. type: Unknown - contextPath: Zimperium.Threat.categoryId description: The category of a threat. type: Number - contextPath: Zimperium.Threat.classification description: The classification of a threat. type: Number - contextPath: Zimperium.Threat.classificationName description: The classification name for a threat. type: String - contextPath: Zimperium.Threat.detectionFiles description: The threat detection files. type: Unknown - contextPath: Zimperium.Threat.device.id description: The unique identifier of the device. type: String - contextPath: Zimperium.Threat.device.mamDeviceId description: The mobile application management (MAM) ID of the device. type: String - contextPath: Zimperium.Threat.device.mdmDeviceId description: The mobile device management (MAM) ID of the device. type: String - contextPath: Zimperium.Threat.device.model description: The model of the device the threat was detected on. type: String - contextPath: Zimperium.Threat.device.os.id description: The operating system identifier of the device the threat was detected on. type: Number - contextPath: Zimperium.Threat.device.os.name description: The operating system name for the device. type: String - contextPath: Zimperium.Threat.device.os.version description: The operating system version of the device. type: String - contextPath: Zimperium.Threat.device.zdeviceId description: The zDevice ID of the device. type: String - contextPath: Zimperium.Threat.deviceId description: The unique identifier of the device the threat was detected on. type: String - contextPath: Zimperium.Threat.deviceOwner description: The owner of the device. type: String - contextPath: Zimperium.Threat.eventProcessedTimestamp description: The timestamp when the threat event was processed. type: Date - contextPath: Zimperium.Threat.eventReceivedTimestamp description: The timestamp when the threat event was received. type: Date - contextPath: Zimperium.Threat.generalInfo.actionTriggered description: The threat action triggered on a threat. type: String - contextPath: Zimperium.Threat.generalInfo.bssid description: The Basic Service Set Identifier (BSSID) of the threat. type: String - contextPath: Zimperium.Threat.generalInfo.deviceTimestamp description: The timestamp of the endpoint's device. type: Date - contextPath: Zimperium.Threat.generalInfo.jailbreakReasons description: The jailbreak reasons for the threat. type: String - contextPath: Zimperium.Threat.generalInfo.ssid description: The service set identifier (SSID) for the threat. type: String - contextPath: Zimperium.Threat.generalInfo.timeInterval description: The time interval for a threat. type: Number - contextPath: Zimperium.Threat.groupId description: The ID of the threat group. type: String - contextPath: Zimperium.Threat.lastModified description: The time the threat was last modified. type: Date - contextPath: Zimperium.Threat.mitigationEvents description: The mitigation events for the threat. type: Unknown - contextPath: Zimperium.Threat.nearByNetworks description: The near-by networks for the threat. type: Unknown - contextPath: Zimperium.Threat.networkStatistics description: The Zimperium threat network statistics. type: Unknown - contextPath: Zimperium.Threat.os description: The operating system. type: String - contextPath: Zimperium.Threat.policiesInfo.deployedAt description: The date that the threat policy was deployed. type: Date - contextPath: Zimperium.Threat.policiesInfo.downloadedAt description: The date when the threat policy was downloaded. type: Date - contextPath: Zimperium.Threat.policiesInfo.hash description: The hash of the threat policy information. type: String - contextPath: Zimperium.Threat.policiesInfo.type description: The threat policy type. type: String - contextPath: Zimperium.Threat.processList.parentProcessId description: The parent process ID for a threat's process. type: String - contextPath: Zimperium.Threat.processList.processId description: The Process ID for the threat process. type: String - contextPath: Zimperium.Threat.processList.processName description: The Process Name for the threat. type: String - contextPath: Zimperium.Threat.processList.service description: The services associated with the process list. type: String - contextPath: Zimperium.Threat.processList.user description: The users and processes that are involved in the threat process. type: String - contextPath: Zimperium.Threat.responses.eventId description: The unique identifier for an event in the threat response. type: String - contextPath: Zimperium.Threat.responses.responseId description: The response identifier for a threat's response. type: Number - contextPath: Zimperium.Threat.responses.timestamp description: The timestamp of the threat response. type: Date - contextPath: Zimperium.Threat.runningServices description: The running services. type: Unknown - contextPath: Zimperium.Threat.severity description: The severity of the threat. type: Number - contextPath: Zimperium.Threat.severityName description: The severity name of the threat. type: String - contextPath: Zimperium.Threat.simulated description: Is the threat simulated. type: Boolean - contextPath: Zimperium.Threat.state description: The threat state. type: Number - contextPath: Zimperium.Threat.suspiciousUrlInfo description: The suspicious URL information. type: Unknown - contextPath: Zimperium.Threat.teamId description: The ID of the threat team for an incident. type: String - contextPath: Zimperium.Threat.teamName description: The threat team name for the incident. type: String - contextPath: Zimperium.Threat.threatTypeId description: The threat type identifier for the threat. type: Number - contextPath: Zimperium.Threat.threatTypeName description: The threat type for the threat. type: String - contextPath: Zimperium.Threat.timestamp description: The timestamp of the threat. type: Date - contextPath: Zimperium.Threat.timestampInfo description: The timestamp information of the threat. type: Unknown - contextPath: Zimperium.Threat.vector description: The threat vector for the incident. type: Number - contextPath: Zimperium.Threat.vectorName description: The vector name for the threat. type: String - contextPath: Zimperium.Threat.zappId description: The Zimperium threat app identifier. type: String - contextPath: Zimperium.Threat.zappInstance description: The threat Zapp instance information. type: Unknown - contextPath: Zimperium.Threat.zappInstanceId description: The Zapp threat instance ID. type: String - contextPath: Zimperium.Threat.zeventId description: The Zimperium threat event identifier. type: String - contextPath: Zimperium.Threat.arpTablesInfo description: The ARP tables info for the threat. type: Unknown - contextPath: Zimperium.Threat.locationInfo.geoPoint.lat description: The latitude of the geoPoint. type: Number - contextPath: Zimperium.Threat.locationInfo.geoPoint.lon description: The longitude of the geoPoint. type: Number - contextPath: Zimperium.Threat.locationInfo.source description: The threat's source location information. type: String - contextPath: Zimperium.Threat.generalInfo.expectedOsVersion description: The expected operating system version for the threat. type: String - contextPath: Zimperium.Threat.generalInfo.vulnerableOsVersion description: The vulnerable operating system version for the threat. type: String - contextPath: Zimperium.Threat.generalInfo.vulnerableSecurityPatch description: The vulnerable security patch for the endpoint. type: String - contextPath: Zimperium.Threat.mitigatedAt description: The date when the Threat was mitigated. type: Date - arguments: - description: The bundle ID of the app for which to get its app version. name: bundle_id - description: Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. name: page_size - defaultValue: '0' description: Page number. name: page - defaultValue: '50' description: Number of total results to return. name: limit description: List the app versions. name: zimperium-app-version-list outputs: - contextPath: Zimperium.AppVersion.id description: The ID of the threat. type: String - contextPath: Zimperium.AppVersion.accountId description: The account identifier for the Zimperium app version. type: String - contextPath: Zimperium.AppVersion.bundleId description: The bundle identifier for the Zimperium app version. type: String - contextPath: Zimperium.AppVersion.classification description: The classification of the Zimperium app version. type: String - contextPath: Zimperium.AppVersion.created description: When the app version was created. type: Date - contextPath: Zimperium.AppVersion.hash description: The hash of the Zimperium app version. type: String - contextPath: Zimperium.AppVersion.name description: The name of the Zimperium app version. type: String - contextPath: Zimperium.AppVersion.platform description: The platform on which the Zimperium app version is running. type: String - contextPath: Zimperium.AppVersion.platformId description: The platform identifier for the Zimperium app version. type: Number - contextPath: Zimperium.AppVersion.privacy description: The privacy setting for the app version. type: String - contextPath: Zimperium.AppVersion.privacyRisk description: The privacy risk for the Zimperium app version. type: Number - contextPath: Zimperium.AppVersion.processState description: The process state of the app version. type: String - contextPath: Zimperium.AppVersion.reportRequestId description: The Zimperium app version report request ID. type: String - contextPath: Zimperium.AppVersion.riskVersion description: The risk version of the Zimperium app version. type: String - contextPath: Zimperium.AppVersion.security description: The security of the Zimperium app version. type: String - contextPath: Zimperium.AppVersion.securityRisk description: The security risk of the Zimperium app version. type: Number - contextPath: Zimperium.AppVersion.source description: The Zimperium app version source. type: String - contextPath: Zimperium.AppVersion.updatedOn description: The date and time when the app version was updated. type: Date - contextPath: Zimperium.AppVersion.version description: The version of the Zimperium app version. type: String - contextPath: Zimperium.AppVersion.developerName description: The developer name for the Zimperium app version. type: String - contextPath: Zimperium.AppVersion.developerSignature description: The developer signature for the Zimperium app version. type: String - contextPath: Zimperium.AppVersion.filename description: The filename of the Zimperium app version. type: String - contextPath: Zimperium.AppVersion.managed description: Whether the app version is managed. type: Boolean - arguments: - description: The ID of the CVE which is input. name: cve_id required: true - description: The date in the criteria after which the threat occurred. name: after - description: The date in the criteria before which the threat occurred. name: before - description: Used to filter the user data by the team the user belongs to. name: team_id - description: Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. name: page_size - defaultValue: '0' description: Page number. name: page - defaultValue: '50' description: Number of total results to return. name: limit description: Gets a devices associated with a specific CVE. name: zimperium-get-devices-by-cve outputs: - contextPath: Zimperium.DeviceByCVE.id description: The ID of the device. type: String - contextPath: Zimperium.DeviceByCVE.cveId description: The ID of the CVE. type: String - contextPath: Zimperium.DeviceByCVE.os.id description: The operating system identifier of the device. type: Number - contextPath: Zimperium.DeviceByCVE.os.maxOsPatchDate description: The device operating system max patch date. type: String - contextPath: Zimperium.DeviceByCVE.os.maxOsVersion description: The device operating system max version. type: String - contextPath: Zimperium.DeviceByCVE.os.name description: The operating system name of the device. type: String - contextPath: Zimperium.DeviceByCVE.os.osVersionId description: The operating system version identifier of the device. type: Number - contextPath: Zimperium.DeviceByCVE.os.patchDate description: The patch date for of the operating system. type: Date - contextPath: Zimperium.DeviceByCVE.os.policyCompliant description: The operating system policy compliant with the device. type: Boolean - contextPath: Zimperium.DeviceByCVE.os.type description: The operating system type of the device. type: String - contextPath: Zimperium.DeviceByCVE.os.version description: The operating system version of the device. type: String - contextPath: Zimperium.DeviceByCVE.os.versionUpgradeable description: Whether the operating system version upgradeable. type: Boolean - contextPath: Zimperium.DeviceByCVE.teamId description: The team ID of the device. type: String - contextPath: Zimperium.DeviceByCVE.zdeviceId description: The zdevice ID of the device. type: String - arguments: - description: The name of the version which is input. Can be retrieved using zimperium-devices-search command under "Zimperium.Device.os.version". name: os_version required: true - description: The date of the patch for a specific version. The date format is YYYY-MM-DD. This field is only applicable to Android. If you include this field, only CVEs for Android are returned since this value does not apply to iOS. name: os_patch_date - auto: PREDEFINED predefined: - 'true' - 'false' description: This is used to request the devices that have been deleted. name: deleted - description: The date in the criteria after which the threat occurred. name: after - description: The date in the criteria before which the threat occurred. name: before - description: This is used to filter the data to their respective teams. name: team_id - description: Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. name: page_size - defaultValue: '0' description: Page number. name: page - defaultValue: '50' description: Number of total results to return. name: limit description: Gets devices associated with a specific operating system version. name: zimperium-devices-os-version outputs: - contextPath: Zimperium.DeviceOsVersion.id description: The ID of the device. type: String - contextPath: Zimperium.DeviceOsVersion.os.id description: The operating system identifier of the device. type: Number - contextPath: Zimperium.DeviceOsVersion.os.maxOsPatchDate description: The device operating system max patch date. type: String - contextPath: Zimperium.DeviceOsVersion.os.maxOsVersion description: The device operating system max version. type: String - contextPath: Zimperium.DeviceOsVersion.os.name description: The operating system name of the device. type: String - contextPath: Zimperium.DeviceOsVersion.os.osVersionId description: The operating system version identifier of the device. type: Number - contextPath: Zimperium.DeviceOsVersion.os.patchDate description: The patch date of the device's operating system. type: Date - contextPath: Zimperium.DeviceOsVersion.os.policyCompliant description: Whether the endpoint's operating system is compliant with the policy. type: Boolean - contextPath: Zimperium.DeviceOsVersion.os.type description: The operating system type. type: String - contextPath: Zimperium.DeviceOsVersion.os.version description: The operating system version. type: String - contextPath: Zimperium.DeviceOsVersion.os.versionUpgradeable description: Whether the device's operating system is upgradeable. type: Boolean - contextPath: Zimperium.DeviceOsVersion.teamId description: The team ID of the device. type: String - contextPath: Zimperium.DeviceOsVersion.zdeviceId description: The zdevice ID of the Device. type: String - arguments: - description: The device ID to get CVEs for. name: device_id required: true - description: Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. name: page_size - defaultValue: '0' description: Page number. name: page - defaultValue: '50' description: Number of total results to return. name: limit description: Gets the CVEs associated with a specific device. name: zimperium-get-cves-by-device outputs: - contextPath: Zimperium.CVEByDevice.id description: The ID of the CVE. type: String - contextPath: Zimperium.CVEByDevice.deviceId description: The ID of the device. type: String - contextPath: Zimperium.CVEByDevice.activeExploit description: Whether the CVE is active or not. type: Boolean - contextPath: Zimperium.CVEByDevice.exploitPocUrl.exploitPocUrls description: The exploit POC URLs for the CVE. type: Unknown - contextPath: Zimperium.CVEByDevice.severity description: The severity of a CVE on the device. type: String - contextPath: Zimperium.CVEByDevice.type description: The CVE type. type: String - contextPath: Zimperium.CVEByDevice.url description: The URL of the CVE. type: String - arguments: - description: Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. name: page_size - defaultValue: '0' description: Page number. name: page - defaultValue: '50' description: Number of total results to return. name: limit description: Gets the vulnerabilities. name: zimperium-vulnerability-get outputs: - contextPath: Zimperium.Vulnerability.id description: The ID of the vulnerability. type: String - contextPath: Zimperium.Vulnerability.blueBorneVulnerable description: Whether the operating system is blue born vulnerable. type: Boolean - contextPath: Zimperium.Vulnerability.cveCount description: Number of CVEs on the operating system. type: Number - contextPath: Zimperium.Vulnerability.lastCveSync description: The date of the last CVE sync. type: Date - contextPath: Zimperium.Vulnerability.os description: The vulnerability operating system. type: Number - contextPath: Zimperium.Vulnerability.osPatchDate description: The max patch date of operating system. type: Unknown - contextPath: Zimperium.Vulnerability.osRiskChecksum description: The operating system risk checksum. type: String - contextPath: Zimperium.Vulnerability.osVersion description: The operating system version. type: String - contextPath: Zimperium.Vulnerability.osVersionAndPatchDate description: The operating system version and the patch date. type: String - contextPath: Zimperium.Vulnerability.risk description: The risk classification. type: String - arguments: - auto: PREDEFINED predefined: - EMM - ZIPS description: The module parameter is required to get the groups related to EMM connection or ZIPS connection. If provided, this command argument takes priority over the integration's "Module" parameter. Default is "ZIPS". name: module description: Get policy groups. name: zimperium-policy-group-list outputs: - contextPath: Zimperium.PolicyGroup.id description: The ID of the policy group. type: String - contextPath: Zimperium.PolicyGroup.accountId description: The account identifier for the policy group's content. type: String - contextPath: Zimperium.PolicyGroup.appPolicyId description: The app policy ID of the policy group. type: String - contextPath: Zimperium.PolicyGroup.appSettingsId description: The app settings ID of the policy group. type: String - contextPath: Zimperium.PolicyGroup.brandingPolicyId description: The branding policy identifier of the policy group. type: Unknown - contextPath: Zimperium.PolicyGroup.created description: The date and time the policy group was created. type: Date - contextPath: Zimperium.PolicyGroup.description description: The description of the policy group. type: String - contextPath: Zimperium.PolicyGroup.dormancyPolicyId description: The dormancy policy identifier of the policy group. type: String - contextPath: Zimperium.PolicyGroup.emmConnectionId description: The enterprise mobile management (EMM) connection ID of the policy group. type: Unknown - contextPath: Zimperium.PolicyGroup.emmGroupId description: The enterprise mobile management (EMM) group ID of the policy group. type: Unknown - contextPath: Zimperium.PolicyGroup.emmPriority description: The enterprise mobile management (EMM) priority of the policy group. type: Unknown - contextPath: Zimperium.PolicyGroup.extensionPolicyId description: The extension policy identifier of the policy group. type: String - contextPath: Zimperium.PolicyGroup.content.global description: Whether the policy group is global. type: Boolean - contextPath: Zimperium.PolicyGroup.knoxPolicyId description: The Knox policy ID of the policy group. type: Unknown - contextPath: Zimperium.PolicyGroup.modified description: The date and time when the policy group was last modified. type: Date - contextPath: Zimperium.PolicyGroup.name description: The name of the policy group. type: String - contextPath: Zimperium.PolicyGroup.networkPolicyId description: The network policy ID of the policy group. type: String - contextPath: Zimperium.PolicyGroup.osRiskPolicyId description: The operating system risk policy ID of the policy group. type: String - contextPath: Zimperium.PolicyGroup.phishingPolicyId description: The phishing policy identifier of the policy group. type: String - contextPath: Zimperium.PolicyGroup.privacyId description: The privacy identifier of the policy group. type: String - contextPath: Zimperium.PolicyGroup.team.id description: The ID of the team associated with the policy group. type: String - contextPath: Zimperium.PolicyGroup.team.name description: The team name of the policy group. type: String - contextPath: Zimperium.PolicyGroup.trmId description: The Threat Response Matrix (TRM) ID of the policy group. type: String - contextPath: Zimperium.PolicyGroup.team description: The policy group's team information. type: Unknown - arguments: - description: The identifier of the policy. Can be retrieved using zimperium-policy-group-list in the Zimperium.PolicyGroup.privacyId field. name: policy_id required: true description: Get a privacy policy by its identifier. name: zimperium-policy-privacy-get outputs: - contextPath: Zimperium.PolicyPrivacy.id description: The policy privacy identifier. type: String - contextPath: Zimperium.PolicyPrivacy.accountId description: The account identifier of the policy. type: String - contextPath: Zimperium.PolicyPrivacy.assigned description: Whether the policy privacy is assigned. type: Boolean - contextPath: Zimperium.PolicyPrivacy.created description: The date and time the policy was created. type: Date - contextPath: Zimperium.PolicyPrivacy.global description: Whether the policy settings are global. type: Boolean - contextPath: Zimperium.PolicyPrivacy.groups description: The groups the policy are associated with. type: String - contextPath: Zimperium.PolicyPrivacy.jsonHash description: The JSON hash for the policy privacy policy. type: String - contextPath: Zimperium.PolicyPrivacy.locationAccuracy description: The location accuracy for the policy. type: Number - contextPath: Zimperium.PolicyPrivacy.modified description: The date and time when the policy was modified. type: Date - contextPath: Zimperium.PolicyPrivacy.name description: The name of the policy. type: String - contextPath: Zimperium.PolicyPrivacy.protoHash description: The hash of the policy. type: String - contextPath: Zimperium.PolicyPrivacy.rules description: The policy rules list. type: Unknown - contextPath: Zimperium.PolicyPrivacy.rules.id description: The ID of the rule. type: String - contextPath: Zimperium.PolicyPrivacy.team description: The team for the policy. type: Unknown - contextPath: Zimperium.PolicyPrivacy.teamId description: The team ID the policy associated with. type: Unknown - arguments: - description: The identifier of the policy. Can be retrieved using zimperium-policy-group-list in the Zimperium.PolicyGroup.trmId field. name: policy_id required: true description: Get a threat policy by its identifier. name: zimperium-policy-threat-get outputs: - contextPath: Zimperium.PolicyThreat.id description: The identifier of the policy. type: String - contextPath: Zimperium.PolicyThreat.accountId description: The account identifier of the policy. type: String - contextPath: Zimperium.PolicyThreat.androidJsonHash description: The Android JSON hash. type: String - contextPath: Zimperium.PolicyThreat.androidProtoHash description: The Android Proto hash. type: String - contextPath: Zimperium.PolicyThreat.assigned description: Whether the policy is assigned. type: Boolean - contextPath: Zimperium.PolicyThreat.created description: The date and time the policy threat was created. type: Date - contextPath: Zimperium.PolicyThreat.deploymentDate description: The date when the policy deployment occurred. type: Date - contextPath: Zimperium.PolicyThreat.global description: Whether the policy settings are global. type: Boolean - contextPath: Zimperium.PolicyThreat.groups description: The groups the policy associated with. type: Unknown - contextPath: Zimperium.PolicyThreat.iosJsonHash description: IOS JSON hash. type: String - contextPath: Zimperium.PolicyThreat.iosProtoHash description: IOS Proto hash. type: String - contextPath: Zimperium.PolicyThreat.isDeployed description: Whether the policy threat is deployed or not. type: Boolean - contextPath: Zimperium.PolicyThreat.modified description: The date and time when the policy was modified. type: Date - contextPath: Zimperium.PolicyThreat.name description: The name of the policy. type: String - contextPath: Zimperium.PolicyThreat.rules description: The policy rules list. type: Unknown - contextPath: Zimperium.PolicyThreat.rules.id description: The ID of the policy rule. type: String - arguments: - description: The identifier of the policy. Can be retrieved using zimperium-policy-group-list in the Zimperium.PolicyGroup.phishingPolicyId field. name: policy_id required: true description: Get a phishing policy by its identifier. name: zimperium-policy-phishing-get outputs: - contextPath: Zimperium.PolicyPhishing.id description: The identifier of the policy. type: String - contextPath: Zimperium.PolicyPhishing.accessControlList description: The access control list for the policy resource. type: Unknown - contextPath: Zimperium.PolicyPhishing.accountId description: The account identifier of the policy. type: String - contextPath: Zimperium.PolicyPhishing.allowEndUserControl description: Whether the end user is allowed to control the policy. type: Boolean - contextPath: Zimperium.PolicyPhishing.contentCategoryActionList description: The content of the policy category action. type: Unknown - contextPath: Zimperium.PolicyPhishing.created description: The date and time the policy threat was created. type: Date - contextPath: Zimperium.PolicyPhishing.enableDnsPhishingTutorial description: Whether the DNS phishing tutorial is enabled. type: Boolean - contextPath: Zimperium.PolicyPhishing.enableMessageFilterTutorial description: Whether the message filter tutorial is enabled. type: Boolean - contextPath: Zimperium.PolicyPhishing.enableSafariBrowserExtensionTutorial description: Whether the Safari Browser Extension tutorial is enabled. type: Boolean - contextPath: Zimperium.PolicyPhishing.global description: Whether the policy settings are global. type: Boolean - contextPath: Zimperium.PolicyPhishing.groups description: The groups the policy are associated with. type: Unknown - contextPath: Zimperium.PolicyPhishing.isDnsEnabled description: Whether DNS is enabled or not. type: Boolean - contextPath: Zimperium.PolicyPhishing.modified description: The date and time when the policy was modified. type: Date - contextPath: Zimperium.PolicyPhishing.name description: The name of the policy. type: String - contextPath: Zimperium.PolicyPhishing.phishingDetectionAction description: The phishing detection action. type: String - contextPath: Zimperium.PolicyPhishing.phishingPolicyType description: The phishing policy type. type: String - contextPath: Zimperium.PolicyPhishing.team description: The team the policy is associated with. type: Unknown - contextPath: Zimperium.PolicyPhishing.teamId description: The ID of the team. type: Unknown - contextPath: Zimperium.PolicyPhishing.useLocalVpn description: Whether to use a local VPN or not. type: Boolean - contextPath: Zimperium.PolicyPhishing.useRemoteContentInspection description: Whether to use remote content inspection. type: Boolean - contextPath: Zimperium.PolicyPhishing.useUrlSharing description: Whether the URL sharing is enabled or not. type: Boolean - arguments: - description: The identifier of the policy. Can be retrieved using zimperium-policy-group-list in the Zimperium.PolicyGroup.appSettingsId field. name: app_settings_policy_id required: true description: List the app versions. name: zimperium-policy-app-settings-get outputs: - contextPath: Zimperium.PolicyAppSetting.id description: The identifier of the policy. type: String - contextPath: Zimperium.PolicyAppSetting.accountId description: The account identifier of the policy. type: String - contextPath: Zimperium.PolicyAppSetting.appRiskLookupEnabled description: Whether the app risk lookup is enabled or not. type: Boolean - contextPath: Zimperium.PolicyAppSetting.assigned description: Whether the policy is assigned. type: Boolean - contextPath: Zimperium.PolicyAppSetting.autoActivateKnox description: Whether Knox should be automatically activated. type: Boolean - contextPath: Zimperium.PolicyAppSetting.autoBatteryOptimizationEnabled description: Whether the battery optimization is enabled. type: Boolean - contextPath: Zimperium.PolicyAppSetting.cogitoEnabled description: Whether the cogito is enabled. type: Boolean - contextPath: Zimperium.PolicyAppSetting.cogitoThreshold description: The cogito threshold. type: Number - contextPath: Zimperium.PolicyAppSetting.created description: The date and time the policy was created. type: Date - contextPath: Zimperium.PolicyAppSetting.dangerzoneEnabled description: Whether the danger zone is enabled or not. type: Boolean - contextPath: Zimperium.PolicyAppSetting.detectionEnabled description: Whether detection is enabled. type: Boolean - contextPath: Zimperium.PolicyAppSetting.forensicAnalysisEnabled description: Whether forensic analysis is enabled. type: Boolean - contextPath: Zimperium.PolicyAppSetting.global description: Whether the policy is global. type: Boolean - contextPath: Zimperium.PolicyAppSetting.groups description: The groups information. type: Unknown - contextPath: Zimperium.PolicyAppSetting.jsonHash description: The JSON hash of the policy. type: String - contextPath: Zimperium.PolicyAppSetting.modified description: The modified date of the policy. type: Date - contextPath: Zimperium.PolicyAppSetting.name description: The name of the policy. type: String - contextPath: Zimperium.PolicyAppSetting.phishingEnabled description: Whether phishing is enabled or not. type: Boolean - contextPath: Zimperium.PolicyAppSetting.phishingLocalClassifierEnabled description: Whether the phishing local classifier is enabled. type: Boolean - contextPath: Zimperium.PolicyAppSetting.phishingThreshold description: The phishing threshold. type: Number - contextPath: Zimperium.PolicyAppSetting.privacySummaryEnabled description: Whether the privacy summary is enabled. type: Boolean - contextPath: Zimperium.PolicyAppSetting.protoHash description: The proto hash. type: String - contextPath: Zimperium.PolicyAppSetting.siteInsightEnabled description: Whether the site insight is enabled or not. type: Boolean - contextPath: Zimperium.PolicyAppSetting.staticFilesWritten description: The date when the static files were written. type: Date - contextPath: Zimperium.PolicyAppSetting.team description: The team name the policy is associated with. type: Unknown - contextPath: Zimperium.PolicyAppSetting.teamId description: The ID of the team to which the policy belongs. type: Unknown - arguments: - description: Maximum number of results to retrieve in each page. If a limit is not provided, default is 50. name: page_size - defaultValue: '0' description: Page number. name: page - defaultValue: '50' description: Number of total results to return. name: limit - description: Used to filter the data by the team the user belongs to. If you provide this the query returns matching entries plus the policies without a team. name: team_id description: Get the policy device inactivity list. name: zimperium-policy-device-inactivity-list outputs: - contextPath: Zimperium.PolicyDeviceInactivity.teamId description: The team ID for the policy device inactivity. type: String - contextPath: Zimperium.PolicyDeviceInactivity.id description: The policy device inactivity ID. type: String - contextPath: Zimperium.PolicyDeviceInactivity.name description: The name of the policy device inactivity list. type: String - arguments: - description: The identifier of the policy. Can be retrieved using zimperium-policy-device-inactivity-list. name: policy_id required: true description: Get policy device inactivity. name: zimperium-policy-device-inactivity-get outputs: - contextPath: Zimperium.PolicyDeviceInactivity.id description: The policy device inactivity ID. type: String - contextPath: Zimperium.PolicyDeviceInactivity.accountId description: The account identifier. type: String - contextPath: Zimperium.PolicyDeviceInactivity.created description: The date and time the policy was created. type: Date - contextPath: Zimperium.PolicyDeviceInactivity.groups.id description: The group ID. type: String - contextPath: Zimperium.PolicyDeviceInactivity.groups.name description: The group name. type: String - contextPath: Zimperium.PolicyDeviceInactivity.inactiveAppSettings.enabled description: Whether the app settings inactivity is enabled. type: Boolean - contextPath: Zimperium.PolicyDeviceInactivity.inactiveAppSettings.maxWarningsCount description: The maximum number of warnings that can be issued for an app. type: Number - contextPath: Zimperium.PolicyDeviceInactivity.inactiveAppSettings description: The inactive app settings. type: Boolean - contextPath: Zimperium.PolicyDeviceInactivity.modified description: The policy modified date. type: Date - contextPath: Zimperium.PolicyDeviceInactivity.name description: The name of the policy. type: String - contextPath: Zimperium.PolicyDeviceInactivity.pendingActivationSettings.enabled description: Whether the device's policy setting is enabled or not. type: Boolean - contextPath: Zimperium.PolicyDeviceInactivity.pendingActivationSettings.maxWarningsCount description: The maximum number of warnings that can be issued for the policy. type: Number - contextPath: Zimperium.PolicyDeviceInactivity.pendingActivationSettings.sendEmailAndroid description: Whether to send an email. type: Boolean - contextPath: Zimperium.PolicyDeviceInactivity.pendingActivationSettings.sendEmailIos description: Whether to send an email. type: Boolean - contextPath: Zimperium.PolicyDeviceInactivity.pendingActivationSettings.timeBeforeWarningDisplayUnits description: The time before the warning display. type: String - contextPath: Zimperium.PolicyDeviceInactivity.pendingActivationSettings.timeBeforeWarningSeconds description: The time before the warning seconds. type: Number - contextPath: Zimperium.PolicyDeviceInactivity.pendingActivationSettings.timeBetweenWarningsDisplayUnits description: The time interval between warning displays. type: String - contextPath: Zimperium.PolicyDeviceInactivity.pendingActivationSettings.timeBetweenWarningsSeconds description: The time in seconds between warnings. type: Number - contextPath: Zimperium.PolicyDeviceInactivity.teamId description: The team ID for the policy device inactivity. type: String dockerimage: demisto/python3:3.12.13.10116658 isfetch: true runonce: false script: '-' subtype: python3 type: python tests: - Zimperiumv2-TestPlaybook defaultmapperin: Zimperium v2 - Incoming Mapper