# Connected Systems overview
Connected System is the product term for one governed vendor or platform integration. Integrators configure system-level manifest sections (system.*) before modeling individual Business Entities.
Who this is for
Integrators and agents configuring authentication, roles, subscriptions, AI interfaces, and lifecycle for one systemKey.
Prerequisites
- Get started — scaffold a Connected System
- Builder CLI authenticated (
aifabrix auth status) - Edit Connected Systems with Builder API when using Builder API help topics
Where it lives
| Artifact | Location |
|---|---|
| System manifest | integration/<systemKey>/<systemKey>-system.json |
| Application manifest | integration/<systemKey>/application.yaml |
| Secrets | env.template with kv:// references |
| Dataplane UI | Connected Systems → select system → tabs (Overview, Business Entities, Authentication, …) |
Manifest section keys map to UI tabs — see UI terminology map.
Configure pages (system manifest)
| Topic | Configure page | Manifest keys |
|---|---|---|
| Identity and kind | Basics and kind | system.basics, system.kind |
| Entity list | Business Entities in this system | system.businessEntities |
| Auth | Configure authentication | system.authentication |
| Non-secret config | Configure system configuration | system.configuration |
| RBAC | Configure roles and permissions | system.rolesPermissions |
| Event subscriptions | Configure subscriptions | system.subscriptions |
| MCP / OpenAPI exposure | Configure AI interfaces | system.aiInterfaces |
| Download / repair | Lifecycle, download, and repair | system.lifecycle |
Each configure page includes a Builder MCP table (section key, UI tab, help topics). Use help topic section with the section key before patching.
How to set
- Create or scaffold the Connected System (Create a Connected System).
- Set basics and kind, then authentication.
- Add Business Entity JSON files — see Business Entities band.
- Run
aifabrix repair <systemKey>when derived sections drift, thenaifabrix validate <systemKey>. - Upload when green; add live secrets in dataplane Authentication after upload (see Edit Connected Systems with Builder API).
Limits
Policy management and optional UI modules vary by tenant. Confirm live tabs with help topic connectedSystemUi.