Skip to content

Commit 8216072

Browse files
committed
feat(s132): the control mapping, held to the tree and to NIST's catalogue
Slice 132, stacked on slice 130 (PR #117), whose image it maps. docs/regulated/control-mapping.md maps Trinity's mechanisms to NIST SP 800-53 Rev 5 and SP 800-218. It opens by saying what it is not: an assessment, an ATO, an SSP, or a claim that any baseline is met. - SP 800-53: 65 rows across 45 controls; 25 Trinity's, 25 shared and 15 the deployment's. - SP 800-218: 13 SSDF task rows. - Every family and practice with no row is listed with its reason. test/control_mapping_test.exs holds the document to the tree: - every row's path, test, Mix task or function must exist; - every identifier must be active in NIST's OSCAL catalogues, pinned by commit and SHA-256 in usnistgov/oscal-content, CC0; - a row's ownership must match the responsibility matrix and the standards register; - the opening's disclaimers and the forbidden words are checked; - every regulated refusal, census test and gate step is cited or listed with a reason. Each rule has a planted violation; R1 to R7 are in the slice NOTES. The matrix was stale, and the first run found it: it still said the model allow-list was NOT IN TREE, which the regulated profile has enforced since regulated-boot. That row is corrected. Nine rows are added for the regulated profile, transport and access, and the container image, including two the pack had not stated: - connections to Trinity are plain HTTP; - the web pages, among them the permissions page where approvals are answered, carry no authentication, while the image binds every interface. Signed-off-by: Ayla Croft <aylacroft@proton.me>
1 parent bf854ec commit 8216072

13 files changed

Lines changed: 3013 additions & 6 deletions

‎CHANGELOG.md‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,25 @@ evidence for each increment is retained by the maintainers and summarised here.
2424

2525
## 2026-10-08
2626

27+
### `slice/132`: a control mapping an assessor can check against the tree
28+
29+
The regulated pack explained the boundary, the data flow, the cryptography and who owns what, and
30+
named not one control. `docs/regulated/control-mapping.md` now states which NIST SP 800-53 Rev. 5
31+
controls and SP 800-218 practices each mechanism in this tree contributes to, where the mechanism
32+
lives, what proves it, and whether the rest of the control is Trinity's, shared, or the
33+
deployment's. It opens with what it is not: not an assessment, not an authorization to operate, not
34+
a System Security Plan, and not a claim that any baseline is met.
35+
36+
The mapping is checked rather than maintained. A test fails when a row names a file that has moved,
37+
a test or function that no longer exists, or a control identifier that NIST's own catalogue, pinned
38+
by commit and digest, does not have; when a row's ownership disagrees with the customer
39+
responsibility matrix or its status with the standards register; and when a refusal of the regulated
40+
profile, a census, a step of the gate, a row of the matrix or a control family is left unmapped. The
41+
matrix was brought up to date first. It still said nothing refused an unapproved model, which the
42+
regulated profile has done since it landed, and it now also covers the gateway allow-list, the
43+
external authority, transport, the web pages' lack of their own authentication, and the container
44+
image.
45+
2746
### `slice/130`: the headless image, hardened, and checked as built
2847

2948
The headless container is what a government program would actually run, and it was built to run

‎LICENSES/CC0-1.0.txt‎

Lines changed: 121 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,121 @@
1+
Creative Commons Legal Code
2+
3+
CC0 1.0 Universal
4+
5+
CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
6+
LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
7+
ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
8+
INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
9+
REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
10+
PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
11+
THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
12+
HEREUNDER.
13+
14+
Statement of Purpose
15+
16+
The laws of most jurisdictions throughout the world automatically confer
17+
exclusive Copyright and Related Rights (defined below) upon the creator
18+
and subsequent owner(s) (each and all, an "owner") of an original work of
19+
authorship and/or a database (each, a "Work").
20+
21+
Certain owners wish to permanently relinquish those rights to a Work for
22+
the purpose of contributing to a commons of creative, cultural and
23+
scientific works ("Commons") that the public can reliably and without fear
24+
of later claims of infringement build upon, modify, incorporate in other
25+
works, reuse and redistribute as freely as possible in any form whatsoever
26+
and for any purposes, including without limitation commercial purposes.
27+
These owners may contribute to the Commons to promote the ideal of a free
28+
culture and the further production of creative, cultural and scientific
29+
works, or to gain reputation or greater distribution for their Work in
30+
part through the use and efforts of others.
31+
32+
For these and/or other purposes and motivations, and without any
33+
expectation of additional consideration or compensation, the person
34+
associating CC0 with a Work (the "Affirmer"), to the extent that he or she
35+
is an owner of Copyright and Related Rights in the Work, voluntarily
36+
elects to apply CC0 to the Work and publicly distribute the Work under its
37+
terms, with knowledge of his or her Copyright and Related Rights in the
38+
Work and the meaning and intended legal effect of CC0 on those rights.
39+
40+
1. Copyright and Related Rights. A Work made available under CC0 may be
41+
protected by copyright and related or neighboring rights ("Copyright and
42+
Related Rights"). Copyright and Related Rights include, but are not
43+
limited to, the following:
44+
45+
i. the right to reproduce, adapt, distribute, perform, display,
46+
communicate, and translate a Work;
47+
ii. moral rights retained by the original author(s) and/or performer(s);
48+
iii. publicity and privacy rights pertaining to a person's image or
49+
likeness depicted in a Work;
50+
iv. rights protecting against unfair competition in regards to a Work,
51+
subject to the limitations in paragraph 4(a), below;
52+
v. rights protecting the extraction, dissemination, use and reuse of data
53+
in a Work;
54+
vi. database rights (such as those arising under Directive 96/9/EC of the
55+
European Parliament and of the Council of 11 March 1996 on the legal
56+
protection of databases, and under any national implementation
57+
thereof, including any amended or successor version of such
58+
directive); and
59+
vii. other similar, equivalent or corresponding rights throughout the
60+
world based on applicable law or treaty, and any national
61+
implementations thereof.
62+
63+
2. Waiver. To the greatest extent permitted by, but not in contravention
64+
of, applicable law, Affirmer hereby overtly, fully, permanently,
65+
irrevocably and unconditionally waives, abandons, and surrenders all of
66+
Affirmer's Copyright and Related Rights and associated claims and causes
67+
of action, whether now known or unknown (including existing as well as
68+
future claims and causes of action), in the Work (i) in all territories
69+
worldwide, (ii) for the maximum duration provided by applicable law or
70+
treaty (including future time extensions), (iii) in any current or future
71+
medium and for any number of copies, and (iv) for any purpose whatsoever,
72+
including without limitation commercial, advertising or promotional
73+
purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
74+
member of the public at large and to the detriment of Affirmer's heirs and
75+
successors, fully intending that such Waiver shall not be subject to
76+
revocation, rescission, cancellation, termination, or any other legal or
77+
equitable action to disrupt the quiet enjoyment of the Work by the public
78+
as contemplated by Affirmer's express Statement of Purpose.
79+
80+
3. Public License Fallback. Should any part of the Waiver for any reason
81+
be judged legally invalid or ineffective under applicable law, then the
82+
Waiver shall be preserved to the maximum extent permitted taking into
83+
account Affirmer's express Statement of Purpose. In addition, to the
84+
extent the Waiver is so judged Affirmer hereby grants to each affected
85+
person a royalty-free, non transferable, non sublicensable, non exclusive,
86+
irrevocable and unconditional license to exercise Affirmer's Copyright and
87+
Related Rights in the Work (i) in all territories worldwide, (ii) for the
88+
maximum duration provided by applicable law or treaty (including future
89+
time extensions), (iii) in any current or future medium and for any number
90+
of copies, and (iv) for any purpose whatsoever, including without
91+
limitation commercial, advertising or promotional purposes (the
92+
"License"). The License shall be deemed effective as of the date CC0 was
93+
applied by Affirmer to the Work. Should any part of the License for any
94+
reason be judged legally invalid or ineffective under applicable law, such
95+
partial invalidity or ineffectiveness shall not invalidate the remainder
96+
of the License, and in such case Affirmer hereby affirms that he or she
97+
will not (i) exercise any of his or her remaining Copyright and Related
98+
Rights in the Work or (ii) assert any associated claims and causes of
99+
action with respect to the Work, in either case contrary to Affirmer's
100+
express Statement of Purpose.
101+
102+
4. Limitations and Disclaimers.
103+
104+
a. No trademark or patent rights held by Affirmer are waived, abandoned,
105+
surrendered, licensed or otherwise affected by this document.
106+
b. Affirmer offers the Work as-is and makes no representations or
107+
warranties of any kind concerning the Work, express, implied,
108+
statutory or otherwise, including without limitation warranties of
109+
title, merchantability, fitness for a particular purpose, non
110+
infringement, or the absence of latent or other defects, accuracy, or
111+
the present or absence of errors, whether or not discoverable, all to
112+
the greatest extent permissible under applicable law.
113+
c. Affirmer disclaims responsibility for clearing rights of other persons
114+
that may apply to the Work or any use thereof, including without
115+
limitation any person's Copyright and Related Rights in the Work.
116+
Further, Affirmer disclaims responsibility for obtaining any necessary
117+
consents, permissions or other rights required for any use of the
118+
Work.
119+
d. Affirmer understands and acknowledges that Creative Commons is not a
120+
party to this document and has no duty or obligation with respect to
121+
this CC0 or use of the Work.

‎README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -319,6 +319,7 @@ do over the next year, and why the order is what it is.
319319
| `docs/adr/` | Architecture decision records. One is added whenever a decision changes |
320320
| `docs/10-assurance-case.md` | The structured argument that the security claims hold, with the evidence for each and the assumptions and limits named |
321321
| `docs/09-standards-register.md` | One row per control a regulated deployment may ask about, with its evidence path and status |
322+
| `docs/regulated/` | The pack for a regulated deployment: boundary, data flow, responsibility matrix, cryptographic inventory, the hardened image and its STIG statement, and `control-mapping.md`, which maps each mechanism to the NIST SP 800-53 controls and SP 800-218 practices it contributes to and says whose the rest of each control is. The mapping is not an assessment, and a test fails when a path, check or control identifier it names stops existing |
322323
| `lib/`, `test/`, `config/` | The application |
323324
| `src-tauri/` | The native desktop shell |
324325
| `scripts/`, `credo_checks/` | The release check, the benchmark scripts and this project's own Credo checks |

‎REUSE.toml‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,3 +56,14 @@ path = ["lib/trinity_web/components/layouts/root.html.heex"]
5656
precedence = "aggregate"
5757
SPDX-FileCopyrightText = "Sudo Apt Holdings LLC"
5858
SPDX-License-Identifier = "Apache-2.0"
59+
60+
# Slice 132. **Not ours either.** The identifier lists the control mapping is checked against are
61+
# derived from NIST's OSCAL catalogues (`usnistgov/oscal-content`), which that repository dedicates
62+
# to the public domain under CC0 1.0; each file's header names the commit and the SHA-256 of the
63+
# catalogue it came from, and `scripts/nist_catalogues.exs` re-derives them. The `**/*.tsv` line
64+
# above would otherwise assign them to this project.
65+
[[annotations]]
66+
path = ["test/support/fixtures/nist/**"]
67+
precedence = "override"
68+
SPDX-FileCopyrightText = "National Institute of Standards and Technology"
69+
SPDX-License-Identifier = "CC0-1.0"

‎docs/regulated/README.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -65,12 +65,14 @@ model prompt and what may not. Read both before the others.
6565
| `crypto-inventory.md` | Every cryptographic capability, its module, and its certificate status |
6666
| `headless-image.md` | How the container image is built and hardened, and the checks run against it |
6767
| `stig-applicability.md` | The image's STIG applicability statement, generated from OpenSCAP's evaluation of it |
68+
| `control-mapping.md` | Which NIST SP 800-53 controls and SP 800-218 practices each mechanism contributes to, and whose the rest of each control is |
6869

6970
## Status of this pack
7071

7172
This directory is documentation only. It adds no code, changes no behaviour, and asserts no control
7273
that is not already in the tree. `stig-applicability.md` is generated rather than written, and says
73-
how. Where the tree does not implement something this pack names, the
74-
row says **NOT IN TREE** rather than describing an intention.
74+
how. `control-mapping.md` is held to the tree by `test/control_mapping_test.exs`, which fails when a
75+
path, a check or a control identifier it names stops existing. Where the tree does not implement
76+
something this pack names, the row says **NOT IN TREE** rather than describing an intention.
7577

7678
This pack documents the gap; it does not close it.

0 commit comments

Comments
 (0)