AIOSDNA Connector Architecture

The AIOSDNA Connector Architecture provides a unified framework for integrating external systems with the AIOSDNA Control Plane. It enables secure, reliable data flow from edge systems to the central intelligence layer.

Overview

┌─────────────────────────────────────────────────────────────────────────────┐
│                          AIOSDNA Control Plane                               │
├─────────────────────────────────────────────────────────────────────────────┤
│  ┌──────────────┐   ┌───────────────────┐   ┌──────────────────┐           │
│  │  Ingestion   │──▶│  Normalization    │──▶│     Routing      │           │
│  │    Layer     │   │      Layer        │   │      Layer       │           │
│  └──────────────┘   └───────────────────┘   └──────────────────┘           │
│         │                                            │                      │
│         │                                            ▼                      │
│         │                              ┌─────────────────────────┐          │
│         │                              │    Kernel Dispatch      │          │
│         │                              │  Trading│Security│Ops   │          │
│         │                              └─────────────────────────┘          │
└─────────┼───────────────────────────────────────────┼───────────────────────┘
          │                                           │
          │              Outbound Only                │
          ▼                                           ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                              Connectors                                      │
├────────────────┬────────────────┬───────────────┬───────────────────────────┤
│   SDK          │   Mini Agent   │    Data       │      Webhook              │
│  Connectors    │   (Sidecar)    │  Connectors   │     Receivers             │
│                │                │               │                           │
│  • Python SDK  │  • Log Tailer  │  • Snowflake  │  • HTTP Endpoints         │
│  • Node.js SDK │  • DB Poller   │  • BigQuery   │  • Event Ingestion        │
│                │  • HTTP Poller │  • PostgreSQL │                           │
│                │  • Metrics     │               │                           │
└────────────────┴────────────────┴───────────────┴───────────────────────────┘

Quick Links

Getting Started - Set up your first connector
Python SDK - Python client library
Node.js SDK - TypeScript/JavaScript client library
Mini Agent - Sidecar daemon for edge collection
Data Connectors - Warehouse/database integrations
API Reference - REST API documentation
Troubleshooting - Common issues and solutions

Key Concepts

Connectors

Connectors are the bridge between external systems and AIOSDNA. They:

Collect data from various sources (logs, metrics, databases)
Transform events into normalized format
Send securely to the Control Plane via authenticated channels

Event Types

AIOSDNA supports several event categories:

Category	Event Types	Routed To
Trading	`trading.trade_executed`, `trading.order_submitted`, etc.	Trading Kernel
Security	`security.alert`, `security.auth_failure`, etc.	Security Kernel
Operations	`ops.metric`, `ops.log_line`, `ops.service_health`	Ops Kernel

Authentication

All connectors authenticate using API keys:

python
from aiosx.connectors.sdk import AIOSDNAClient

client = AIOSDNAClient(
    api_key="aiosk_your_api_key_here",
    org_id="org_your_org_id",
)

Capabilities

Connectors have capability-based access control:

send_trades - Can send trading events
send_metrics - Can send operational metrics
send_logs - Can send log events
send_security_alerts - Can send security events

Architecture Principles

Intelligence at the Center - Complex processing happens in the Control Plane
Lightweight Edge - Connectors are simple data collectors
Outbound Only - Connectors initiate connections (no inbound ports)
Strong Tenant Isolation - org_id enforced at every layer
Capability-Based Access - Fine-grained permissions per connector

Installation

Python SDK

bash
pip install aiosdna-sdk

Node.js SDK

bash
npm install @aiosdna/sdk

Mini Agent

bash
# Docker
docker run -d aiosdna/mini-agent:latest

# Binary
curl -sSL https://get.aiosdna.io/mini-agent | bash

connectors-README