# demisto/content architecture

> Architecture diagram of the GitHub repository demisto/content, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/demisto/content
- Repository: https://github.com/demisto/content

## Overview

Cortex XSOAR Content is a catalog of security-operations content hosted and executed by the Cortex XSOAR Platform. The documented workflow is that an analyst configures a playbook, whose tasks use scripts and integration commands to query or act on security products; command output supports subsequent playbook decisions and readable or structured results. The repository also provides reusable API modules and common script support. README documents reports and COPS playbook exchange as additional capabilities. Source excerpts show selected integrations using shared modules; other connections are omitted where implementation was not sampled.

Main entry points: [`Packs/AzureStorage/Integrations/AzureStorage/AzureStorage.py`](https://github.com/demisto/content/blob/master/Packs/AzureStorage/Integrations/AzureStorage/AzureStorage.py) (Azure storage integration), [`Packs/CortexXDR/Integrations/XQLQueryingEngine/XQLQueryingEngine.py`](https://github.com/demisto/content/blob/master/Packs/CortexXDR/Integrations/XQLQueryingEngine/XQLQueryingEngine.py) (XQL integration), [`Packs/Base/Scripts/CommonServerPython/CommonServerPython.py`](https://github.com/demisto/content/blob/master/Packs/Base/Scripts/CommonServerPython/CommonServerPython.py) (Common runtime), [`Packs/AggregatedScripts/Scripts`](https://github.com/demisto/content/tree/master/Packs/AggregatedScripts/Scripts) (Automation scripts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Orchestration content"]
  node_playbooks["Playbooks"]
  node_cops["COPS exchange"]
  node_reports["Reports"]
end

subgraph group_automation["Automation runtime"]
  node_scripts["Automation scripts"]
  node_results["Command results"]
end

subgraph group_connectors["Product connectors"]
  node_aws_integration["AWS integration"]
  node_azure_storage["Azure storage integration<br/>[AzureStorage.py]"]
  node_xql_integration["XQL integration"]
end

subgraph group_shared["Shared capabilities"]
  node_common["Common runtime"]
  node_api_modules["API modules"]
  node_aws_module["AWS API module<br/>[AWSApiModule.py]"]
  node_azure_module["Azure storage module"]
  node_xql_module["Core XQL module"]
end

node_analyst(("Security analyst"))
node_platform["Cortex XSOAR"]
node_security_products["Security products"]

node_analyst -->|"uses"| node_platform
node_analyst -->|"creates tasks"| node_playbooks
node_playbooks -->|"runs in"| node_platform
node_platform -->|"runs scripts"| node_scripts
node_platform -->|"runs commands"| node_aws_integration
node_platform -->|"runs commands"| node_azure_storage
node_platform -->|"runs commands"| node_xql_integration
node_aws_integration -->|"queries or acts"| node_security_products
node_azure_storage -->|"queries or acts"| node_security_products
node_xql_integration -->|"queries"| node_security_products
node_aws_integration -->|"uses"| node_aws_module
node_azure_storage -->|"uses"| node_azure_module
node_xql_integration -->|"uses"| node_xql_module
node_aws_integration -->|"uses"| node_common
node_azure_storage -->|"uses"| node_common
node_xql_integration -->|"uses"| node_common
node_scripts -.->|"uses"| node_common
node_scripts -->|"produce"| node_results
node_aws_integration -->|"returns"| node_results
node_azure_storage -->|"returns"| node_results
node_xql_integration -->|"returns"| node_results
node_playbooks -->|"exports or imports"| node_cops
node_platform -->|"supports"| node_reports

click node_scripts "https://github.com/demisto/content/tree/master/Packs/AggregatedScripts/Scripts"
click node_common "https://github.com/demisto/content/blob/master/Packs/Base/Scripts/CommonServerPython/CommonServerPython.py"
click node_api_modules "https://github.com/demisto/content/tree/master/Packs/ApiModules/Scripts"
click node_aws_module "https://github.com/demisto/content/blob/master/Packs/ApiModules/Scripts/AWSApiModule/AWSApiModule.py"
click node_azure_storage "https://github.com/demisto/content/blob/master/Packs/AzureStorage/Integrations/AzureStorage/AzureStorage.py"
click node_azure_module "https://github.com/demisto/content/blob/master/Packs/ApiModules/Scripts/MicrosoftAzureStorageApiModule/MicrosoftAzureStorageApiModule.py"
click node_xql_integration "https://github.com/demisto/content/blob/master/Packs/CortexXDR/Integrations/XQLQueryingEngine/XQLQueryingEngine.py"
click node_xql_module "https://github.com/demisto/content/blob/master/Packs/ApiModules/Scripts/CoreXQLApiModule/CoreXQLApiModule.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_playbooks,node_cops,node_reports toneBlue
class node_scripts,node_results toneAmber
class node_aws_integration,node_azure_storage,node_xql_integration toneMint
class node_common,node_api_modules,node_aws_module,node_azure_module,node_xql_module toneRose
class node_analyst,node_platform,node_security_products toneIndigo
```

## Components

### Orchestration content

- **Playbooks**
- **COPS exchange**
- **Reports**

### Automation runtime

- [Automation scripts](https://github.com/demisto/content/tree/master/Packs/AggregatedScripts/Scripts): `Packs/AggregatedScripts/Scripts`
- **Command results**

### Product connectors

- **AWS integration**
- [Azure storage integration](https://github.com/demisto/content/blob/master/Packs/AzureStorage/Integrations/AzureStorage/AzureStorage.py): `Packs/AzureStorage/Integrations/AzureStorage/AzureStorage.py`
- [XQL integration](https://github.com/demisto/content/blob/master/Packs/CortexXDR/Integrations/XQLQueryingEngine/XQLQueryingEngine.py): `Packs/CortexXDR/Integrations/XQLQueryingEngine/XQLQueryingEngine.py`

### Shared capabilities

- [Common runtime](https://github.com/demisto/content/blob/master/Packs/Base/Scripts/CommonServerPython/CommonServerPython.py): `Packs/Base/Scripts/CommonServerPython/CommonServerPython.py`
- [API modules](https://github.com/demisto/content/tree/master/Packs/ApiModules/Scripts): `Packs/ApiModules/Scripts`
- [AWS API module](https://github.com/demisto/content/blob/master/Packs/ApiModules/Scripts/AWSApiModule/AWSApiModule.py): `Packs/ApiModules/Scripts/AWSApiModule/AWSApiModule.py`
- [Azure storage module](https://github.com/demisto/content/blob/master/Packs/ApiModules/Scripts/MicrosoftAzureStorageApiModule/MicrosoftAzureStorageApiModule.py): `Packs/ApiModules/Scripts/MicrosoftAzureStorageApiModule/MicrosoftAzureStorageApiModule.py`
- [Core XQL module](https://github.com/demisto/content/blob/master/Packs/ApiModules/Scripts/CoreXQLApiModule/CoreXQLApiModule.py): `Packs/ApiModules/Scripts/CoreXQLApiModule/CoreXQLApiModule.py`

### Other components

- **Security analyst**
- **Cortex XSOAR**
- **Security products**

## Connections

- Security analyst → Cortex XSOAR: uses (evidence: `README.md`)
- Security analyst → Playbooks: creates tasks (evidence: `README.md`)
- Playbooks → Cortex XSOAR: runs in (evidence: `README.md`)
- Cortex XSOAR → Automation scripts: runs scripts (evidence: `README.md`)
- Cortex XSOAR → AWS integration: runs commands (evidence: `README.md`)
- Cortex XSOAR → Azure storage integration: runs commands (evidence: `README.md`)
- Cortex XSOAR → XQL integration: runs commands (evidence: `README.md`)
- AWS integration → Security products: queries or acts (evidence: `README.md`)
- Azure storage integration → Security products: queries or acts (evidence: `README.md`)
- XQL integration → Security products: queries (evidence: `README.md`)
- AWS integration → AWS API module: uses
- Azure storage integration → Azure storage module: uses (evidence: `Packs/AzureStorage/Integrations/AzureStorage/AzureStorage.py`)
- XQL integration → Core XQL module: uses (evidence: `Packs/CortexXDR/Integrations/XQLQueryingEngine/XQLQueryingEngine.py`)
- AWS integration → Common runtime: uses
- Azure storage integration → Common runtime: uses (evidence: `Packs/AzureStorage/Integrations/AzureStorage/AzureStorage.py`)
- XQL integration → Common runtime: uses (evidence: `Packs/CortexXDR/Integrations/XQLQueryingEngine/XQLQueryingEngine.py`)
- Automation scripts → Common runtime: uses
- Automation scripts → Command results: produce (evidence: `README.md`)
- AWS integration → Command results: returns (evidence: `README.md`)
- Azure storage integration → Command results: returns (evidence: `README.md`)
- XQL integration → Command results: returns (evidence: `README.md`)
- Playbooks → COPS exchange: exports or imports (evidence: `README.md`)
- Cortex XSOAR → Reports: supports (evidence: `README.md`)
