MAQPNADocs

Integrations overview

Every system MAQPNA connects to, from identity providers and SPIRE to OpenTelemetry, SIEMs, secret vaults, chat notifications, sandboxes, model providers, policy engines and clouds, and where each one plugs in.

MAQPNA governs agents at one point, the MAQPNA gateway, and keeps its own identity broker, operator and audit ledger. Everything else is something you already run: your identity provider, your observability stack, your SIEM, your key manager, your model providers and your clouds. This page lists every integration that exists in the code today, grouped by what it does, and links to the page that sets it up.

All outbound connections from the gateway (identity provider discovery, SIEM, collector, notifier, model and cloud calls) go through its residency-checked dialer. With a sovereignty policy, each endpoint must be allowed there.

Where integrations plug in#

flowchart LR
    subgraph People
      IDP["Identity provider<br/>Keycloak, Entra ID, Okta"]
      CHAT["Slack, Teams,<br/>Matrix, webhook"]
    end
    subgraph Cluster["Your cluster"]
      OP["MAQPNA operator"]
      BR["Identity broker"]
      GW["MAQPNA gateway"]
      SB["Sandbox<br/>gVisor, Kata, CoCo, kosa8"]
      SP["SPIRE"]
    end
    subgraph Upstreams
      MCP["MCP servers"]
      LLM["Model providers<br/>Bedrock, Vertex, Azure, llamay"]
    end
    subgraph Evidence
      OTEL["OTel Collector"]
      SIEM["SIEM<br/>Splunk, Sentinel, SecOps, CloudWatch"]
      WORM[("WORM storage")]
      REKOR["Rekor"]
    end
    KMS["KMS, Vault Transit,<br/>secret managers"]
    IDP -->|"OIDC, CIBA"| GW
    GW -->|"approvals, alerts"| CHAT
    OP --> SB
    SP -->|"X.509-SVID"| SB
    BR -->|"session token"| SB
    SB -->|"governed calls"| GW
    GW --> MCP
    GW --> LLM
    GW -->|"OTLP"| OTEL
    GW -->|"audit sinks"| SIEM
    GW --> WORM
    GW -->|"anchors"| REKOR
    KMS -->|"keys, secrets"| GW
    KMS --> BR

Identity and sign-in#

Integration What it does Page
OIDC single sign-on (Keycloak, Entra ID, Okta, Google, any OIDC provider) Console and CLI sign-in; groups become viewer, approver, auditor, admin and killswitch roles Keycloak and OIDC
User approval (OpenID CIBA) The person an agent acts for confirms a sensitive call on their own device Keycloak and OIDC
External MCP clients IDE and desktop coding agents call /mcp/<server> with your identity provider's tokens (OAuth protected resource metadata, step-up scopes) Keycloak and OIDC
Verified session users The operator checks AgentSession users against Kubernetes requester identity or ID tokens Identity and delegation
Identity checks before minting The broker verifies where a session will run before it issues a token Identity checks

Workload identity#

Integration What it does Page
SPIFFE / SPIRE X.509-SVIDs bound to session tokens; the gateway checks the client certificate SPIRE
DPoP (RFC 9449) Session tokens bound to a key the agent holds in memory DPoP
Cloud workload identity (EKS Pod Identity and IRSA, GKE Workload Identity Federation, AKS Entra Workload ID, OKE) Keyless access from MAQPNA components to cloud APIs, and broker token exchange to cloud credentials for agents Cloud identity & keys
Confidential VM attestation (AMD SEV-SNP, Intel TDX) tier-2 sessions get a token only after their hardware report is verified Attestation

Telemetry#

Integration What it does Page
OpenTelemetry (OTLP/HTTP) Gateway spans with GenAI and MCP semantic conventions, linked to audit records OpenTelemetry, GenAI telemetry
Prometheus and Grafana /metrics on the operator, gateway and attestation service, ServiceMonitor, shipped alerts and dashboards Monitoring, alerts and runbooks

SIEM and audit evidence#

Integration What it does Page
Syslog, HTTP (OCSF, CEF, JSON), JSONL file Stream ledger records to any SIEM SIEM and audit forwarding
Splunk HEC, Microsoft Sentinel, Google SecOps, Amazon CloudWatch Logs Cloud-native SIEM sinks with keyless credentials SIEM and audit forwarding
WORM storage (S3 Object Lock, GCS Bucket Lock, Azure immutable Blob) Write-once copy of sealed ledger segments SIEM and audit forwarding
Provider audit import (AWS CloudTrail, OpenAI, Anthropic) Pull what happened at the provider into the ledger as evidence Hyperscaler interop
Sigstore Rekor Anchor ledger heads in a public or private transparency log Transparency log
Offline edge forwarding Edge gateways store and forward ledger segments Offline edge

Secrets and keys#

Integration What it does Page
Per-user token vault (GitHub, Microsoft 365, Google, Salesforce, Slack, generic OAuth, ID-JAG) Users connect accounts once; the gateway injects their token Secret vaults
HashiCorp Vault and OpenBao Transit, AWS KMS, Cloud KMS, Azure Key Vault, PKCS#11 HSM Signing keys that never leave the key manager Secret vaults, Cloud identity & keys
Secrets Store CSI driver, External Secrets Operator MAQPNA's own secrets from a secret manager, as files or Secrets Cloud identity & keys

Notifications#

Integration What it does Page
Signed webhook, Slack, Microsoft Teams, Matrix Approval requests and decisions, revocations, budget alerts; approve or deny from Slack and Teams Notifications

Sandboxes#

Integration What it does Page
kubernetes-sigs/agent-sandbox with gVisor, Kata + Firecracker, confidential VMs The trust tiers on Kubernetes Sovereignty and confidential tiers
kosa8 microVMs Local sandboxes that reach only the gateway, with live fork kosa8 sandboxes
Sandbox drivers The contract that lets the same governance run on other substrates Sandbox drivers

Models and agent frameworks#

Integration What it does Page
OpenAI-compatible, Amazon Bedrock, Vertex AI and Gemini, Azure OpenAI, Anthropic, OCI Generative AI, sovereign EU providers Governed model routes with provider-native authentication Model providers
llamay Local inference engine with a forkable context per session llamay models
LangGraph, LangChain, OpenAI Agents SDK, Claude Agent SDK, CrewAI, Vercel AI SDK Governed tools inside agent frameworks Framework adapters

Policy engines#

Integration What it does Page
Cedar ToolPolicy.spec.cedar, evaluated by the gateway Write policies
Open Policy Agent (Rego) Optional OPA sidecar decision (gateway.policyAdapters.rego) Write policies
Export to Cedar, CEL, Rego and AgentCore Write once, enforce in other engines Policy export
WebAssembly The native policy engine as a Wasm module for any host Policy Wasm

Clouds and configuration delivery#

Integration What it does Page
EKS, GKE, AKS, OpenShift, RKE2 profiles Per-cloud Helm profiles, cloud WORM and SIEM sinks, FQDN egress Cloud profiles
Hyperscaler interop Push policy to provider platforms and pull their audit logs Hyperscaler interop
Signed configuration bundles Ship policies and config to gateways without a Kubernetes API Config bundles
Kubernetes operations The built-in maqpna-k8s MCP server for SRE agents Governed cluster operations

Next steps#