Skip to content

3.2 Integration & Data Flow View

Minimum 4+1 Process (adapted)

The Integration & Data Flow View describes how data moves through the solution, how components communicate, and how the solution integrates with internal and external systems. It addresses the concerns of integrators, operations teams, and architects.

Recommended

Illustrate how data moves through the solution from input to output, showing transformations and processing stages.

[Insert data flow diagram(s)]

Guidance

Consider showing:

  • Data ingestion and sourcing
  • Processing and transformation steps
  • Data outputs and destinations
  • Asynchronous vs synchronous flows
  • Event-driven patterns and message queues
Minimum

Document the connectivity between internal components of the solution:

Source ComponentDestination ComponentProtocol / EncryptionAuthentication MethodPurpose
[component][component][e.g., HTTPS/TLS 1.3][e.g., mTLS, API Key][purpose]

Guidance

List all connections between the solution’s internal components. For each connection, document:

  • Connection initiator (source) and receiver (destination)
  • Protocol and encryption standard used
  • Authentication and authorisation method
  • Whether the connection is synchronous or asynchronous
Minimum

Document how the solution interfaces with external systems, third-party services, and other internal applications:

Source ApplicationDestination ApplicationProtocol / EncryptionAuthenticationSecurity ProxyPurpose
[app name / ID][app name / ID][protocol][method][if applicable][purpose]

Document how end users access the solution:

User TypeAccess MethodAuthenticationProtocol
[e.g., Internal employees][e.g., Web browser via SSO][e.g., SAML/OIDC][HTTPS]
[e.g., External customers][e.g., API][e.g., OAuth 2.0][HTTPS]
Comprehensive

Document the key APIs and interfaces exposed or consumed by the solution:

API / InterfaceTypeDirectionFormatVersionDocumentation
[name]REST / GraphQL / gRPC / SOAP / EventExposed / ConsumedJSON / XML / Protobuf[version][link]

Scoring Guidance

ScoreWhat This Looks Like
1Data flow diagram exists but interfaces not detailed
3All internal and external integrations documented with protocols, authentication, and direction
5All of the above plus API contracts versioned, SLA/SLO defined per interface, user access patterns documented

Quality Attribute Cross-References:

  • 4.1 Operational Excellence - Integration failures are a major source of incidents
  • 4.2 Reliability - External dependencies affect reliability posture
  • 4.3 Performance - Network latency and throughput in integration paths