01 · Connectors
Register any system as a connector.
A connector is the bridge between an external system and the AIROTECH Connect™ event fabric. Any language, any platform, any vendor — registered through one authenticated endpoint, authenticated through four interchangeable methods, rotatable without dropped events.
What you get
- Four auth methods
- RSA-signed credentials
- 60-second rotation grace
- HMAC signature verification
- OAuth2 + API key transports
- Per-tenant isolation
One endpoint. Any system.
Register a connector through POST /api/connectors/register with the system name, webhook URL, and preferred authentication method. The platform returns a SHA-256-hashed credential that is displayed once and never again, plus a tenant-scoped webhook path for inbound events. Any system that can send an HTTP request with a signed body or a bearer token can be a connector — there are no SDKs to install and no language lock-in.
Four authentication methods.
HMAC-SHA256 for systems that sign request bodies with a shared secret. OAuth2 for systems that exchange credentials for short-lived bearer tokens, cached with automatic refresh. API-key for simpler integrations. RSA-signed for high-trust or regulated transports. Every inbound event at /api/events/ingest validates against the method declared on the connector record — mismatches are rejected before the payload is read.
Rotation without dropped events.
Credential rotation issues a new credential while keeping the previous one valid for a 60-second overlap window. Downstream senders update their configuration at their own pace; events signed under the old credential continue to validate for the grace period. The audit log records every rotation with actor identity and UTC timestamp.
Tenant isolation from the database up.
Every connector belongs to exactly one tenant. Data access is scoped by tenant_id at every endpoint; the message bus partitions topics under airotech.{tenant_id}.{event_type}. Cross-tenant visibility does not exist at any layer of the stack.
Continue reading