1 package gov.nist.secauto.oscal.lib.model;
2
3 import gov.nist.secauto.metaschema.binding.model.annotations.AllowedValue;
4 import gov.nist.secauto.metaschema.binding.model.annotations.AllowedValues;
5 import gov.nist.secauto.metaschema.binding.model.annotations.AssemblyConstraints;
6 import gov.nist.secauto.metaschema.binding.model.annotations.BoundAssembly;
7 import gov.nist.secauto.metaschema.binding.model.annotations.BoundField;
8 import gov.nist.secauto.metaschema.binding.model.annotations.BoundFieldValue;
9 import gov.nist.secauto.metaschema.binding.model.annotations.BoundFlag;
10 import gov.nist.secauto.metaschema.binding.model.annotations.Expect;
11 import gov.nist.secauto.metaschema.binding.model.annotations.GroupAs;
12 import gov.nist.secauto.metaschema.binding.model.annotations.IndexHasKey;
13 import gov.nist.secauto.metaschema.binding.model.annotations.IsUnique;
14 import gov.nist.secauto.metaschema.binding.model.annotations.KeyField;
15 import gov.nist.secauto.metaschema.binding.model.annotations.Matches;
16 import gov.nist.secauto.metaschema.binding.model.annotations.MetaschemaAssembly;
17 import gov.nist.secauto.metaschema.binding.model.annotations.ValueConstraints;
18 import gov.nist.secauto.metaschema.model.common.JsonGroupAsBehavior;
19 import gov.nist.secauto.metaschema.model.common.constraint.IConstraint;
20 import gov.nist.secauto.metaschema.model.common.datatype.adapter.DateAdapter;
21 import gov.nist.secauto.metaschema.model.common.datatype.adapter.StringAdapter;
22 import gov.nist.secauto.metaschema.model.common.datatype.adapter.UuidAdapter;
23 import gov.nist.secauto.metaschema.model.common.datatype.markup.MarkupLine;
24 import gov.nist.secauto.metaschema.model.common.datatype.markup.MarkupLineAdapter;
25 import gov.nist.secauto.metaschema.model.common.datatype.markup.MarkupMultiline;
26 import gov.nist.secauto.metaschema.model.common.datatype.markup.MarkupMultilineAdapter;
27 import gov.nist.secauto.metaschema.model.common.util.ObjectUtils;
28 import java.lang.Override;
29 import java.lang.String;
30 import java.util.LinkedList;
31 import java.util.List;
32 import java.util.UUID;
33 import org.apache.commons.lang3.builder.MultilineRecursiveToStringStyle;
34 import org.apache.commons.lang3.builder.ReflectionToStringBuilder;
35
36
37
38
39 @MetaschemaAssembly(
40 formalName = "Component",
41 description = "A defined component that can be part of an implemented system.",
42 name = "defined-component",
43 metaschema = OscalComponentDefinitionMetaschema.class,
44 remarks = "Components may be products, services, APIs, policies, processes, plans, guidance, standards, or other tangible items that enable security and/or privacy.\n"
45 + "\n"
46 + "The `type` indicates which of these component types is represented.\n"
47 + "\n"
48 + "A group of components may be aggregated into a `capability`. For example, an account management capability that consists of an account management process, and a Lightweight Directory Access Protocol (LDAP) software implementation.\n"
49 + "\n"
50 + "Capabilities are expressed by combining one or more components."
51 )
52 @ValueConstraints(
53 allowedValues = {
54 @AllowedValues(level = IConstraint.Level.ERROR, target = "prop[has-oscal-namespace('http://csrc.nist.gov/ns/oscal')]/@name", values = {@AllowedValue(value = "version", description = "The version of the component."), @AllowedValue(value = "patch-level", description = "The specific patch level of the component."), @AllowedValue(value = "model", description = "The model of the component."), @AllowedValue(value = "release-date", description = "The date the component was released, such as a software release date or policy publication date."), @AllowedValue(value = "validation-type", description = "Used with component-type='validation' to provide a well-known name for a kind of validation."), @AllowedValue(value = "validation-reference", description = "Used with component-type='validation' to indicate the validating body's assigned identifier for their validation of this component."), @AllowedValue(value = "asset-type", description = "Simple indication of the asset's function, such as Router, Storage Array, DNS Server."), @AllowedValue(value = "asset-id", description = "An organizationally specific identifier that is used to uniquely identify a logical or tangible item by the organization that owns the item."), @AllowedValue(value = "asset-tag", description = "An asset tag assigned by the organization responsible for maintaining the logical or tangible item."), @AllowedValue(value = "public", description = "Identifies whether the asset is publicly accessible (yes/no)"), @AllowedValue(value = "virtual", description = "Identifies whether the asset is virtualized (yes/no)"), @AllowedValue(value = "vlan-id", description = "Virtual LAN identifier of the asset."), @AllowedValue(value = "network-id", description = "The network identifier of the asset."), @AllowedValue(value = "label", description = "A human-readable label for the parent context."), @AllowedValue(value = "sort-id", description = "An alternative identifier, whose value is easily sortable among other such values in the document."), @AllowedValue(value = "baseline-configuration-name", description = "The name of the baseline configuration for the asset."), @AllowedValue(value = "allows-authenticated-scan", description = "Can the asset be check with an authenticated scan? (yes/no)"), @AllowedValue(value = "function", description = "The function provided by the asset for the system.")}),
55 @AllowedValues(level = IConstraint.Level.ERROR, target = "link/@rel", allowOthers = true, values = {@AllowedValue(value = "depends-on", description = "A reference to another component that this component has a dependency on."), @AllowedValue(value = "validation", description = "A reference to another component of component-type=validation, that is a validation (e.g., FIPS 140-2) for this component"), @AllowedValue(value = "proof-of-compliance", description = "A pointer to a validation record (e.g., FIPS 140-2) or other compliance information."), @AllowedValue(value = "baseline-template", description = "A reference to the baseline template used to configure the asset."), @AllowedValue(value = "uses-service", description = "This service is used by the referenced component identifier."), @AllowedValue(value = "system-security-plan", description = "A link to the system security plan of the external system."), @AllowedValue(value = "uses-network", description = "This component uses the network provided by the identified network component.")}),
56 @AllowedValues(level = IConstraint.Level.ERROR, target = "responsible-role/@role-id|control-implementation/implemented-requirement/responsible-role/@role-id|control-implementation/implemented-requirement/statement/responsible-role/@role-id", allowOthers = true, values = {@AllowedValue(value = "asset-owner", description = "Accountable for ensuring the asset is managed in accordance with organizational policies and procedures."), @AllowedValue(value = "asset-administrator", description = "Responsible for administering a set of assets."), @AllowedValue(value = "security-operations", description = "Members of the security operations center (SOC)."), @AllowedValue(value = "network-operations", description = "Members of the network operations center (NOC)."), @AllowedValue(value = "incident-response", description = "Responsible for responding to an event that could lead to loss of, or disruption to, an organization's operations, services or functions."), @AllowedValue(value = "help-desk", description = "Responsible for providing information and support to users."), @AllowedValue(value = "configuration-management", description = "Responsible for the configuration management processes governing changes to the asset."), @AllowedValue(value = "maintainer", description = "Responsible for the creation and maintenance of a component."), @AllowedValue(value = "provider", description = "Organization responsible for providing the component, if this is different from the \"maintainer\" (e.g., a reseller).")}),
57 @AllowedValues(level = IConstraint.Level.ERROR, target = "prop[has-oscal-namespace('http://csrc.nist.gov/ns/oscal') and @name='asset-type']/@value", allowOthers = true, values = {@AllowedValue(value = "operating-system", description = "System software that manages computer hardware, software resources, and provides common services for computer programs."), @AllowedValue(value = "database", description = "An electronic collection of data, or information, that is specially organized for rapid search and retrieval."), @AllowedValue(value = "web-server", description = "A system that delivers content or services to end users over the Internet or an intranet."), @AllowedValue(value = "dns-server", description = "A system that resolves domain names to internet protocol (IP) addresses."), @AllowedValue(value = "email-server", description = "A computer system that sends and receives electronic mail messages."), @AllowedValue(value = "directory-server", description = "A system that stores, organizes and provides access to directory information in order to unify network resources."), @AllowedValue(value = "pbx", description = "A private branch exchange (PBX) provides a a private telephone switchboard."), @AllowedValue(value = "firewall", description = "A network security system that monitors and controls incoming and outgoing network traffic based on predetermined security rules."), @AllowedValue(value = "router", description = "A physical or virtual networking device that forwards data packets between computer networks."), @AllowedValue(value = "switch", description = "A physical or virtual networking device that connects devices within a computer network by using packet switching to receive and forward data to the destination device."), @AllowedValue(value = "storage-array", description = "A consolidated, block-level data storage capability."), @AllowedValue(value = "appliance", description = "A physical or virtual machine that centralizes hardware, software, or services for a specific purpose.")}),
58 @AllowedValues(level = IConstraint.Level.ERROR, target = "prop[has-oscal-namespace('http://csrc.nist.gov/ns/oscal') and @name='allows-authenticated-scan']/@value", values = {@AllowedValue(value = "yes", description = "The component allows an authenticated scan."), @AllowedValue(value = "no", description = "The component does not allow an authenticated scan.")}),
59 @AllowedValues(level = IConstraint.Level.ERROR, target = "prop[has-oscal-namespace('http://csrc.nist.gov/ns/oscal') and @name='virtual']/@value", values = {@AllowedValue(value = "yes", description = "The component is virtualized."), @AllowedValue(value = "no", description = "The component is not virtualized.")}),
60 @AllowedValues(level = IConstraint.Level.ERROR, target = "prop[has-oscal-namespace('http://csrc.nist.gov/ns/oscal') and @name='public']/@value", values = {@AllowedValue(value = "yes", description = "The component is publicly accessible."), @AllowedValue(value = "no", description = "The component is not publicly accessible.")}),
61 @AllowedValues(level = IConstraint.Level.ERROR, target = "prop[has-oscal-namespace('http://csrc.nist.gov/ns/oscal') and @name='implementation-point']/@value", values = {@AllowedValue(value = "internal", description = "The component is implemented within the system boundary."), @AllowedValue(value = "external", description = "The component is implemented outside the system boundary.")}),
62 @AllowedValues(level = IConstraint.Level.ERROR, target = "(.)[@type='software']/prop[has-oscal-namespace('http://csrc.nist.gov/ns/oscal')]/@name", values = @AllowedValue(value = "software-identifier", description = "If a \"software\" component-type, the identifier, such as a SWID tag, for the software component.")),
63 @AllowedValues(level = IConstraint.Level.ERROR, target = "(.)[@type='service']/link/@rel", allowOthers = true, values = {@AllowedValue(value = "provided-by", description = "This service is provided by the referenced component identifier."), @AllowedValue(value = "used-by", description = "This service is used by the referenced component identifier.")})
64 },
65 indexHasKey = @IndexHasKey(level = IConstraint.Level.ERROR, target = "prop[@name='physical-location']", indexName = "index-metadata-location-uuid", keyFields = @KeyField(target = "@value")),
66 matches = {
67 @Matches(level = IConstraint.Level.ERROR, target = "prop[has-oscal-namespace('http://csrc.nist.gov/ns/oscal') and @name='inherited-uuid']/@value", typeAdapter = UuidAdapter.class),
68 @Matches(level = IConstraint.Level.ERROR, target = "prop[has-oscal-namespace('http://csrc.nist.gov/ns/oscal') and @name='release-date']/@value", typeAdapter = DateAdapter.class)
69 },
70 expect = @Expect(level = IConstraint.Level.ERROR, test = "not(exists((.)[not(@type='service')]/protocol))")
71 )
72 @AssemblyConstraints(
73 isUnique = @IsUnique(id = "unique-defined-component-responsible-role", level = IConstraint.Level.ERROR, target = "responsible-role", keyFields = @KeyField(target = "@role-id"), remarks = "Since `responsible-role` associates multiple `party-uuid` entries with a single `role-id`, each role-id must be referenced only once.")
74 )
75 public class DefinedComponent {
76 @BoundFlag(
77 formalName = "Component Identifier",
78 description = "Provides a globally unique means to identify a given component.",
79 useName = "uuid",
80 required = true,
81 typeAdapter = UuidAdapter.class
82 )
83 private UUID _uuid;
84
85 @BoundFlag(
86 formalName = "Component Type",
87 description = "A category describing the purpose of the component.",
88 useName = "type",
89 required = true,
90 typeAdapter = StringAdapter.class
91 )
92 @ValueConstraints(
93 allowedValues = @AllowedValues(level = IConstraint.Level.ERROR, allowOthers = true, values = {@AllowedValue(value = "interconnection", description = "A connection to something outside this system."), @AllowedValue(value = "software", description = "Any software, operating system, or firmware."), @AllowedValue(value = "hardware", description = "A physical device."), @AllowedValue(value = "service", description = "A service that may provide APIs."), @AllowedValue(value = "policy", description = "An enforceable policy."), @AllowedValue(value = "physical", description = "A tangible asset used to provide physical protections or countermeasures."), @AllowedValue(value = "process-procedure", description = "A list of steps or actions to take to achieve some end result."), @AllowedValue(value = "plan", description = "An applicable plan."), @AllowedValue(value = "guidance", description = "Any guideline or recommendation."), @AllowedValue(value = "standard", description = "Any organizational or industry standard."), @AllowedValue(value = "validation", description = "An external assessment performed on some other component, that has been validated by a third-party.")})
94 )
95 private String _type;
96
97
98
99
100 @BoundField(
101 formalName = "Component Title",
102 description = "A human readable name for the component.",
103 useName = "title",
104 minOccurs = 1
105 )
106 @BoundFieldValue(
107 typeAdapter = MarkupLineAdapter.class
108 )
109 private MarkupLine _title;
110
111
112
113
114 @BoundField(
115 formalName = "Component Description",
116 description = "A description of the component, including information about its function.",
117 useName = "description",
118 minOccurs = 1
119 )
120 @BoundFieldValue(
121 typeAdapter = MarkupMultilineAdapter.class
122 )
123 private MarkupMultiline _description;
124
125
126
127
128 @BoundField(
129 formalName = "Purpose",
130 description = "A summary of the technological or business purpose of the component.",
131 useName = "purpose"
132 )
133 @BoundFieldValue(
134 typeAdapter = MarkupLineAdapter.class
135 )
136 private MarkupLine _purpose;
137
138 @BoundAssembly(
139 formalName = "Property",
140 description = "An attribute, characteristic, or quality of the containing object expressed as a namespace qualified name/value pair.",
141 useName = "prop",
142 maxOccurs = -1
143 )
144 @GroupAs(
145 name = "props",
146 inJson = JsonGroupAsBehavior.LIST
147 )
148 private List<Property> _props;
149
150 @BoundAssembly(
151 formalName = "Link",
152 description = "A reference to a local or remote resource, that has a specific relation to the containing object.",
153 useName = "link",
154 maxOccurs = -1
155 )
156 @GroupAs(
157 name = "links",
158 inJson = JsonGroupAsBehavior.LIST
159 )
160 private List<Link> _links;
161
162 @BoundAssembly(
163 formalName = "Responsible Role",
164 description = "A reference to a role with responsibility for performing a function relative to the containing object, optionally associated with a set of persons and/or organizations that perform that role.",
165 useName = "responsible-role",
166 maxOccurs = -1
167 )
168 @GroupAs(
169 name = "responsible-roles",
170 inJson = JsonGroupAsBehavior.LIST
171 )
172 private List<ResponsibleRole> _responsibleRoles;
173
174 @BoundAssembly(
175 formalName = "Service Protocol Information",
176 description = "Information about the protocol used to provide a service.",
177 useName = "protocol",
178 maxOccurs = -1,
179 remarks = "Used for `service` components to define the protocols supported by the service."
180 )
181 @GroupAs(
182 name = "protocols",
183 inJson = JsonGroupAsBehavior.LIST
184 )
185 private List<Protocol> _protocols;
186
187 @BoundAssembly(
188 formalName = "Control Implementation Set",
189 description = "Defines how the component or capability supports a set of controls.",
190 useName = "control-implementation",
191 maxOccurs = -1
192 )
193 @GroupAs(
194 name = "control-implementations",
195 inJson = JsonGroupAsBehavior.LIST
196 )
197 private List<ComponentControlImplementation> _controlImplementations;
198
199 @BoundField(
200 formalName = "Remarks",
201 description = "Additional commentary about the containing object.",
202 useName = "remarks"
203 )
204 @BoundFieldValue(
205 typeAdapter = MarkupMultilineAdapter.class
206 )
207 private MarkupMultiline _remarks;
208
209 public DefinedComponent() {
210 }
211
212 public UUID getUuid() {
213 return _uuid;
214 }
215
216 public void setUuid(UUID value) {
217 _uuid = value;
218 }
219
220 public String getType() {
221 return _type;
222 }
223
224 public void setType(String value) {
225 _type = value;
226 }
227
228 public MarkupLine getTitle() {
229 return _title;
230 }
231
232 public void setTitle(MarkupLine value) {
233 _title = value;
234 }
235
236 public MarkupMultiline getDescription() {
237 return _description;
238 }
239
240 public void setDescription(MarkupMultiline value) {
241 _description = value;
242 }
243
244 public MarkupLine getPurpose() {
245 return _purpose;
246 }
247
248 public void setPurpose(MarkupLine value) {
249 _purpose = value;
250 }
251
252 public List<Property> getProps() {
253 return _props;
254 }
255
256 public void setProps(List<Property> value) {
257 _props = value;
258 }
259
260
261
262
263
264
265 public boolean addProp(Property item) {
266 Property value = ObjectUtils.requireNonNull(item,"item cannot be null");
267 if (_props == null) {
268 _props = new LinkedList<>();
269 }
270 return _props.add(value);
271 }
272
273
274
275
276
277
278 public boolean removeProp(Property item) {
279 Property value = ObjectUtils.requireNonNull(item,"item cannot be null");
280 return _props == null ? false : _props.remove(value);
281 }
282
283 public List<Link> getLinks() {
284 return _links;
285 }
286
287 public void setLinks(List<Link> value) {
288 _links = value;
289 }
290
291
292
293
294
295
296 public boolean addLink(Link item) {
297 Link value = ObjectUtils.requireNonNull(item,"item cannot be null");
298 if (_links == null) {
299 _links = new LinkedList<>();
300 }
301 return _links.add(value);
302 }
303
304
305
306
307
308
309 public boolean removeLink(Link item) {
310 Link value = ObjectUtils.requireNonNull(item,"item cannot be null");
311 return _links == null ? false : _links.remove(value);
312 }
313
314 public List<ResponsibleRole> getResponsibleRoles() {
315 return _responsibleRoles;
316 }
317
318 public void setResponsibleRoles(List<ResponsibleRole> value) {
319 _responsibleRoles = value;
320 }
321
322
323
324
325
326
327 public boolean addResponsibleRole(ResponsibleRole item) {
328 ResponsibleRole value = ObjectUtils.requireNonNull(item,"item cannot be null");
329 if (_responsibleRoles == null) {
330 _responsibleRoles = new LinkedList<>();
331 }
332 return _responsibleRoles.add(value);
333 }
334
335
336
337
338
339
340 public boolean removeResponsibleRole(ResponsibleRole item) {
341 ResponsibleRole value = ObjectUtils.requireNonNull(item,"item cannot be null");
342 return _responsibleRoles == null ? false : _responsibleRoles.remove(value);
343 }
344
345 public List<Protocol> getProtocols() {
346 return _protocols;
347 }
348
349 public void setProtocols(List<Protocol> value) {
350 _protocols = value;
351 }
352
353
354
355
356
357
358 public boolean addProtocol(Protocol item) {
359 Protocol value = ObjectUtils.requireNonNull(item,"item cannot be null");
360 if (_protocols == null) {
361 _protocols = new LinkedList<>();
362 }
363 return _protocols.add(value);
364 }
365
366
367
368
369
370
371 public boolean removeProtocol(Protocol item) {
372 Protocol value = ObjectUtils.requireNonNull(item,"item cannot be null");
373 return _protocols == null ? false : _protocols.remove(value);
374 }
375
376 public List<ComponentControlImplementation> getControlImplementations() {
377 return _controlImplementations;
378 }
379
380 public void setControlImplementations(List<ComponentControlImplementation> value) {
381 _controlImplementations = value;
382 }
383
384
385
386
387
388
389 public boolean addControlImplementation(ComponentControlImplementation item) {
390 ComponentControlImplementation value = ObjectUtils.requireNonNull(item,"item cannot be null");
391 if (_controlImplementations == null) {
392 _controlImplementations = new LinkedList<>();
393 }
394 return _controlImplementations.add(value);
395 }
396
397
398
399
400
401
402 public boolean removeControlImplementation(ComponentControlImplementation item) {
403 ComponentControlImplementation value = ObjectUtils.requireNonNull(item,"item cannot be null");
404 return _controlImplementations == null ? false : _controlImplementations.remove(value);
405 }
406
407 public MarkupMultiline getRemarks() {
408 return _remarks;
409 }
410
411 public void setRemarks(MarkupMultiline value) {
412 _remarks = value;
413 }
414
415 @Override
416 public String toString() {
417 return new ReflectionToStringBuilder(this, MultilineRecursiveToStringStyle.MULTI_LINE_STYLE).toString();
418 }
419 }