mirror of
https://github.com/SELinuxProject/setools
synced 2025-03-20 01:56:31 +00:00
563 lines
19 KiB
Python
563 lines
19 KiB
Python
# Copyright 2015, Tresys Technology, LLC
|
|
#
|
|
# This file is part of SETools.
|
|
#
|
|
# SETools is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU Lesser General Public License as
|
|
# published by the Free Software Foundation, either version 2.1 of
|
|
# the License, or (at your option) any later version.
|
|
#
|
|
# SETools is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU Lesser General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU Lesser General Public
|
|
# License along with SETools. If not, see
|
|
# <http://www.gnu.org/licenses/>.
|
|
#
|
|
|
|
import logging
|
|
|
|
from PyQt5.QtCore import pyqtSignal, Qt, QStringListModel, QThread
|
|
from PyQt5.QtGui import QPalette, QTextCursor
|
|
from PyQt5.QtWidgets import QCompleter, QHeaderView, QMessageBox, QProgressDialog, QScrollArea, \
|
|
QTreeWidgetItem
|
|
from setools import DomainTransitionAnalysis
|
|
|
|
from ..logtosignal import LogHandlerToSignal
|
|
from .excludetypes import ExcludeTypes
|
|
from ..widget import SEToolsWidget
|
|
from .workspace import load_checkboxes, load_spinboxes, load_lineedits, load_textedits, \
|
|
save_checkboxes, save_spinboxes, save_lineedits, save_textedits
|
|
|
|
|
|
class DomainTransitionAnalysisTab(SEToolsWidget, QScrollArea):
|
|
|
|
"""A domain transition analysis tab."""
|
|
|
|
def __init__(self, parent, policy, perm_map):
|
|
super(DomainTransitionAnalysisTab, self).__init__(parent)
|
|
self.log = logging.getLogger(__name__)
|
|
self.policy = policy
|
|
self.query = DomainTransitionAnalysis(policy)
|
|
self.query.source = None
|
|
self.query.target = None
|
|
self.setupUi()
|
|
|
|
def __del__(self):
|
|
self.thread.quit()
|
|
self.thread.wait(5000)
|
|
logging.getLogger("setools.dta").removeHandler(self.handler)
|
|
|
|
def setupUi(self):
|
|
self.log.debug("Initializing UI.")
|
|
self.load_ui("dta.ui")
|
|
|
|
# set up source/target autocompletion
|
|
type_completion_list = [str(t) for t in self.policy.types()]
|
|
type_completer_model = QStringListModel(self)
|
|
type_completer_model.setStringList(sorted(type_completion_list))
|
|
self.type_completion = QCompleter()
|
|
self.type_completion.setModel(type_completer_model)
|
|
self.source.setCompleter(self.type_completion)
|
|
self.target.setCompleter(self.type_completion)
|
|
|
|
# setup indications of errors on source/target/default
|
|
self.orig_palette = self.source.palette()
|
|
self.error_palette = self.source.palette()
|
|
self.error_palette.setColor(QPalette.Base, Qt.red)
|
|
self.clear_source_error()
|
|
self.clear_target_error()
|
|
|
|
# set up processing thread
|
|
self.thread = ResultsUpdater(self.query)
|
|
self.thread.raw_line.connect(self.raw_results.appendPlainText)
|
|
self.thread.finished.connect(self.update_complete)
|
|
self.thread.trans.connect(self.reset_browser)
|
|
|
|
# set up browser thread
|
|
self.browser_thread = BrowserUpdater(self.query)
|
|
self.browser_thread.trans.connect(self.add_browser_children)
|
|
|
|
# create a "busy, please wait" dialog
|
|
self.busy = QProgressDialog(self)
|
|
self.busy.setModal(True)
|
|
self.busy.setRange(0, 0)
|
|
self.busy.setMinimumDuration(0)
|
|
self.busy.setCancelButton(None)
|
|
self.busy.reset()
|
|
|
|
# update busy dialog from DTA INFO logs
|
|
self.handler = LogHandlerToSignal()
|
|
self.handler.message.connect(self.busy.setLabelText)
|
|
logging.getLogger("setools.dta").addHandler(self.handler)
|
|
|
|
# Ensure settings are consistent with the initial .ui state
|
|
self.max_path_length.setEnabled(self.all_paths.isChecked())
|
|
self.source.setEnabled(not self.flows_in.isChecked())
|
|
self.target.setEnabled(not self.flows_out.isChecked())
|
|
self.criteria_frame.setHidden(not self.criteria_expander.isChecked())
|
|
self.notes.setHidden(not self.notes_expander.isChecked())
|
|
self.browser_tab.setEnabled(self.flows_in.isChecked() or self.flows_out.isChecked())
|
|
|
|
# connect signals
|
|
self.buttonBox.clicked.connect(self.run)
|
|
self.source.textEdited.connect(self.clear_source_error)
|
|
self.source.editingFinished.connect(self.set_source)
|
|
self.target.textEdited.connect(self.clear_target_error)
|
|
self.target.editingFinished.connect(self.set_target)
|
|
self.all_paths.toggled.connect(self.all_paths_toggled)
|
|
self.flows_in.toggled.connect(self.flows_in_toggled)
|
|
self.flows_out.toggled.connect(self.flows_out_toggled)
|
|
self.reverse.stateChanged.connect(self.reverse_toggled)
|
|
self.exclude_types.clicked.connect(self.choose_excluded_types)
|
|
self.browser.currentItemChanged.connect(self.browser_item_selected)
|
|
|
|
#
|
|
# Analysis mode
|
|
#
|
|
def all_paths_toggled(self, value):
|
|
self.clear_source_error()
|
|
self.clear_target_error()
|
|
self.max_path_length.setEnabled(value)
|
|
|
|
def flows_in_toggled(self, value):
|
|
self.clear_source_error()
|
|
self.clear_target_error()
|
|
self.source.setEnabled(not value)
|
|
self.reverse.setEnabled(not value)
|
|
self.limit_paths.setEnabled(not value)
|
|
self.browser_tab.setEnabled(value)
|
|
|
|
if value:
|
|
self.reverse_old = self.reverse.isChecked()
|
|
self.reverse.setChecked(True)
|
|
else:
|
|
self.reverse.setChecked(self.reverse_old)
|
|
|
|
def flows_out_toggled(self, value):
|
|
self.clear_source_error()
|
|
self.clear_target_error()
|
|
self.target.setEnabled(not value)
|
|
self.reverse.setEnabled(not value)
|
|
self.limit_paths.setEnabled(not value)
|
|
self.browser_tab.setEnabled(value)
|
|
|
|
if value:
|
|
self.reverse_old = self.reverse.isChecked()
|
|
self.reverse.setChecked(False)
|
|
else:
|
|
self.reverse.setChecked(self.reverse_old)
|
|
|
|
#
|
|
# Source criteria
|
|
#
|
|
def set_source_error(self, error_text):
|
|
self.log.error("Source domain error: {0}".format(error_text))
|
|
self.source.setToolTip("Error: {0}".format(error_text))
|
|
self.source.setPalette(self.error_palette)
|
|
|
|
def clear_source_error(self):
|
|
self.source.setToolTip("The source domain of the analysis.")
|
|
self.source.setPalette(self.orig_palette)
|
|
|
|
def set_source(self):
|
|
try:
|
|
# look up the type here, so invalid types can be caught immediately
|
|
text = self.source.text()
|
|
if text:
|
|
self.query.source = self.policy.lookup_type(text)
|
|
else:
|
|
self.query.source = None
|
|
except Exception as ex:
|
|
self.set_source_error(ex)
|
|
|
|
#
|
|
# Target criteria
|
|
#
|
|
def set_target_error(self, error_text):
|
|
self.log.error("Target domain error: {0}".format(error_text))
|
|
self.target.setToolTip("Error: {0}".format(error_text))
|
|
self.target.setPalette(self.error_palette)
|
|
|
|
def clear_target_error(self):
|
|
self.target.setToolTip("The target domain of the analysis.")
|
|
self.target.setPalette(self.orig_palette)
|
|
|
|
def set_target(self):
|
|
try:
|
|
# look up the type here, so invalid types can be caught immediately
|
|
text = self.target.text()
|
|
if text:
|
|
self.query.target = self.policy.lookup_type(text)
|
|
else:
|
|
self.query.target = None
|
|
except Exception as ex:
|
|
self.set_target_error(ex)
|
|
|
|
#
|
|
# Options
|
|
#
|
|
def choose_excluded_types(self):
|
|
chooser = ExcludeTypes(self, self.policy)
|
|
chooser.show()
|
|
|
|
def reverse_toggled(self, value):
|
|
self.query.reverse = value
|
|
|
|
#
|
|
# Save/Load tab
|
|
#
|
|
def save(self):
|
|
"""Return a dictionary of settings."""
|
|
settings = {}
|
|
save_checkboxes(self, settings, ["criteria_expander", "notes_expander", "all_paths",
|
|
"all_shortest_paths", "flows_in", "flows_out", "reverse"])
|
|
save_lineedits(self, settings, ["source", "target"])
|
|
save_spinboxes(self, settings, ["max_path_length", "limit_paths"])
|
|
save_textedits(self, settings, ["notes"])
|
|
settings["exclude"] = [str(t) for t in self.query.exclude]
|
|
return settings
|
|
|
|
def load(self, settings):
|
|
load_checkboxes(self, settings, ["criteria_expander", "notes_expander", "all_paths",
|
|
"all_shortest_paths", "flows_in", "flows_out", "reverse"])
|
|
load_lineedits(self, settings, ["source", "target"])
|
|
load_spinboxes(self, settings, ["max_path_length", "limit_paths"])
|
|
load_textedits(self, settings, ["notes"])
|
|
|
|
try:
|
|
self.query.exclude = settings["exclude"]
|
|
except KeyError:
|
|
self.log.warning("Excluded types criteria missing from settings file.")
|
|
|
|
#
|
|
# Infoflow browser
|
|
#
|
|
def _new_browser_item(self, type_, parent, rules=None, children=None):
|
|
# build main item
|
|
item = QTreeWidgetItem(parent if parent else self.browser)
|
|
item.setText(0, str(type_))
|
|
item.type_ = type_
|
|
item.children = children if children else []
|
|
item.rules = rules if rules else []
|
|
item.child_populated = children is not None
|
|
|
|
# add child items
|
|
for child_type, child_rules in item.children:
|
|
child_item = self._new_browser_item(child_type, item, rules=child_rules)
|
|
item.addChild(child_item)
|
|
|
|
item.setExpanded(children is not None)
|
|
|
|
self.log.debug("Built item for {0} with {1} children and {2} rules".format(
|
|
type_, len(item.children), len(item.rules)))
|
|
|
|
return item
|
|
|
|
def reset_browser(self, root_type, out, children):
|
|
self.log.debug("Resetting browser.")
|
|
|
|
# clear results
|
|
self.browser.clear()
|
|
self.browser_details.clear()
|
|
|
|
# save browser details independent
|
|
# from main analysis UI settings
|
|
self.browser_root_type = root_type
|
|
self.browser_mode = out
|
|
|
|
root = self._new_browser_item(self.browser_root_type, self.browser, children=children)
|
|
|
|
self.browser.insertTopLevelItem(0, root)
|
|
|
|
def browser_item_selected(self, current, previous):
|
|
if not current:
|
|
# browser is being reset
|
|
return
|
|
|
|
self.log.debug("{0} selected in browser.".format(current.type_))
|
|
self.browser_details.clear()
|
|
|
|
try:
|
|
parent_type = current.parent().type_
|
|
except AttributeError:
|
|
# should only hit his on the root item
|
|
pass
|
|
else:
|
|
self.browser_details.appendPlainText("Domain Transitions {0} {1} {2}\n".format(
|
|
current.parent().type_, "->" if self.browser_mode else "<-", current.type_))
|
|
|
|
print_transition(self.browser_details.appendPlainText, current.rules)
|
|
|
|
self.browser_details.moveCursor(QTextCursor.Start)
|
|
|
|
if not current.child_populated:
|
|
self.busy.setLabelText("Gathering additional browser details for {0}...".format(
|
|
current.type_))
|
|
self.busy.show()
|
|
self.browser_thread.out = self.browser_mode
|
|
self.browser_thread.type_ = current.type_
|
|
self.browser_thread.start()
|
|
|
|
def add_browser_children(self, children):
|
|
item = self.browser.currentItem()
|
|
item.children = children
|
|
|
|
self.log.debug("Adding children for {0}".format(item.type_))
|
|
|
|
for child_type, child_rules in item.children:
|
|
child_item = self._new_browser_item(child_type, item, rules=child_rules)
|
|
item.addChild(child_item)
|
|
|
|
item.child_populated = True
|
|
self.busy.reset()
|
|
|
|
#
|
|
# Results runner
|
|
#
|
|
def run(self, button):
|
|
# right now there is only one button.
|
|
fail = False
|
|
if self.source.isEnabled() and not self.query.source:
|
|
self.set_source_error("A source domain is required")
|
|
fail = True
|
|
|
|
if self.target.isEnabled() and not self.query.target:
|
|
self.set_target_error("A target domain is required.")
|
|
fail = True
|
|
|
|
if fail:
|
|
return
|
|
|
|
for mode in [self.all_paths, self.all_shortest_paths, self.flows_in, self.flows_out]:
|
|
if mode.isChecked():
|
|
break
|
|
|
|
self.query.mode = mode.objectName()
|
|
self.query.max_path_len = self.max_path_length.value()
|
|
self.query.limit = self.limit_paths.value()
|
|
|
|
# start processing
|
|
self.busy.setLabelText("Processing query...")
|
|
self.busy.show()
|
|
self.raw_results.clear()
|
|
self.thread.start()
|
|
|
|
def update_complete(self):
|
|
if not self.busy.wasCanceled():
|
|
self.busy.setLabelText("Moving the raw result to top; GUI may be unresponsive")
|
|
self.busy.repaint()
|
|
self.raw_results.moveCursor(QTextCursor.Start)
|
|
|
|
if self.flows_in.isChecked() or self.flows_out.isChecked():
|
|
# move to browser tab for transitions in/out
|
|
self.results_frame.setCurrentIndex(1)
|
|
else:
|
|
self.results_frame.setCurrentIndex(0)
|
|
|
|
self.busy.reset()
|
|
|
|
|
|
def sort_transition(trans):
|
|
"""Sort the rules of a transition in-place."""
|
|
trans.transition.sort()
|
|
trans.setexec.sort()
|
|
trans.entrypoints.sort()
|
|
trans.dyntransition.sort()
|
|
trans.setcurrent.sort()
|
|
for e in trans.entrypoints:
|
|
e.entrypoint.sort()
|
|
e.execute.sort()
|
|
e.type_transition.sort()
|
|
|
|
|
|
def print_transition(renderer, trans):
|
|
"""
|
|
Raw rendering of a domain transition.
|
|
|
|
Parameters:
|
|
renderer A callable which will render the output, e.g. print
|
|
trans A step (transition object) generated by the DTA.
|
|
"""
|
|
|
|
if trans.transition:
|
|
renderer("Domain transition rule(s):")
|
|
for t in trans.transition:
|
|
renderer(str(t))
|
|
|
|
if trans.setexec:
|
|
renderer("\nSet execution context rule(s):")
|
|
for s in trans.setexec:
|
|
renderer(str(s))
|
|
|
|
for entrypoint in trans.entrypoints:
|
|
renderer("\nEntrypoint {0}:".format(entrypoint.name))
|
|
|
|
renderer("\tDomain entrypoint rule(s):")
|
|
for e in entrypoint.entrypoint:
|
|
renderer("\t{0}".format(e))
|
|
|
|
renderer("\n\tFile execute rule(s):")
|
|
for e in entrypoint.execute:
|
|
renderer("\t{0}".format(e))
|
|
|
|
if entrypoint.type_transition:
|
|
renderer("\n\tType transition rule(s):")
|
|
for t in entrypoint.type_transition:
|
|
renderer("\t{0}".format(t))
|
|
|
|
renderer("")
|
|
|
|
if trans.dyntransition:
|
|
renderer("Dynamic transition rule(s):")
|
|
for d in trans.dyntransition:
|
|
renderer(str(d))
|
|
|
|
renderer("\nSet current process context rule(s):")
|
|
for s in trans.setcurrent:
|
|
renderer(str(s))
|
|
|
|
renderer("")
|
|
|
|
renderer("")
|
|
|
|
|
|
class ResultsUpdater(QThread):
|
|
|
|
"""
|
|
Thread for processing queries and updating result widgets.
|
|
|
|
Parameters:
|
|
query The query object
|
|
model The model for the results
|
|
|
|
Qt signals:
|
|
raw_line (str) A string to be appended to the raw results.
|
|
trans (str, bool, list) Initial information for populating
|
|
the transitions browser.
|
|
"""
|
|
|
|
raw_line = pyqtSignal(str)
|
|
trans = pyqtSignal(str, bool, list)
|
|
|
|
def __init__(self, query):
|
|
super(ResultsUpdater, self).__init__()
|
|
self.query = query
|
|
self.log = logging.getLogger(__name__)
|
|
|
|
def __del__(self):
|
|
self.wait()
|
|
|
|
def run(self):
|
|
"""Run the query and update results."""
|
|
|
|
assert self.query.limit, "Code doesn't currently handle unlimited (limit=0) paths."
|
|
self.out = self.query.mode == "flows_out"
|
|
|
|
if self.query.mode == "all_paths":
|
|
self.transitive(self.query.all_paths(self.query.source, self.query.target,
|
|
self.query.max_path_len))
|
|
elif self.query.mode == "all_shortest_paths":
|
|
self.transitive(self.query.all_shortest_paths(self.query.source, self.query.target))
|
|
elif self.query.mode == "flows_out":
|
|
self.direct(self.query.transitions(self.query.source))
|
|
else: # flows_in
|
|
self.direct(self.query.transitions(self.query.target))
|
|
|
|
def transitive(self, paths):
|
|
i = 0
|
|
for i, path in enumerate(paths, start=1):
|
|
self.raw_line.emit("Domain transition path {0}:".format(i))
|
|
|
|
for stepnum, step in enumerate(path, start=1):
|
|
|
|
self.raw_line.emit("Step {0}: {1} -> {2}\n".format(stepnum, step.source,
|
|
step.target))
|
|
sort_transition(step)
|
|
print_transition(self.raw_line.emit, step)
|
|
|
|
if QThread.currentThread().isInterruptionRequested() or (i >= self.query.limit):
|
|
break
|
|
else:
|
|
QThread.yieldCurrentThread()
|
|
|
|
self.raw_line.emit("{0} domain transition path(s) found.".format(i))
|
|
self.log.info("{0} domain transition path(s) found.".format(i))
|
|
|
|
def direct(self, transitions):
|
|
i = 0
|
|
child_types = []
|
|
for i, step in enumerate(transitions, start=1):
|
|
self.raw_line.emit("Transition {0}: {1} -> {2}\n".format(i, step.source, step.target))
|
|
sort_transition(step)
|
|
print_transition(self.raw_line.emit, step)
|
|
|
|
# Generate results for flow browser
|
|
if self.out:
|
|
child_types.append((step.target, step))
|
|
else:
|
|
child_types.append((step.source, step))
|
|
|
|
if QThread.currentThread().isInterruptionRequested():
|
|
break
|
|
else:
|
|
QThread.yieldCurrentThread()
|
|
|
|
self.raw_line.emit("{0} domain transition(s) found.".format(i))
|
|
self.log.info("{0} domain transition(s) found.".format(i))
|
|
|
|
# Update browser:
|
|
root_type = self.query.source if self.out else self.query.target
|
|
self.trans.emit(str(root_type), self.out, sorted(child_types))
|
|
|
|
|
|
class BrowserUpdater(QThread):
|
|
|
|
"""
|
|
Thread for processing additional analysis for the browser.
|
|
|
|
Parameters:
|
|
query The query object
|
|
model The model for the results
|
|
|
|
Qt signals:
|
|
trans A list of child types to render in the
|
|
transitions browser.
|
|
"""
|
|
|
|
trans = pyqtSignal(list)
|
|
|
|
def __init__(self, query):
|
|
super(BrowserUpdater, self).__init__()
|
|
self.query = query
|
|
self.type_ = None
|
|
self.out = None
|
|
self.log = logging.getLogger(__name__)
|
|
|
|
def __del__(self):
|
|
self.wait()
|
|
|
|
def run(self):
|
|
transnum = 0
|
|
child_types = []
|
|
for transnum, trans in enumerate(self.query.transitions(self.type_), start=1):
|
|
# Generate results for browser
|
|
sort_transition(trans)
|
|
|
|
if self.out:
|
|
child_types.append((trans.target, trans))
|
|
else:
|
|
child_types.append((trans.source, trans))
|
|
|
|
if QThread.currentThread().isInterruptionRequested():
|
|
break
|
|
else:
|
|
QThread.yieldCurrentThread()
|
|
|
|
self.log.debug("{0} additional domain transition(s) found.".format(transnum))
|
|
|
|
# Update browser:
|
|
self.trans.emit(sorted(child_types))
|