sections enterprise

Enterprise

Active contributors: Andy Taylor, Eno Reyes, Sagar Narayan

Purpose

docs/enterprise/ is the section organizations evaluate before deploying Factory at scale. It covers privacy, identity, network/deployment, model/gateway integrations, plugin governance, telemetry, and audit/compliance. The CLI-side docs/cli/account/ security pages (Droid Shield) are linked into this section's navigation in docs/docs.json even though the files physically live under cli/.

Directory layout

docs/enterprise/
├── index.mdx                                       # Landing page
├── privacy-and-data-flows.mdx
├── llm-safety-and-agent-controls.mdx
├── identity-and-access.mdx
├── identity-sso-and-scim.mdx                       # Largest enterprise page (~23 KB)
├── hierarchical-settings-and-org-control.mdx       # ~18 KB
├── network-and-deployment.mdx
├── models-llm-gateways-and-integrations.mdx
├── enterprise-plugin-registry.mdx                  # ~11 KB
├── github-integration-security.mdx                 # ~9 KB
├── telemetry-export.mdx
├── compliance-audit-and-monitoring.mdx
└── usage-cost-and-analytics.mdx

Content groups (per docs.json)

The "Enterprise" group in docs/docs.json is split into four sub-groups:

Sub-group	Pages
Security	cli/account/security, cli/account/droid-shield-plus, enterprise/privacy-and-data-flows, enterprise/llm-safety-and-agent-controls
Identity & Governance	enterprise/identity-and-access, enterprise/identity-sso-and-scim, enterprise/hierarchical-settings-and-org-control
Architecture & Deployment	enterprise/network-and-deployment, enterprise/models-llm-gateways-and-integrations, enterprise/enterprise-plugin-registry, enterprise/github-integration-security
Analytics & Compliance	enterprise/usage-cost-and-analytics, enterprise/telemetry-export, enterprise/compliance-audit-and-monitoring

Key source files

File	Purpose
docs/enterprise/index.mdx	Enterprise overview / landing
docs/enterprise/privacy-and-data-flows.mdx	What data Factory sees, where it goes, retention
docs/enterprise/identity-sso-and-scim.mdx	SSO providers + SCIM provisioning flow
docs/enterprise/hierarchical-settings-and-org-control.mdx	Org → team → user setting precedence and overrides
docs/enterprise/network-and-deployment.mdx	VPC, on-prem, air-gapped deployment topologies
docs/enterprise/models-llm-gateways-and-integrations.mdx	Model providers and gateway integrations (cross-links to BYOK)
docs/enterprise/enterprise-plugin-registry.mdx	Org-controlled plugin registry
docs/enterprise/github-integration-security.mdx	The GitHub App's security model in detail
docs/enterprise/telemetry-export.mdx	Exporting droid telemetry to customer systems
docs/enterprise/compliance-audit-and-monitoring.mdx	Audit trails and compliance posture
docs/enterprise/usage-cost-and-analytics.mdx	Usage and cost surfaces; cross-links to the analytics API
docs/cli/account/droid-shield-plus.mdx	The premium Droid Shield tier (linked into Security)

Integration points

• The Security sub-group cross-references docs/cli/account/security.mdx and the Droid Shield pages in cli/account/.
• Identity & Governance cross-links to the analytics API at docs/reference/analytics-api.mdx.
• Plugin registry cross-links to docs/cli/configuration/plugins.mdx and the building guide at docs/guides/building/building-plugins.mdx.
• The GitHub integration page complements the user-facing GitHub App page at docs/integrations/github-app.mdx.

Entry points for modification

• New enterprise topic → add docs/enterprise/<topic>.mdx and place it in the right sub-group of docs.json (Security / Identity & Governance / Architecture & Deployment / Analytics & Compliance).
• Page split — large pages like identity-sso-and-scim.mdx are good split candidates if a sub-topic grows; promote it to its own page and add a redirect if the URL changes.
• Enterprise pages have a higher prose bar than the CLI tutorial pages — they're often read by procurement and security teams. Be precise; cite specific paths and protocols.