# opencti-platform/connectors architecture

> Architecture diagram of the GitHub repository opencti-platform/connectors, 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/opencti-platform/connectors
- Repository: https://github.com/opencti-platform/connectors

## Overview

This repository is an OpenCTI integration suite: connectors import intelligence, enrich platform observables, export platform data, and bridge streaming or file-based workflows. The clearest sampled runtime paths are Matrix event ingestion and AssemblyLine malware analysis; most other connector families are represented by their exact directories because their implementations were not sampled. Edges without source-level evidence are omitted, so the graph emphasizes documented capabilities and verified calls rather than assuming a common connector pipeline.

Main entry points: [`internal-enrichment/assemblyline/src/main.py`](https://github.com/opencti-platform/connectors/blob/master/internal-enrichment/assemblyline/src/main.py) (AssemblyLine analysis), [`internal-export-file/export-file-ods/src/main.py`](https://github.com/opencti-platform/connectors/blob/master/internal-export-file/export-file-ods/src/main.py) (ODS export worker), [`connectors-sdk/connectors_sdk/connectors/external_import/_work_manager.py`](https://github.com/opencti-platform/connectors/blob/master/connectors-sdk/connectors_sdk/connectors/external_import/_work_manager.py) (Work manager), [`external-import/matrix/src/main.py`](https://github.com/opencti-platform/connectors/blob/master/external-import/matrix/src/main.py) (Matrix event importer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sdk["Connector SDK"]
  node_sdk_client["Platform API client<br/>[base_client_api.py]"]
  node_sdk_import["Import framework"]
  node_sdk_work["Work manager<br/>[_work_manager.py]"]
  node_sdk_models["STIX models"]
  node_sdk_settings["Connector settings<br/>[base_settings.py]"]
end

subgraph group_imports["External Imports"]
  node_ext_connectors["External-import connectors"]
  node_matrix["Matrix event importer<br/>[main.py]"]
  node_hunt_batch["Hunt.IO batch manager<br/>[batch_manager.py]"]
  node_import_converters["STIX conversion"]
end

subgraph group_enrichment["Enrichment"]
  node_enrichment_connectors["Enrichment connectors"]
  node_assemblyline["AssemblyLine analysis<br/>[main.py]"]
  node_spectra["Spectra analysis<br/>[main.py]"]
  node_orion["Orion analysis<br/>[main.py]"]
end

subgraph group_exchange["Data Exchange"]
  node_stream_connectors["Streaming connectors"]
  node_file_imports["File import connectors"]
  node_ods_export["ODS export worker<br/>[main.py]"]
  node_ods_render["ODS rendering helpers<br/>[rendering.py]"]
end

node_platform(("OpenCTI platform"))
node_external_sources(("Threat sources"))
node_external_services(("Analysis services"))

node_external_sources -->|"delivers events"| node_matrix
node_matrix -->|"sends STIX bundles"| node_platform
node_assemblyline -->|"submits files"| node_external_services
node_assemblyline -->|"publishes analysis"| node_platform
node_hunt_batch -->|"sends bundles"| node_platform
node_sdk_work -->|"creates work and sends bundles"| node_platform
node_ods_export -->|"fetches entities"| node_platform
node_ods_export -.->|"renders spreadsheet"| node_ods_render
node_ext_connectors -.->|"integrates with"| node_platform
node_enrichment_connectors -.->|"enriches data"| node_platform
node_stream_connectors -.->|"integrates with"| node_platform
node_file_imports -.->|"imports data"| node_platform
node_import_converters -.->|"uses STIX types"| node_sdk_models
node_sdk_import -.->|"manages work"| node_sdk_work
node_sdk_client -.->|"communicates with"| node_platform

click node_sdk_client "https://github.com/opencti-platform/connectors/blob/master/connectors-sdk/connectors_sdk/client/base_client_api.py"
click node_sdk_import "https://github.com/opencti-platform/connectors/blob/master/connectors-sdk/connectors_sdk/connectors/external_import/external_import_connector.py"
click node_sdk_work "https://github.com/opencti-platform/connectors/blob/master/connectors-sdk/connectors_sdk/connectors/external_import/_work_manager.py"
click node_sdk_models "https://github.com/opencti-platform/connectors/tree/master/connectors-sdk/connectors_sdk/models"
click node_sdk_settings "https://github.com/opencti-platform/connectors/blob/master/connectors-sdk/connectors_sdk/settings/base_settings.py"
click node_ext_connectors "https://github.com/opencti-platform/connectors/tree/master/external-import"
click node_matrix "https://github.com/opencti-platform/connectors/blob/master/external-import/matrix/src/main.py"
click node_hunt_batch "https://github.com/opencti-platform/connectors/blob/master/external-import/hunt-io/src/external_import_connector/batch_manager.py"
click node_import_converters "https://github.com/opencti-platform/connectors/tree/master/external-import"
click node_enrichment_connectors "https://github.com/opencti-platform/connectors/tree/master/internal-enrichment"
click node_assemblyline "https://github.com/opencti-platform/connectors/blob/master/internal-enrichment/assemblyline/src/main.py"
click node_spectra "https://github.com/opencti-platform/connectors/blob/master/internal-enrichment/reversinglabs-spectra-analyze/src/main.py"
click node_orion "https://github.com/opencti-platform/connectors/blob/master/internal-enrichment/orion-malware/src/main.py"
click node_stream_connectors "https://github.com/opencti-platform/connectors/tree/master/stream"
click node_file_imports "https://github.com/opencti-platform/connectors/tree/master/internal-import-file"
click node_ods_export "https://github.com/opencti-platform/connectors/blob/master/internal-export-file/export-file-ods/src/main.py"
click node_ods_render "https://github.com/opencti-platform/connectors/blob/master/internal-export-file/export-file-ods/src/lib/rendering.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_sdk_client,node_sdk_import,node_sdk_work,node_sdk_models,node_sdk_settings toneBlue
class node_ext_connectors,node_matrix,node_hunt_batch,node_import_converters toneAmber
class node_enrichment_connectors,node_assemblyline,node_spectra,node_orion toneMint
class node_stream_connectors,node_file_imports,node_ods_export,node_ods_render toneRose
class node_platform,node_external_sources,node_external_services toneIndigo
```

## Components

### Connector SDK

- [Platform API client](https://github.com/opencti-platform/connectors/blob/master/connectors-sdk/connectors_sdk/client/base_client_api.py): `connectors-sdk/connectors_sdk/client/base_client_api.py`
- [Import framework](https://github.com/opencti-platform/connectors/blob/master/connectors-sdk/connectors_sdk/connectors/external_import/external_import_connector.py): `connectors-sdk/connectors_sdk/connectors/external_import/external_import_connector.py`
- [Work manager](https://github.com/opencti-platform/connectors/blob/master/connectors-sdk/connectors_sdk/connectors/external_import/_work_manager.py): `connectors-sdk/connectors_sdk/connectors/external_import/_work_manager.py`
- [STIX models](https://github.com/opencti-platform/connectors/tree/master/connectors-sdk/connectors_sdk/models): `connectors-sdk/connectors_sdk/models`
- [Connector settings](https://github.com/opencti-platform/connectors/blob/master/connectors-sdk/connectors_sdk/settings/base_settings.py): `connectors-sdk/connectors_sdk/settings/base_settings.py`

### External Imports

- [External-import connectors](https://github.com/opencti-platform/connectors/tree/master/external-import): `external-import`
- [Matrix event importer](https://github.com/opencti-platform/connectors/blob/master/external-import/matrix/src/main.py): `external-import/matrix/src/main.py`
- [Hunt.IO batch manager](https://github.com/opencti-platform/connectors/blob/master/external-import/hunt-io/src/external_import_connector/batch_manager.py): `external-import/hunt-io/src/external_import_connector/batch_manager.py`
- [STIX conversion](https://github.com/opencti-platform/connectors/tree/master/external-import): `external-import`

### Enrichment

- [Enrichment connectors](https://github.com/opencti-platform/connectors/tree/master/internal-enrichment): `internal-enrichment`
- [AssemblyLine analysis](https://github.com/opencti-platform/connectors/blob/master/internal-enrichment/assemblyline/src/main.py): `internal-enrichment/assemblyline/src/main.py`
- [Spectra analysis](https://github.com/opencti-platform/connectors/blob/master/internal-enrichment/reversinglabs-spectra-analyze/src/main.py): `internal-enrichment/reversinglabs-spectra-analyze/src/main.py`
- [Orion analysis](https://github.com/opencti-platform/connectors/blob/master/internal-enrichment/orion-malware/src/main.py): `internal-enrichment/orion-malware/src/main.py`

### Data Exchange

- [Streaming connectors](https://github.com/opencti-platform/connectors/tree/master/stream): `stream`
- [File import connectors](https://github.com/opencti-platform/connectors/tree/master/internal-import-file): `internal-import-file`
- [ODS export worker](https://github.com/opencti-platform/connectors/blob/master/internal-export-file/export-file-ods/src/main.py): `internal-export-file/export-file-ods/src/main.py`
- [ODS rendering helpers](https://github.com/opencti-platform/connectors/blob/master/internal-export-file/export-file-ods/src/lib/rendering.py): `internal-export-file/export-file-ods/src/lib/rendering.py`

### Other components

- **OpenCTI platform**
- **Threat sources**
- **Analysis services**

## Connections

- Threat sources → Matrix event importer: delivers events (evidence: `external-import/matrix/src/main.py`)
- Matrix event importer → OpenCTI platform: sends STIX bundles (evidence: `external-import/matrix/src/main.py`)
- AssemblyLine analysis → Analysis services: submits files (evidence: `internal-enrichment/assemblyline/src/main.py`)
- AssemblyLine analysis → OpenCTI platform: publishes analysis (evidence: `internal-enrichment/assemblyline/src/main.py`)
- Hunt.IO batch manager → OpenCTI platform: sends bundles (evidence: `external-import/hunt-io/src/external_import_connector/batch_manager.py`)
- Work manager → OpenCTI platform: creates work and sends bundles (evidence: `connectors-sdk/connectors_sdk/connectors/external_import/_work_manager.py`)
- ODS export worker → OpenCTI platform: fetches entities (evidence: `internal-export-file/export-file-ods/src/main.py`)
- ODS export worker → ODS rendering helpers: renders spreadsheet (evidence: `internal-export-file/export-file-ods/src/main.py`)
- External-import connectors → OpenCTI platform: integrates with
- Enrichment connectors → OpenCTI platform: enriches data
- Streaming connectors → OpenCTI platform: integrates with
- File import connectors → OpenCTI platform: imports data
- STIX conversion → STIX models: uses STIX types (evidence: `connectors-sdk/connectors_sdk/models/enums.py`)
- Import framework → Work manager: manages work
- Platform API client → OpenCTI platform: communicates with
