Trust boundaries and data flows
Map where trust changes and where data, artifacts, requests, identities, tools, and evidence cross a boundary.
Before you start
Module prerequisites: SAI-220, SAI-240, SAI-250. Check the exercise-specific tools and environment before running commands.
Module outcomes: Define an allowlisted tool registry; Design human approval and confinement boundaries; Produce verifiable run receipts for agent actions. This lesson contributes to that sequence.
What a trust boundary represents
A trust boundary is a place where the assumptions, authority, identity, policy, or level of control changes. Crossing a network segment may create a boundary, but boundaries also occur between users, tenants, identity domains, administrative teams, data classifications, build stages, and human approval states.
The purpose of a boundary diagram is not visual decoration. It should reveal where validation, authorization, inspection, evidence, or explicit acceptance is required.
Map flows, not just boxes
For each flow, record:
- Source and destination.
- Data or artifact type and classification.
- Initiating identity and delegated identity.
- Protocol or transfer mechanism.
- Required policy decision.
- Encryption and key authority.
- Logging and evidence produced.
- Failure, retry, and rejection behavior.
Number important flows so controls and evidence can refer to the diagram precisely.
Boundaries in the knowledge-assistant example
The SAI-100 running example contains at least these boundaries:
- User to application: authenticate the user, establish context, and constrain input.
- Application to retrieval: propagate identity and enforce document permissions.
- Retrieval to model: provide only approved context and prevent unapproved egress.
- Model to application: inspect output, preserve citations, and handle unsupported answers.
- Connected import to internal artifact store: scan, verify, approve, and record imported artifacts.
- Build environment to runtime: promote only approved, identified releases.
- Runtime to evidence store: protect and retain events needed for investigation and assurance.
- Operator to platform: constrain privileged actions and preserve administrative evidence.
Draw four complementary views
One diagram rarely serves every audience. Use:
- A system context view for actors, external systems, ownership, and major flows.
- A trust-zone view for control changes and permitted connections.
- A deployment view for runtime, storage, networks, and administrative planes.
- A lifecycle or supply-chain view for artifact movement from source to approval and operation.
Keep component names and flow identifiers consistent across views.
Boundary review questions
- Does every external dependency appear?
- Can administrators bypass the application’s policy path?
- Where can information leave the approved environment?
- Where do public artifacts enter, and who approves them?
- Does user identity survive retrieval and tool execution?
- Which flow produces evidence when a request is blocked?
- Can an update change behavior without a new approval?
- What remains operational if an external control plane is unavailable?
Output
Produce a diagram plus a boundary register:
Boundary ID:
Source and destination:
Trust change:
Allowed flows:
Control owner:
Required controls:
Evidence:
Known gap or accepted dependency:
SAI-110 expands this shared foundation into threat scenarios, misuse cases, attack surfaces, and control verification. It should reference this chapter rather than duplicate it.
Module worked example
A reviewer approves a proposal, then another process changes a selected source file.
- Apply the control
- Bind approval to the displayed diff and original source hashes, then recheck all targets before writing.
- Expected result
- The stale proposal is rejected without applying an earlier file in the same change set.
- Troubleshooting
- Distinguish rejection, application failure and uncertain partial state. Reconcile side effects before retrying.
Practice and completion check
Choose one control from this lesson. Identify its actor, target, enforcement point and expected result. Describe an allowed case and a denied or failed case. For a runnable exercise, retain observed output and separate it from expected output. Record unresolved limitations before marking the lesson complete.
Your lesson progress
Completion is self-reported learning progress; it does not certify practical competence.
Status: Not marked
Loading your learning record…