Skip to content
Docs
foxborne.comRequest a pilot

Integrations overview

Foxborne sends nothing out of your network until an admin turns on egress for a destination. The Connect group of the console holds the integration catalog, the alert rules and the automations, and a delivery ledger records every message that leaves.

ExplanationMarkdown
On this page10

A self-hosted deployment starts with no path out. It sends no telemetry, crash reports or license checks, and it calls no map or tile service. Each destination on these pages stays off until an admin turns on its egress.

The console groups this work under Connect in the sidebar, between Data and Administration:

PageAddressWhat the page says it holds
Integrations/app/integrations"Where Foxborne sends alerts, tickets, logs and exports, and what it listens on. Egress is off by default, and an admin turns on each destination."
Alerts/app/alerts"Alert rules decide who hears about a finding, how fast and with how much detail."
Automations/app/automations"What Foxborne does on its own when a sortie closes out or an alert fires."

The sidebar counts flag what needs a person. Integrations shows, in amber, how many deliveries sit in the dead-letter queue. Automations shows how many runs are held for approval.

The Integrations page#

Integrations has four tabs, each with its own address:

TabAddressWhat it shows
Destinations/app/integrationsThe outbound catalog in three groups, each destination's data class and its Egress switch. Add destination sets up one that is not configured yet.
Ingest/app/integrations/ingestThe endpoints Foxborne listens on and the files it imports, each with its state
Exports/app/integrations/exportsEvery export requested from an incident and the export formats. Approval policy opens the approval rules and the named approvers, and New export starts one.
Delivery ledger/app/integrations/ledgerEvery outbound delivery in the last 7 days, with its payload SHA-256 and the response

Select any row to open its drawer. A destination's drawer shows This deployment (what your program configured), How it connects, Government suitability, any Recent change and the Sources behind each claim. The sources are shown as text: "this deployment has no route to them."

Five families#

The catalog sorts integrations into five families. The Air-gapped column repeats the console's wording: Yes means the integration works with no network path out of the enclave.

Notify#

"Alerts to people: email, chat, pagers and webhooks." See Alerts and Webhooks.

IntegrationProtocolAuthAir-gapped
Email (SMTP relay)SMTP submission, 587 STARTTLS or 465 TLSSMTP AUTH (OAuth for Exchange Online) or relay allowlistYes
MattermostHTTPS webhook or RESTSecret webhook URL or bot tokenYes
Microsoft Teams (GCC High, DoD)Teams bot, or Graph REST at graph.microsoft.us or dod-graph.microsoft.usEntra ID (login.microsoftonline.us)No
Microsoft Teams (commercial, GCC)Workflows webhookTenant OAuth token optionNo
GovSlackHTTPS webhook or Web API on slack-gov.comWebhook URL or bot tokenNo
PagerDutyEvents API v2Routing keyNo
AWS SNS (GovCloud)SNS Publish over HTTPSIAM role (SigV4)No
Generic webhook (HMAC)HTTPS JSON with Standard Webhooks headersHMAC-SHA256, optional mTLSYes
Alertmanager and GrafanaAlertmanager API v2 /api/v2/alerts, or a metrics endpoint Grafana queriesmTLS or bearer through a proxyYes

Ticketing#

"Issues that hold the case link, so work is tracked where the team already tracks it." See Ticketing.

IntegrationProtocolAuthAir-gapped
Jira Data CenterREST v2Personal access token (Bearer)Yes, until end of life
Jira Cloud (Atlassian Government Cloud)REST v3OAuth 2.0 (3LO)No
ServiceNow (GCC, NSC)Table API; Event Management jsonv2OAuth 2.0 or a web-service-only integration userNo
GitLab self-managedIssues API v4, or alert HTTP endpointProject access token; alert Bearer keyYes

Forward logs#

"Findings, the audit log and normalized events for your SIEM or data platform." See Forward logs to your SIEM.

IntegrationProtocolAuthAir-gapped
Syslog over TLSRFC 5424 over RFC 5425 on 6514, with RFC 9662 cipher suitesMutual X.509Yes
Splunk HECHTTPS JSON to /services/collector/event, with ackHEC tokenYes (Enterprise)
Elasticsearch or OpenSearchHTTPS _bulk NDJSONAPI key or mTLSYes (self-managed)
Microsoft SentinelLogs Ingestion API (DCR)Entra client credentials, audience monitor.azure.usNo
KafkaKafka protocolmTLS, or SASL SCRAM or OAUTHBEARER, plus ACLsYes (self-managed)
OTLP exportOTLP/HTTP /v1/logsmTLS or bearerYes
AWS SQS or EventBridgeSendMessage, PutEventsIAM roleNo
S3 with Object LockS3 PutObject via FIPS endpointIAM roleOnly with an on-prem S3-compatible store (vendor-specific)

A destination outside the enclave shows Needs a network path out until it is configured: both Teams entries, GovSlack, PagerDuty, Jira Cloud, ServiceNow and Sentinel. AWS SNS and AWS SQS or EventBridge show Needs a VPC endpoint, because egress is denied at the VPC.

Ingest#

"Endpoints Foxborne listens on, and the files it imports." Connections Foxborne reads from, such as a log bucket, stay on Sources. See Stream logs to Foxborne and Push bundles with the Ingest API.

EndpointProtocolAir-gappedState in the example dataset
HTTPS ingest APIHTTPS POST, chunked and resumable, Content-DigestYesListening, used by Bench rig uploads
S3 bucket watchS3 ObjectCreated to SQSNo; use a watched directory on-premListening, used by Fleet log archive
Fluent Bit or Vector agenthttp, s3 or opentelemetry outputsYesOff
OTLP receiverOTLP/HTTP on 4318YesOff
journald receiversystemd-journal-remote protocol, HTTPS 19532YesOff
Syslog receiverRFC 5425 TLS on 6514YesOff
MAVLink log-pull agentMAVLink LOG_* or MAVLink FTP over the ground link, then HTTPSYesOff
File importUpload, drop folder or removable mediaYesOn, 4 formats, used by Import files
TENA gateway (later phase)TENA middleware adapterYes (range network)Later phase

Planned The TENA gateway, an adapter for the DoD test-range middleware, is a later phase, and nothing listens for it yet.

Export#

"Every format works air-gapped. Destinations are a download, an on-premises share, removable media or S3 in GovCloud." See Export formats and evidence bundles.

FormatClassWhat the console says it holds
MCAPL2The aligned timeline for Foxglove and ROS 2 tools, with the case ID and source SHA-256s in its metadata
Apache ParquetL2One table per signal family, UTC timestamps in microseconds, for fleet analytics
CSV and JSONLL2CSV for spreadsheets and scripts, JSON Lines for SIEM and stream loaders
Original files with SHA-256 manifestL2Byte-identical originals and a sha256sum-style manifest, checked again on export
BagIt evidence bundleL2An RFC 8493 bag with SHA-256 and SHA-512 manifests and the case metadata in bag-info.txt
PDF case file with CUI markingsL1The report, with CUI in the banner and footer of every page and the designation indicator on the first
MATLAB .mat v7.3L2HDF5-based, for flight-test engineers' MATLAB and Simulink tools

Egress, data classes and the ledger#

An admin turns on each destination with a host allowlist, a protocol, a credential reference and a data class. The data class decides what may leave in each message:

  • L0: "Metadata: rule, severity, vehicle alias, UTC time and case link."
  • L1: "Summary with values. Treat it as CUI."
  • L2: "Evidence files. They move only through Export, with approval."

Everything outside the enclave gets L0 by default, and L1 goes only to destinations your program has authorized for CUI. Egress, data classes and the delivery ledger sets out each guardrail and the ledger that records every delivery.

Works without any network path out#

An air-gapped enclave can run a complete set of integrations. Every entry below reads Yes in the Air-gapped column:

  • Notify: Email (SMTP relay) through your own relay, Mattermost, Generic webhook (HMAC) and Alertmanager and Grafana.
  • Ticketing: GitLab self-managed, and Jira Data Center until its end of life on 28 March 2029.
  • Forward logs: Syslog over TLS, Splunk HEC with Splunk Enterprise, OTLP export and self-managed Elasticsearch, OpenSearch or Kafka.
  • Ingest: every endpoint except the S3 bucket watch, including File import and the HTTPS ingest API.
  • Export: every format.

In the example dataset, six destinations have egress on, and the Destinations tab reads "all inside the enclave". They are Syslog over TLS, Email (SMTP relay), Mattermost, Jira Data Center, Splunk HEC and Generic webhook (HMAC).

Next#