Open-source AI Security Operations Center: alert fusion, LLM-agent triage, MITRE ATT&CK investigation, and a replayable decision ledger for every agent step. Self-hostable, runs with no API keys, MIT licensed. Ships an MCP server for Claude, Cursor and Continue.
AiSOC Connectors Service
A Python/FastAPI service that polls external security sources on a schedule, normalises raw events into OCSF, and forwards them to the ingest pipeline.
Highlights
- Click-and-connect — add a source via the UI wizard; credentials are
encrypted at rest with Fernet (
CredentialVault) before they leave the API service. - Registry-based discovery — drop a
BaseConnectorsubclass intoapp/connectors/and register it in__init__.py. No other wiring needed. - APScheduler polling — one in-process job per enabled connector instance, 5-min default cadence, configurable per-instance.
- Federated search — translate a single query into SPL, KQL, and ES|QL and fan out to connected SIEMs.
- Five-tier severity — every connector's
normalize()emits one ofinfo | low | medium | high | critical. A vendor ladder that publishes a distinctcriticalmust map tocriticaland must not be collapsed intohigh; 50 of the connector modules rely on that tier today.
Supported connectors
84 connectors are registered in _CONNECTOR_CLASSES
(app/connectors/__init__.py), which is the only source of truth. The count
and its per-category breakdown are generated into
apps/web/src/data/connector-count.json
by scripts/generate_connector_count.py, and --check gates it in CI, so a
hand-written table here would go stale the day the next connector lands.
Per-connector setup walkthroughs live under
apps/docs/docs/connectors/ and are
indexed in the docs sidebar.
Quick start
# From the repo root
cp .env.example .env # set AISOC_CREDENTIAL_KEY, DATABASE_URL, etc.
pnpm docker:dev # bring up Postgres, Redis, Kafka, etc.
# Run the service
cd services/connectors
python -m uvicorn app.main:app --reload --port 8003
Disable the polling scheduler in tests:
AISOC_CONNECTORS_DISABLE_SCHEDULER=1 pytest
Writing a new connector
- Create
app/connectors/<name>.pyand subclassBaseConnector. - Implement
schema(),test_connection(),poll(), andnormalize(). - Add your class to
_CONNECTOR_CLASSESinapp/connectors/__init__.py. - Add a marketplace manifest at
plugins/<connector-id>/plugin.yaml. - Add a docs walkthrough at
apps/docs/docs/connectors/<connector-id>.md. - Run
pnpm marketplace:syncandpytest.
See CONTRIBUTING.md in the repo root for the full checklist.
Tests
cd services/connectors
python -m pytest tests/ -v
Current suite covers schema contracts, polling, normalisation, federated query translation, and credential decryption.