How opencti-platform/connectors works
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: src/main.py AssemblyLine analysis · src/main.py ODS export worker · _work_manager.py Work manager · src/main.py Matrix event importer
Components 20
Connector SDK
- Platform API client
connectors-sdk/connectors_sdk/client/base_client_api.py - Import framework
connectors-sdk/connectors_sdk/connectors/external_import/external_import_connector.py - Work manager
connectors-sdk/connectors_sdk/connectors/external_import/_work_manager.py - STIX models
connectors-sdk/connectors_sdk/models - Connector settings
connectors-sdk/connectors_sdk/settings/base_settings.py
External Imports
- External-import connectors
external-import - Matrix event importer
external-import/matrix/src/main.py - Hunt.IO batch manager
external-import/hunt-io/src/external_import_connector/batch_manager.py - STIX conversion
external-import
Enrichment
- Enrichment connectors
internal-enrichment - AssemblyLine analysis
internal-enrichment/assemblyline/src/main.py - Spectra analysis
internal-enrichment/reversinglabs-spectra-analyze/src/main.py - Orion analysis
internal-enrichment/orion-malware/src/main.py
Data Exchange
- Streaming connectors
stream - File import connectors
internal-import-file - ODS export worker
internal-export-file/export-file-ods/src/main.py - ODS rendering helpers
internal-export-file/export-file-ods/src/lib/rendering.py
Other components
- OpenCTI platform
- Threat sources
- Analysis services
Connections 15
- Threat sources → Matrix event importer: delivers events
external-import/matrix/src/main.py - Matrix event importer → OpenCTI platform: sends STIX bundles
external-import/matrix/src/main.py - AssemblyLine analysis → Analysis services: submits files
internal-enrichment/assemblyline/src/main.py - AssemblyLine analysis → OpenCTI platform: publishes analysis
internal-enrichment/assemblyline/src/main.py - Hunt.IO batch manager → OpenCTI platform: sends bundles
external-import/hunt-io/src/external_import_connector/batch_manager.py - Work manager → OpenCTI platform: creates work and sends bundles
connectors-sdk/connectors_sdk/connectors/external_import/_work_manager.py - ODS export worker → OpenCTI platform: fetches entities
internal-export-file/export-file-ods/src/main.py - ODS export worker → ODS rendering helpers: renders spreadsheet
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
connectors-sdk/connectors_sdk/models/enums.py - Import framework → Work manager: manages work
- Platform API client → OpenCTI platform: communicates with