Docs Integrations
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
Note
MAQPNA, llamay and kosa8 are all Kosa8 Labs products. To run them together, from a laptop to a
cluster, follow the Kosa8 Labs stack section.
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#
Previous Run agents in kosa8 sandboxes Next Keycloak (OIDC)
On this page