1
|
|
|
import collections |
2
|
|
|
import os |
3
|
|
|
import copy |
4
|
|
|
from glob import glob |
5
|
|
|
|
6
|
|
|
import ssg.entities.common |
7
|
|
|
import ssg.yaml |
8
|
|
|
import ssg.utils |
9
|
|
|
|
10
|
|
|
|
11
|
|
|
class InvalidStatus(Exception): |
12
|
|
|
pass |
13
|
|
|
|
14
|
|
|
|
15
|
|
|
class Status: |
16
|
|
|
SUPPORTED = "supported" |
17
|
|
|
PLANNED = "planned" |
18
|
|
|
PENDING = "pending" |
19
|
|
|
PARTIAL = "partial" |
20
|
|
|
NOT_APPLICABLE = "not applicable" |
21
|
|
|
MANUAL = "manual" |
22
|
|
|
INHERENTLY_MET = "inherently met" |
23
|
|
|
DOES_NOT_MEET = "does not meet" |
24
|
|
|
DOCUMENTATION = "documentation" |
25
|
|
|
AUTOMATED = "automated" |
26
|
|
|
|
27
|
|
|
def __init__(self, status): |
28
|
|
|
self.status = status |
29
|
|
|
|
30
|
|
|
@classmethod |
31
|
|
|
def get_status_list(cls): |
32
|
|
|
valid_statuses = [ |
33
|
|
|
cls.AUTOMATED, |
34
|
|
|
cls.DOCUMENTATION, |
35
|
|
|
cls.DOES_NOT_MEET, |
36
|
|
|
cls.INHERENTLY_MET, |
37
|
|
|
cls.MANUAL, |
38
|
|
|
cls.NOT_APPLICABLE, |
39
|
|
|
cls.PARTIAL, |
40
|
|
|
cls.PENDING, |
41
|
|
|
cls.PLANNED, |
42
|
|
|
cls.SUPPORTED, |
43
|
|
|
] |
44
|
|
|
return valid_statuses |
45
|
|
|
|
46
|
|
|
@classmethod |
47
|
|
|
def from_control_info(cls, ctrl, status): |
48
|
|
|
if status is None: |
49
|
|
|
return cls.PENDING |
50
|
|
|
|
51
|
|
|
valid_statuses = cls.get_status_list() |
52
|
|
|
|
53
|
|
|
if status not in valid_statuses: |
54
|
|
|
raise InvalidStatus( |
55
|
|
|
"The given status '{given}' in the control '{control}' " |
56
|
|
|
"was invalid. Please use one of " |
57
|
|
|
"the following: {valid}".format(given=status, |
58
|
|
|
control=ctrl, |
59
|
|
|
valid=valid_statuses)) |
60
|
|
|
return status |
61
|
|
|
|
62
|
|
|
def __str__(self): |
63
|
|
|
return self.status |
64
|
|
|
|
65
|
|
|
def __eq__(self, other): |
66
|
|
|
if isinstance(other, Status): |
67
|
|
|
return self.status == other.status |
68
|
|
|
elif isinstance(other, str): |
69
|
|
|
return self.status == other |
70
|
|
|
return False |
71
|
|
|
|
72
|
|
|
|
73
|
|
|
class Control(ssg.entities.common.SelectionHandler, ssg.entities.common.XCCDFEntity): |
74
|
|
|
KEYS = dict( |
75
|
|
|
id=str, |
76
|
|
|
levels=list, |
77
|
|
|
notes=str, |
78
|
|
|
title=str, |
79
|
|
|
description=str, |
80
|
|
|
rationale=str, |
81
|
|
|
automated=str, |
82
|
|
|
status=None, |
83
|
|
|
mitigation=str, |
84
|
|
|
artifact_description=str, |
85
|
|
|
status_justification=str, |
86
|
|
|
fixtext=str, |
87
|
|
|
check=str, |
88
|
|
|
tickets=list, |
89
|
|
|
original_title=str, |
90
|
|
|
related_rules=list, |
91
|
|
|
rules=list, |
92
|
|
|
controls=list, |
93
|
|
|
) |
94
|
|
|
|
95
|
|
|
MANDATORY_KEYS = { |
96
|
|
|
"title", |
97
|
|
|
} |
98
|
|
|
|
99
|
|
|
def __init__(self): |
100
|
|
|
super(Control, self).__init__() |
101
|
|
|
self.id = None |
102
|
|
|
self.levels = [] |
103
|
|
|
self.notes = "" |
104
|
|
|
self.title = "" |
105
|
|
|
self.description = "" |
106
|
|
|
self.rationale = "" |
107
|
|
|
self.automated = "" |
108
|
|
|
self.status = None |
109
|
|
|
self.mitigation = "" |
110
|
|
|
self.artifact_description = "" |
111
|
|
|
self.status_justification = "" |
112
|
|
|
self.fixtext = "" |
113
|
|
|
self.check = "" |
114
|
|
|
self.controls = [] |
115
|
|
|
self.tickets = [] |
116
|
|
|
self.original_title = "" |
117
|
|
|
self.related_rules = [] |
118
|
|
|
self.rules = [] |
119
|
|
|
|
120
|
|
|
def __hash__(self): |
121
|
|
|
""" Controls are meant to be unique, so using the |
122
|
|
|
ID should suffice""" |
123
|
|
|
return hash(self.id) |
124
|
|
|
|
125
|
|
|
@classmethod |
126
|
|
|
def _check_keys(cls, control_dict): |
127
|
|
|
for key in control_dict.keys(): |
128
|
|
|
# Rules shouldn't be in KEYS that data is in selections |
129
|
|
|
if key not in cls.KEYS.keys() and key not in ['rules', ]: |
130
|
|
|
raise ValueError("Key %s is not allowed in a control file." % key) |
131
|
|
|
|
132
|
|
|
@classmethod |
133
|
|
|
def from_control_dict(cls, control_dict, env_yaml=None, default_level=["default"]): |
134
|
|
|
cls._check_keys(control_dict) |
135
|
|
|
control = cls() |
136
|
|
|
control.id = ssg.utils.required_key(control_dict, "id") |
137
|
|
|
control.title = control_dict.get("title") |
138
|
|
|
control.description = control_dict.get("description") |
139
|
|
|
control.rationale = control_dict.get("rationale") |
140
|
|
|
control.status = Status.from_control_info(control.id, control_dict.get("status", None)) |
141
|
|
|
control.automated = control_dict.get("automated", "no") |
142
|
|
|
control.status_justification = control_dict.get('status_justification') |
143
|
|
|
control.artifact_description = control_dict.get('artifact_description') |
144
|
|
|
control.mitigation = control_dict.get('mitigation') |
145
|
|
|
control.fixtext = control_dict.get('fixtext') |
146
|
|
|
control.check = control_dict.get('check') |
147
|
|
|
control.tickets = control_dict.get('tickets') |
148
|
|
|
control.original_title = control_dict.get('original_title') |
149
|
|
|
control.related_rules = control_dict.get('related_rules') |
150
|
|
|
control.rules = control_dict.get('rules') |
151
|
|
|
|
152
|
|
|
if control.status == "automated": |
153
|
|
|
control.automated = "yes" |
154
|
|
|
if control.automated not in ["yes", "no", "partially"]: |
155
|
|
|
msg = ( |
156
|
|
|
"Invalid value '%s' of automated key in control " |
157
|
|
|
"%s '%s'. Can be only 'yes', 'no', 'partially'." |
158
|
|
|
% (control.automated, control.id, control.title)) |
159
|
|
|
raise ValueError(msg) |
160
|
|
|
control.levels = control_dict.get("levels", default_level) |
161
|
|
|
control.notes = control_dict.get("notes", "") |
162
|
|
|
selections = control_dict.get("rules", {}) |
163
|
|
|
|
164
|
|
|
control.selections = selections |
165
|
|
|
|
166
|
|
|
control.related_rules = control_dict.get("related_rules", []) |
167
|
|
|
control.rules = control_dict.get("rules", []) |
168
|
|
|
return control |
169
|
|
|
|
170
|
|
|
def represent_as_dict(self): |
171
|
|
|
data = super(Control, self).represent_as_dict() |
172
|
|
|
data["rules"] = self.selections |
173
|
|
|
data["controls"] = self.controls |
174
|
|
|
return data |
175
|
|
|
|
176
|
|
|
|
177
|
|
|
class Level(ssg.entities.common.XCCDFEntity): |
178
|
|
|
KEYS = dict( |
179
|
|
|
id=lambda: str, |
180
|
|
|
inherits_from=lambda: None, |
181
|
|
|
) |
182
|
|
|
|
183
|
|
|
def __init__(self): |
184
|
|
|
self.id = None |
185
|
|
|
self.inherits_from = None |
186
|
|
|
|
187
|
|
|
@classmethod |
188
|
|
|
def from_level_dict(cls, level_dict): |
189
|
|
|
level = cls() |
190
|
|
|
level.id = ssg.utils.required_key(level_dict, "id") |
191
|
|
|
level.inherits_from = level_dict.get("inherits_from") |
192
|
|
|
return level |
193
|
|
|
|
194
|
|
|
|
195
|
|
|
class Policy(ssg.entities.common.XCCDFEntity): |
196
|
|
|
def __init__(self, filepath, env_yaml=None): |
197
|
|
|
self.id = None |
198
|
|
|
self.env_yaml = env_yaml |
199
|
|
|
self.filepath = filepath |
200
|
|
|
self.controls_dir = os.path.splitext(filepath)[0] |
201
|
|
|
self.controls = [] |
202
|
|
|
self.controls_by_id = dict() |
203
|
|
|
self.levels = [] |
204
|
|
|
self.levels_by_id = dict() |
205
|
|
|
self.title = "" |
206
|
|
|
self.source = "" |
207
|
|
|
|
208
|
|
|
def represent_as_dict(self): |
209
|
|
|
data = dict() |
210
|
|
|
data["id"] = self.id |
211
|
|
|
data["title"] = self.title |
212
|
|
|
data["source"] = self.source |
213
|
|
|
data["definition_location"] = self.filepath |
214
|
|
|
data["controls"] = [c.represent_as_dict() for c in self.controls] |
215
|
|
|
data["levels"] = [l.represent_as_dict() for l in self.levels] |
216
|
|
|
return data |
217
|
|
|
|
218
|
|
|
@property |
219
|
|
|
def default_level(self): |
220
|
|
|
result = ["default"] |
221
|
|
|
if self.levels: |
222
|
|
|
result = [self.levels[0].id] |
223
|
|
|
return result |
224
|
|
|
|
225
|
|
|
def check_all_rules_exist(self, existing_rules): |
226
|
|
|
for c in self.controls: |
227
|
|
|
nonexisting_rules = set(c.selected) - existing_rules |
228
|
|
|
if nonexisting_rules: |
229
|
|
|
msg = "Control %s:%s contains nonexisting rule(s) %s" % ( |
230
|
|
|
self.id, c.id, ", ".join(nonexisting_rules)) |
231
|
|
|
raise ValueError(msg) |
232
|
|
|
|
233
|
|
|
def remove_selections_not_known(self, known_rules): |
234
|
|
|
for c in self.controls: |
235
|
|
|
selections = set(c.selected).intersection(known_rules) |
236
|
|
|
c.selected = list(selections) |
237
|
|
|
unselections = set(c.unselected).intersection(known_rules) |
238
|
|
|
c.unselected = list(unselections) |
239
|
|
|
|
240
|
|
|
def _create_control_from_subtree(self, subtree): |
241
|
|
|
try: |
242
|
|
|
control = Control.from_control_dict( |
243
|
|
|
subtree, self.env_yaml, default_level=self.default_level) |
244
|
|
|
except Exception as exc: |
245
|
|
|
msg = ( |
246
|
|
|
"Unable to parse controls from {filename}: {error}" |
247
|
|
|
.format(filename=self.filepath, error=str(exc))) |
248
|
|
|
raise RuntimeError(msg) |
249
|
|
|
return control |
250
|
|
|
|
251
|
|
|
def _extract_and_record_subcontrols(self, current_control, controls_tree): |
252
|
|
|
subcontrols = [] |
253
|
|
|
if "controls" not in controls_tree: |
254
|
|
|
return subcontrols |
255
|
|
|
|
256
|
|
|
for control_def_or_ref in controls_tree["controls"]: |
257
|
|
|
if isinstance(control_def_or_ref, str): |
258
|
|
|
control_ref = control_def_or_ref |
259
|
|
|
current_control.controls.append(control_ref) |
260
|
|
|
continue |
261
|
|
|
control_def = control_def_or_ref |
262
|
|
|
for sc in self._parse_controls_tree([control_def]): |
263
|
|
|
current_control.controls.append(sc.id) |
264
|
|
|
current_control.update_with(sc) |
265
|
|
|
subcontrols.append(sc) |
266
|
|
|
return subcontrols |
267
|
|
|
|
268
|
|
|
def _parse_controls_tree(self, tree): |
269
|
|
|
controls = [] |
270
|
|
|
|
271
|
|
|
for control_subtree in tree: |
272
|
|
|
control = self._create_control_from_subtree(control_subtree) |
273
|
|
|
subcontrols = self._extract_and_record_subcontrols(control, control_subtree) |
274
|
|
|
controls.extend(subcontrols) |
275
|
|
|
controls.append(control) |
276
|
|
|
return controls |
277
|
|
|
|
278
|
|
|
def save_controls_tree(self, tree): |
279
|
|
|
for c in self._parse_controls_tree(tree): |
280
|
|
|
self.controls.append(c) |
281
|
|
|
self.controls_by_id[c.id] = c |
282
|
|
|
|
283
|
|
|
def _parse_file_into_control_trees(self, dirname, basename): |
284
|
|
|
controls_trees = [] |
285
|
|
|
if basename.endswith('.yml'): |
286
|
|
|
full_path = os.path.join(dirname, basename) |
287
|
|
|
yaml_contents = ssg.yaml.open_and_expand(full_path, self.env_yaml) |
288
|
|
|
for control in yaml_contents['controls']: |
289
|
|
|
controls_trees.append(control) |
290
|
|
|
elif basename.startswith('.'): |
291
|
|
|
pass |
292
|
|
|
else: |
293
|
|
|
raise RuntimeError("Found non yaml file in %s" % self.controls_dir) |
294
|
|
|
return controls_trees |
295
|
|
|
|
296
|
|
|
def _load_from_subdirectory(self, yaml_contents): |
297
|
|
|
controls_tree = yaml_contents.get("controls", list()) |
298
|
|
|
files = os.listdir(self.controls_dir) |
299
|
|
|
for file in files: |
300
|
|
|
trees = self._parse_file_into_control_trees(self.controls_dir, file) |
301
|
|
|
controls_tree.extend(trees) |
302
|
|
|
return controls_tree |
303
|
|
|
|
304
|
|
|
def load(self): |
305
|
|
|
yaml_contents = ssg.yaml.open_and_expand(self.filepath, self.env_yaml) |
306
|
|
|
controls_dir = yaml_contents.get("controls_dir") |
307
|
|
|
if controls_dir: |
308
|
|
|
self.controls_dir = os.path.join(os.path.dirname(self.filepath), controls_dir) |
309
|
|
|
self.id = ssg.utils.required_key(yaml_contents, "id") |
310
|
|
|
self.title = ssg.utils.required_key(yaml_contents, "title") |
311
|
|
|
self.source = yaml_contents.get("source", "") |
312
|
|
|
|
313
|
|
|
level_list = yaml_contents.get("levels", []) |
314
|
|
|
for lv in level_list: |
315
|
|
|
level = Level.from_level_dict(lv) |
316
|
|
|
self.levels.append(level) |
317
|
|
|
self.levels_by_id[level.id] = level |
318
|
|
|
|
319
|
|
|
if os.path.exists(self.controls_dir) and os.path.isdir(self.controls_dir): |
320
|
|
|
controls_tree = self._load_from_subdirectory(yaml_contents) |
321
|
|
|
else: |
322
|
|
|
controls_tree = ssg.utils.required_key(yaml_contents, "controls") |
323
|
|
|
self.save_controls_tree(controls_tree) |
324
|
|
|
|
325
|
|
|
def get_control(self, control_id): |
326
|
|
|
try: |
327
|
|
|
c = self.controls_by_id[control_id] |
328
|
|
|
return c |
329
|
|
|
except KeyError: |
330
|
|
|
msg = "%s not found in policy %s" % ( |
331
|
|
|
control_id, self.id |
332
|
|
|
) |
333
|
|
|
raise ValueError(msg) |
334
|
|
|
|
335
|
|
|
def get_level(self, level_id): |
336
|
|
|
try: |
337
|
|
|
lv = self.levels_by_id[level_id] |
338
|
|
|
return lv |
339
|
|
|
except KeyError: |
340
|
|
|
msg = "Level %s not found in policy %s" % ( |
341
|
|
|
level_id, self.id |
342
|
|
|
) |
343
|
|
|
raise ValueError(msg) |
344
|
|
|
|
345
|
|
|
def get_level_with_ancestors_sequence(self, level_id): |
346
|
|
|
# use OrderedDict for Python2 compatibility instead of ordered set |
347
|
|
|
levels = collections.OrderedDict() |
348
|
|
|
level = self.get_level(level_id) |
349
|
|
|
levels[level] = "" |
350
|
|
|
if level.inherits_from: |
351
|
|
|
for lv in level.inherits_from: |
352
|
|
|
eligible_levels = [l for l in self.get_level_with_ancestors_sequence(lv) if l not in levels.keys()] |
353
|
|
|
for l in eligible_levels: |
354
|
|
|
levels[l] = "" |
355
|
|
|
return list(levels.keys()) |
356
|
|
|
|
357
|
|
|
|
358
|
|
|
class ControlsManager(): |
359
|
|
|
def __init__(self, controls_dir, env_yaml=None, existing_rules=None): |
360
|
|
|
self.controls_dir = os.path.abspath(controls_dir) |
361
|
|
|
self.env_yaml = env_yaml |
362
|
|
|
self.existing_rules = existing_rules |
363
|
|
|
self.policies = {} |
364
|
|
|
|
365
|
|
|
def load(self): |
366
|
|
|
if not os.path.exists(self.controls_dir): |
367
|
|
|
return |
368
|
|
|
for filename in sorted(glob(os.path.join(self.controls_dir, "*.yml"))): |
369
|
|
|
filepath = os.path.join(self.controls_dir, filename) |
370
|
|
|
policy = Policy(filepath, self.env_yaml) |
371
|
|
|
policy.load() |
372
|
|
|
self.policies[policy.id] = policy |
373
|
|
|
self.check_all_rules_exist() |
374
|
|
|
self.resolve_controls() |
375
|
|
|
|
376
|
|
|
def check_all_rules_exist(self): |
377
|
|
|
if self.existing_rules is None: |
378
|
|
|
return |
379
|
|
|
for p in self.policies.values(): |
380
|
|
|
p.check_all_rules_exist(self.existing_rules) |
381
|
|
|
|
382
|
|
|
def remove_selections_not_known(self, known_rules): |
383
|
|
|
known_rules = set(known_rules) |
384
|
|
|
for p in self.policies.values(): |
385
|
|
|
p.remove_selections_not_known(known_rules) |
386
|
|
|
|
387
|
|
|
def resolve_controls(self): |
388
|
|
|
for pid, policy in self.policies.items(): |
389
|
|
|
for control in policy.controls: |
390
|
|
|
self._resolve_control(pid, control) |
391
|
|
|
|
392
|
|
|
def _resolve_control(self, pid, control): |
393
|
|
|
for sub_name in control.controls: |
394
|
|
|
policy_id = pid |
395
|
|
|
if ":" in sub_name: |
396
|
|
|
policy_id, sub_name = sub_name.split(":", 1) |
397
|
|
|
subcontrol = self.get_control(policy_id, sub_name) |
398
|
|
|
self._resolve_control(pid, subcontrol) |
399
|
|
|
control.update_with(subcontrol) |
400
|
|
|
|
401
|
|
|
def get_control(self, policy_id, control_id): |
402
|
|
|
policy = self._get_policy(policy_id) |
403
|
|
|
control = policy.get_control(control_id) |
404
|
|
|
return control |
405
|
|
|
|
406
|
|
|
def _get_policy(self, policy_id): |
407
|
|
|
try: |
408
|
|
|
policy = self.policies[policy_id] |
409
|
|
|
except KeyError: |
410
|
|
|
msg = "policy '%s' doesn't exist" % (policy_id) |
411
|
|
|
raise ValueError(msg) |
412
|
|
|
return policy |
413
|
|
|
|
414
|
|
|
def get_all_controls_of_level(self, policy_id, level_id): |
415
|
|
|
policy = self._get_policy(policy_id) |
416
|
|
|
levels = policy.get_level_with_ancestors_sequence(level_id) |
417
|
|
|
all_policy_controls = self.get_all_controls(policy_id) |
418
|
|
|
eligible_controls = [] |
419
|
|
|
already_defined_variables = set() |
420
|
|
|
# we will go level by level, from top to bottom |
421
|
|
|
# this is done to enable overriding of variables by higher levels |
422
|
|
|
for lv in levels: |
423
|
|
|
for control in all_policy_controls: |
424
|
|
|
if lv.id not in control.levels: |
425
|
|
|
continue |
426
|
|
|
|
427
|
|
|
variables = set(control.variables.keys()) |
428
|
|
|
|
429
|
|
|
variables_to_remove = variables.intersection(already_defined_variables) |
430
|
|
|
already_defined_variables.update(variables) |
431
|
|
|
|
432
|
|
|
new_c = self._get_control_without_variables(variables_to_remove, control) |
433
|
|
|
eligible_controls.append(new_c) |
434
|
|
|
|
435
|
|
|
return eligible_controls |
436
|
|
|
|
437
|
|
|
@staticmethod |
438
|
|
|
def _get_control_without_variables(variables_to_remove, control): |
439
|
|
|
if not variables_to_remove: |
440
|
|
|
return control |
441
|
|
|
|
442
|
|
|
new_c = copy.deepcopy(control) |
443
|
|
|
for var in variables_to_remove: |
444
|
|
|
del new_c.variables[var] |
445
|
|
|
return new_c |
446
|
|
|
|
447
|
|
|
def get_all_controls(self, policy_id): |
448
|
|
|
policy = self._get_policy(policy_id) |
449
|
|
|
return policy.controls_by_id.values() |
450
|
|
|
|
451
|
|
|
def save_everything(self, output_dir): |
452
|
|
|
ssg.utils.mkdir_p(output_dir) |
453
|
|
|
for policy_id, policy in self.policies.items(): |
454
|
|
|
filename = os.path.join(output_dir, "{}.{}".format(policy_id, "yml")) |
455
|
|
|
policy.dump_yaml(filename) |
456
|
|
|
|