Skip to content
This repository was archived by the owner on Jul 1, 2025. It is now read-only.

Commit 65fb0b4

Browse files
authored
Add documentation for image-has-checksum (#143)
1 parent 86e207d commit 65fb0b4

File tree

1 file changed

+27
-1
lines changed

1 file changed

+27
-1
lines changed

content/documentation/ssp/4-ssp-template-to-oscal-mapping.md

Lines changed: 27 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1170,17 +1170,20 @@ count(/*/system-implementation/user[1]/authorized-privilege[1]/function-performe
11701170

11711171
## External Systems and Services Not Having FedRAMP Authorization
11721172

1173-
FedRAMP authorized services should be used, whenever possible, since their risk is defined. However, there are instances where CSOs have external systems or services that are not FedRAMP authorized. In OSCAL, these external systems and services must be identified using `component` assemblies with additional FedRAMP namespace and class properties as shown in the OSCAL representation below.
1173+
FedRAMP authorized services should be used, whenever possible, since their risk is defined. However, there are instances where CSOs have external systems or services that are not FedRAMP authorized. In OSCAL, these external systems and services must be identified using `component` assemblies with additional FedRAMP namespace and class properties as shown in example 1 of the OSCAL representation below.
11741174

11751175
For components that describe external systems and services that are not FedRAMP-authorized and not part of a leveraged authorization, the component must identify the kind of connection security in use to protect data in transit (for example, IPSec VPN).
11761176

1177+
Additionally, container images or operating system virtual machines used by the CSO must be identified with FedRAMP and class properties as shown in example 2 of the OSCAL representation below, including a property with a name of `checksum` and a string value of the checksum of the image used.
1178+
11771179
The nature-of-agreement property identifies acceptable agreement types.
11781180

11791181
{{< figure src="/img/ssp-figure-17.png" title="FedRAMP SSP template external systems (not FedRAMP authorized)." alt="Screenshot of the external system information for non-FedRAMP authorized services in the FedRAMP SSP template." >}}
11801182

11811183
#### OSCAL Representation
11821184
{{< highlight xml "linenos=table" >}}
11831185
<!-- list any external connections as components in the system-characteristics -->
1186+
<!-- Example 1, external service -->
11841187
<component uuid="uuid-value" type="service">
11851188
<title>[EXAMPLE]External System / Service Name</title>
11861189
<description>
@@ -1227,6 +1230,29 @@ The nature-of-agreement property identifies acceptable agreement types.
12271230
<link href="#uuid-of-ICA-resource-in-back-matter" rel="isa-agreement" />
12281231
<!-- cut repeat responsible-party assembly for each required ICA role id -->
12291232
</component>
1233+
<!-- Example 2, a container image -->
1234+
<component uuid="11111111-2222-4000-8000-009000309803" type="software">
1235+
<title>Official container image for Debian Stable</title>
1236+
<description>
1237+
<p>FUNCTION: This container image is the base operating system used in the example. A notional CSP, like Awesome Cloud, would update and customize this image for business, reliability, and security needs.</p>
1238+
</description>
1239+
<prop name="asset-type" value="image"/>
1240+
<prop name="checksum" ns="http://fedramp.gov/ns/oscal" value="504931a74cb58330cafb9f59f5e553af3cc63af205dc955f7f80dc981276def0"/>
1241+
<prop ns="http://fedramp.gov/ns/oscal" name="scan-type" value="infrastructure"/>
1242+
<prop name="vendor-name" value="Software in the Public Interest"/>
1243+
<prop name="model" value="stable-slim"/>
1244+
<prop name="version" value="11"/>
1245+
<prop name="patch-level" value="Patch Level"/>
1246+
<link rel="validation" href="#11111111-2222-4000-8000-009000000002"/>
1247+
<link href="https://hub.docker.com/layers/library/debian/stable/images/sha256-e83913597ca9deb9d699316a9a9d806c2a87ed61195ac66ae0a8ac55089a84b9"/>
1248+
<status state="operational"/>
1249+
<responsible-role role-id="admin-unix">
1250+
<party-uuid>11111111-2222-4000-8000-004000000010</party-uuid>
1251+
</responsible-role>
1252+
<remarks>
1253+
<p>This example container image is for a non-commercial, community-maintained Linux distribution as a non-normative example with a currently valid checksum. See a link above to the example image metadata and technical details from its officially published location on the Docker Hub registry.</p>
1254+
</remarks>
1255+
</component>
12301256
<!-- cut …. -->
12311257
<back-matter>
12321258
<resource uuid="uuid-value">

0 commit comments

Comments
 (0)