Table of Contents

Class ControlSection

Namespace
Excalibur.Compliance
Assembly
Excalibur.Compliance.Abstractions.dll

Control section in SOC 2 report.

public record ControlSection : IEquatable<ControlSection>
Inheritance
ControlSection
Implements
Inherited Members

Properties

Controls

Controls implemented for this criterion.

public required IReadOnlyList<ControlDescription> Controls { get; init; }

Property Value

IReadOnlyList<ControlDescription>

Criterion

Trust Services criterion.

public required TrustServicesCriterion Criterion { get; init; }

Property Value

TrustServicesCriterion

Description

Criterion description.

public required string Description { get; init; }

Property Value

string

Outcome

Whether this criterion was assessed, and if so what was concluded.

public required CriterionOutcome Outcome { get; init; }

Property Value

CriterionOutcome

Remarks

This was a bool, so a criterion nobody assessed and a criterion assessed and found wanting produced the same output: Not Met. Validators are opt-in, so a consumer without one registered for every criterion is the ordinary case rather than an error, and the unassessed criterion lowered their compliance percentage and could move the auditor's opinion on evidence that does not exist.

Uses the same vocabulary as Outcome deliberately: one enum for one idea across the report and the status model, rather than a second spelling of it.

TestResults

Test results (Type II only).

public IReadOnlyList<TestResult>? TestResults { get; init; }

Property Value

IReadOnlyList<TestResult>

ValidationResults

The per-control validation verdicts this section's Outcome was derived from.

public IReadOnlyList<ControlValidationResult> ValidationResults { get; init; }

Property Value

IReadOnlyList<ControlValidationResult>

Remarks

Without this, a section could report NotMet and carry no evidence of WHY. The only per-control channel was Outcome, which answers a different question -- what a test found -- so the effectiveness verdict was smuggled through it and the two facts corrupted each other: forcing a verdict into the test outcome made every control look like an exception, and reporting the test honestly as not-performed made a failing criterion report no findings at all.

Separating them lets each be honest: the test outcome says no sample was drawn, and the verdict here says which controls were found ineffective. A section reporting NotMet is therefore always able to name a cause.