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.
Python agentic-aiai-securityalert-triageblue-teamcybersecuritydetection-engineeringincident-responselanggraphllm-agentsmcpmitre-attackmodel-context-protocolpurple-teamsecurity-operationsself-hostedsiemsoarsocthreat-detectionthreat-intelligence
"""POST /api/v1/osquery/distributed/enqueue — internal API for playbook engine.
This endpoint is NOT part of the standard osquery TLS plugin spec.
It is called by the AiSOC action client (``aisoc_direct_client``) to enqueue
a distributed query targeted at a specific host by its host_identifier.
Authentication uses the same bearer-token mechanism as the rest of the
internal service APIs (Authorization: Bearer <AISOC_OSQUERY_TLS_API_TOKEN>).
"""
from __future__ import annotations
from typing import Annotated
from fastapi import APIRouter, Depends, HTTPException, status
from pydantic import BaseModel
from sqlalchemy.ext.asyncio import AsyncSession
from app.db.session import get_db
from app.security.tenant_scope import (
TenantPrincipal,
require_console_or_service_auth,
scoped_tenant_or_403,
)
from app.services.distributed_queue import enqueue_query
from app.services.node_registry import get_node_by_host
router = APIRouter()
#: The console reaches this service directly through a Next rewrite, so the
#: FIM and pack surfaces are internet-reachable. The tenant comes from the
#: caller's credential; a `tenant_id` on the request is a filter intersected
#: with it, never a selector.
ScopedPrincipal = Annotated[TenantPrincipal, Depends(require_console_or_service_auth)]
class EnqueueRequest(BaseModel):
host_identifier: str
query_text: str
#: Optional. Intersected with the caller's scope; when omitted the
#: credential's own tenant is used.
tenant_id: str | None = None
class EnqueueResponse(BaseModel):
query_id: str
@router.post("/distributed/enqueue", response_model=EnqueueResponse)
async def distributed_enqueue(
body: EnqueueRequest,
principal: ScopedPrincipal,
db: Annotated[AsyncSession, Depends(get_db)],
) -> EnqueueResponse:
# A distributed query runs arbitrary osquery SQL on a live endpoint, so
# the tenant is resolved from the credential before any node lookup.
scoped = str(scoped_tenant_or_403(principal, body.tenant_id))
node = await get_node_by_host(db, body.host_identifier, scoped)
if node is None:
raise HTTPException(
status_code=status.HTTP_404_NOT_FOUND,
detail=f"Node {body.host_identifier!r} not enrolled for tenant {scoped!r}",
)
dq = await enqueue_query(db, node, body.query_text)
return EnqueueResponse(query_id=dq.query_id)