Cypho Threat Intelligence
This integration enables your organization to efficiently collect, analyze, and respond to actionable cyber alerts generated within the Cypho platform enhancing visibility, automation, and overall security posture.
Utilities · Cypho Threat Intelligence
Details
| ID | Cypho Threat Intelligence |
|---|---|
| Provider | Cypho |
| Category | Utilities |
| From Version | 6.10.0 |
| Docker Image | demisto/python3:3.12.12.5490952 |
README
This integration enables your organization to efficiently collect, analyze, and respond to actionable cyber alerts generated within the Cypho platform enhancing visibility, automation, and overall security posture.
Configure Cypho Threat Intelligence in Cortex
| Parameter | Required |
|---|---|
| Server URL (e.g. https://api.cypho.io/external/v1/) | True |
| Maximum number of incidents per fetch | False |
| API Key | True |
| First fetch time | False |
| Trust any certificate (not secure) | False |
| Incidents Fetch Interval | False |
| Tenant Name | False |
| Fetch incidents | False |
| Incident type | False |
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.
cypho-get-incident
Retrieves the full details of a specific security incident from Cypho using its unique ticket_id. This command returns the raw response from the Cypho API, including metadata such as title, status, risk level, category, timestamps, impacted asset, and more.This command is intended for debugging purposes only and should not be used in production playbooks.
Base Command
cypho-get-incident
Input
| Argument Name | Description | Required |
|---|---|---|
| ticket_id | The ticket_id is the unique ID used to identify and manage each incident across automations and integrations. | Optional |
Context Output
There is no context output for this command.
cypho-assign-incident
Assign a Cypho issue to an analyst by constructing their email from the given username and domain. The incident is assigned and updated with this user’s email.
Base Command
cypho-assign-incident
Input
| Argument Name | Description | Required |
|---|---|---|
| ticket_id | The ticket_id is the unique ID used to identify and manage each incident across automations and integrations. | Optional |
| user_email | The user_email field stores the email address of the user, and it must match the email of a registered user in the Cypho platform to ensure correct user mapping and permission handling. | Optional |
Context Output
There is no context output for this command.
cypho-add-comment
This command sends a comment as the status_reason parameter and attributes it to a user constructed from the provided username and domain. It is used to log investigation notes or analyst input directly on the issue.
Base Command
cypho-add-comment
Input
| Argument Name | Description | Required |
|---|---|---|
| ticket_id | The ticket_id is the unique ID used to identify and manage each incident across automations and integrations. | Optional |
| status_reason | The status_reason field stores a comment or explanation describing the reason for an incident’s current status, and this note is added directly to the incident record in the Cypho platform. | Optional |
| user_email | The user_email field stores the email address of the user, and it must match the email of a registered user in the Cypho platform to ensure correct user mapping and permission handling. | Optional |
Context Output
There is no context output for this command.
cypho-update-severity
Updates the severity level of a specific Cypho issue using its unique ticket ID. This command is used to escalate or de-escalate the risk level (“Low”, “Moderate”, or “Critical”) based on analysis or triage.
Base Command
cypho-update-severity
Input
| Argument Name | Description | Required |
|---|---|---|
| ticket_id | The ticket_id is the unique ID used to identify and manage each incident across automations and integrations. | Optional |
| user_email | The user_email field stores the email address of the user, and it must match the email of a registered user in the Cypho platform to ensure correct user mapping and permission handling. | Optional |
| severity | The severity field indicates the criticality level of an incident, helping teams prioritize and manage response efforts effectively. | Optional |
Context Output
There is no context output for this command.
cypho-download-attachment
Downloads one or more attachments from a Cypho incident using the incident’s unique “ticket_id”. The command retrieves the attachment URLs from the issue and returns the files directly to the War Room. Useful for reviewing screenshots, logs, or other evidence related to the incident.
Base Command
cypho-download-attachment
Input
| Argument Name | Description | Required |
|---|---|---|
| ticket_id | The ticket_id is the unique ID used to identify and manage each incident across automations and integrations. | Optional |
Context Output
There is no context output for this command.
cypho-approve-dismiss-issue
Approves or dismisses a Cypho issue based on the provided ticket ID, user email, and approval decision.
Base Command
cypho-approve-dismiss-issue
Input
| Argument Name | Description | Required |
|---|---|---|
| ticket_id | The ticket_id is the unique ID used to identify and manage each incident across automations and integrations. | Optional |
| user_email | The user_email field stores the email address of the user, and it must match the email of a registered user in the Cypho platform to ensure correct user mapping and permission handling. | Optional |
| approve | A boolean argument that, when set to true, approves the issue, and when set to false, dismisses it. Possible values are: True, False. | Optional |
Context Output
There is no context output for this command.
Configuration parameters
url— Server URL (e.g. https://api.cypho.io/external/v1/) (required)max_fetch— Maximum number of incidents per fetchapikey— (required)first_fetch— First fetch timeinsecure— Trust any certificate (not secure)incidentFetchInterval— Incidents Fetch Intervaltenant— Tenant NameisFetch— Fetch incidentsincidentType— Incident type
Commands (6)
-
cypho-add-commentThis command sends a comment as the status_reason parameter and attributes it to a user constructed from the provided username and domain. It is used to log investigation notes or analyst input directly on the issue.
-
cypho-approve-dismiss-issueApproves or dismisses a Cypho issue based on the provided ticket ID, user email, and approval decision.
-
cypho-assign-incidentAssign a Cypho issue to an analyst by constructing their email from the given username and domain. The incident is assigned and updated with this user’s email.
-
cypho-download-attachmentDownloads one or more attachments from a Cypho incident using the incident's unique "ticket_id". The command retrieves the attachment URLs from the issue and returns the files directly to the War Room. Useful for reviewing screenshots, logs, or other evidence related to the incident.
-
cypho-get-incidentRetrieves the full details of a specific security incident from Cypho using its unique ticket_id. This command returns the raw response from the Cypho API, including metadata such as title, status, risk level, category, timestamps, impacted asset, and more.This command is intended for debugging purposes only and should not be used in production playbooks.
-
cypho-update-severityUpdates the severity level of a specific Cypho issue using its unique ticket ID. This command is used to escalate or de-escalate the risk level ("Low", "Moderate", or "Critical") based on analysis or triage.
### Cypho Threat Intelligence Integration #### Author Mahammad Rehimov #### Overview This integration ingests threat intelligence indicators, category metadata, incidents, ticket state updates, and file attachments from the Cypho platform into Cortex XSOAR for enrichment and automation. It synchronizes the lifecycle of Cypho issues so that XSOAR incidents accurately reflect the current state of Cypho tickets. The integration streamlines SOC workflows, reduces manual effort, and preserves SLA accountability tracking such as MTTR (Mean Time to Resolve) and assignment-based analyst ownership metrics. #### Key Capabilities - Automatically fetch and map new incidents from Cypho into Cortex XSOAR. - Apply threat enrichment and normalization using XSOAR automation modules. - Synchronize severity, comments, approvals, and dismissal states. - Import ticket file artifacts and append them to the incident timeline. - Enforce assignment-first accountability tracking to preserve SOC metrics like MTTR and analyst ownership accuracy. #### Use Case – SOC Workflow Automation Within SOC operations, this integration acts as a silent background automation layer performing the following: 1. Pulls and normalizes Cypho alert and ticket data. 2. Maps the ingested data to the correct Cortex XSOAR Incident Types and fields. 3. Extracts and enriches threat indicators before analyst interaction. 4. Synchronizes updates silently to maintain lifecycle parity with Cypho. 5. Maintains accountability, analyst ownership, and SLA accuracy without repeated manual input. #### Documentation Cypho API Documentation: docs.cypho.io