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

IDCypho Threat Intelligence
ProviderCypho
CategoryUtilities
From Version6.10.0
Docker Imagedemisto/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 fetch
  • apikey — (required)
  • first_fetch — First fetch time
  • insecure — Trust any certificate (not secure)
  • incidentFetchInterval — Incidents Fetch Interval
  • tenant — Tenant Name
  • isFetch — Fetch incidents
  • incidentType — Incident type

Commands (6)

  • 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.

  • cypho-approve-dismiss-issue

    Approves or dismisses a Cypho issue based on the provided ticket ID, user email, and approval decision.

  • 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.

  • 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.

  • 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.

  • 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.

### 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