IF Commons GitHub

SOC 2 Trust Services Criteria catalog package

0002Active

0002-soc2-package · owner if · domain commons

Requirements

FR-001checkpassing

The package MUST hold one grc.framework with the id soc2-tsc and the version 2017, whose 61 controls are the criteria: the common criteria CC1.1 to CC9.2 (33, the criteria of Security), availability A1.1 to A1.3, confidentiality C1.1 and C1.2, processing integrity PI1.1 to PI1.5, and privacy P1.1 to P8.1 (18); each with its identifier, a title, a statement and its series (CC6) as its family, and no identifier twice.

Enforced (check): .github: cd commons/catalog-soc2 && bun run verify — suite/soc2.test.ts

Proved by: catalog-soc2/suite/soc2.test.ts

Written in: catalog-soc2/src/governance/criteria.ts, catalog-soc2/src/logical/convert.ts

Tests: passed: suite/soc2.test.ts the real package loads through the catalog loader with the 61 criteria in the 20 series, a; passed: suite/soc2.test.ts the conversion keeps each criterion with its series as family, the same every time, and sa

Cited by: governance/criteria, Catalog Soc2, logical/convert

FR-002checkpassing

The manifest MUST record the publication the identifiers refer to (publisher, edition, address), the SHA-256 of the source file the package was made from, the licence wording, and that the content may be redistributed; the package MUST load through readCatalogPackage of grc with no problem.

Enforced (check): .github: cd commons/catalog-soc2 && bun run verify — suite/soc2.test.ts

Proved by: catalog-soc2/suite/soc2.test.ts

Written in: catalog-soc2/src/governance/source.ts, catalog-soc2/src/physical/package.ts

Tests: passed: suite/soc2.test.ts the real package loads through the catalog loader with the 61 criteria in the 20 series, a; passed: suite/soc2.test.ts the manifest records the reference, the digest of the source file on disk, the licence and

Cited by: governance/source, Catalog Soc2, physical/package

FR-003checkpassing

The package MUST be made by tools/generate.ts from src/governance/criteria.ts and never edited by hand; --check MUST find any file of the package that differs from what the source gives, including a source whose digest is not the one recorded.

Enforced (check): .github: cd commons/catalog-soc2 && bun run verify — suite/soc2.test.ts

Proved by: catalog-soc2/suite/soc2.test.ts

Written in: catalog-soc2/src/physical/package.ts, catalog-soc2/tools/generate.ts

Tests: passed: suite/soc2.test.ts the generator finds no difference between the package on disk and the source, and reports

Cited by: Catalog Soc2, physical/package

FR-004checkpassing

The conversion MUST be a pure function of the criteria: the same criteria give the same documents, byte for byte, with no clock and no network; the conversion MUST say which identifier a source repeats, and the package MUST NOT be made from a source that repeats one.

Enforced (check): .github: cd commons/catalog-soc2 && bun run verify — suite/soc2.test.ts

Proved by: catalog-soc2/suite/soc2.test.ts

Written in: catalog-soc2/src/logical/convert.ts, catalog-soc2/src/physical/package.ts

Tests: passed: suite/soc2.test.ts the conversion keeps each criterion with its series as family, the same every time, and sa; passed: suite/soc2.test.ts the same criteria give the same files, byte for byte

Cited by: Catalog Soc2, logical/convert, physical/package

FR-005checkpassing

The package MUST NOT carry text of the AICPA's publication: the titles and statements are our own reading, the licence wording MUST say so, and no statement may be a sentence the publication prints (the points of focus and illustrative controls are not carried at all).

Enforced (check): .github: cd commons/catalog-soc2 && bun run verify — suite/soc2.test.ts

Proved by: catalog-soc2/suite/soc2.test.ts

Written in: catalog-soc2/src/governance/criteria.ts, catalog-soc2/src/governance/source.ts

Tests: passed: suite/soc2.test.ts the licence says the content is our own reading and the AICPA's text is not carried, and n

Cited by: governance/criteria, governance/source, Catalog Soc2

Acceptance scenarios

  1. Given the criteria, When the package is made, Then it has 61 controls in 20 series, and the identifiers CC6.1, A1.2, C1.2, PI1.3 and P6.7 are among them, per FR-001.
  2. Given a criteria source that is edited, When --check runs, Then it reports that the data differs, per FR-003.

Out of scope

  • The AICPA's points of focus, its illustrative controls and its description criteria (DC 200): not carried.
  • Mappings of the criteria to SP 800-53, CMMC or other frameworks: later crosswalk packages.
  • Which categories a report covers: the engagement's scope, not the catalog.

Edge cases

  • A criteria list that repeats an identifier is refused, per FR-004.

Assumptions

  • The identifiers follow the 2017 criteria with the revised points of focus of 2022, which changed the points of focus and not the criteria.

Open questions

  • None.

Key entities

  • Criterion, Series, Package.

Success criteria

SC-001success criterion

A report or a piece of evidence can name any SOC 2 criterion by its identifier and read what it asks, from framework data, without the AICPA's text.

Review & acceptance checklist

  • [x] Every requirement is testable (MUST / MUST NOT), not aspirational
  • [x] No company fact is asserted here
  • [x] Every open item is marked, not silently decided

Cited by

governance/criteria, governance/source, Catalog Soc2, logical/convert, physical/package

Titles, headings, exports, tables, columns and requirements. Esc closes.