Gecko [ naturenectar.co.uk ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2025-08-15 18:09
__init__.py	2.52 KB	-rw-r--r--	2023-12-07 15:49
bool.py	2.43 KB	-rw-r--r--	2023-12-07 15:49
bounds.py	3.69 KB	-rw-r--r--	2023-12-07 15:49
commons.py	2.15 KB	-rw-r--r--	2023-12-07 15:49
conditional.py	1.23 KB	-rw-r--r--	2023-12-07 15:49
constraints.py	8.2 KB	-rw-r--r--	2023-12-07 15:49
context.py	1.36 KB	-rw-r--r--	2023-12-07 15:49
default.py	3.54 KB	-rw-r--r--	2023-12-07 15:49
descriptors.py	1.04 KB	-rw-r--r--	2023-12-07 15:49
difference.py	5.36 KB	-rw-r--r--	2023-12-07 15:49
fsuse.py	2.49 KB	-rw-r--r--	2023-12-07 15:49
genfscon.py	2.66 KB	-rw-r--r--	2023-12-07 15:49
ibendportcon.py	2.58 KB	-rw-r--r--	2023-12-07 15:49
ibpkeycon.py	2.59 KB	-rw-r--r--	2023-12-07 15:49
initsid.py	1.95 KB	-rw-r--r--	2023-12-07 15:49
mls.py	9.91 KB	-rw-r--r--	2023-12-07 15:49
mlsrules.py	4.55 KB	-rw-r--r--	2023-12-07 15:49
netifcon.py	3.05 KB	-rw-r--r--	2023-12-07 15:49
nodecon.py	2.59 KB	-rw-r--r--	2023-12-07 15:49
objclass.py	3.08 KB	-rw-r--r--	2023-12-07 15:49
polcap.py	1.09 KB	-rw-r--r--	2023-12-07 15:49
portcon.py	2.57 KB	-rw-r--r--	2023-12-07 15:49
properties.py	1.78 KB	-rw-r--r--	2023-12-07 15:49
rbacrules.py	6.4 KB	-rw-r--r--	2023-12-07 15:49
roles.py	2.66 KB	-rw-r--r--	2023-12-07 15:49
terules.py	24.09 KB	-rw-r--r--	2023-12-07 15:49
typeattr.py	2.8 KB	-rw-r--r--	2023-12-07 15:49
types.py	4.17 KB	-rw-r--r--	2023-12-07 15:49
typing.py	458 B	-rw-r--r--	2023-12-07 15:49
users.py	5.35 KB	-rw-r--r--	2023-12-07 15:49

Rename

# Copyright 2016, Tresys Technology, LLC
# Copyright 2018, Chris PeBenito <pebenito@ieee.org>
#
# SPDX-License-Identifier: LGPL-2.1-only
#
from collections import defaultdict
from typing import NamedTuple

from ..policyrep import AnyRBACRule, RBACRuletype, Role, RoleAllow, RoleTransition

from .descriptors import DiffResultDescriptor
from .difference import Difference, Wrapper
from .objclass import class_wrapper_factory
from .roles import role_wrapper_factory
from .types import type_or_attr_wrapper_factory
from .typing import RuleList

class ModifiedRBACRule(NamedTuple):

"""Difference details for a modified RBAC rule."""

rule: AnyRBACRule
    added_default: Role
    removed_default: Role

class RBACRulesDifference(Difference):

"""Determine the difference in RBAC rules between two policies."""

added_role_allows = DiffResultDescriptor("diff_role_allows")
    removed_role_allows = DiffResultDescriptor("diff_role_allows")
    # role allows cannot be modified, only added/removed

added_role_transitions = DiffResultDescriptor("diff_role_transitions")
    removed_role_transitions = DiffResultDescriptor("diff_role_transitions")
    modified_role_transitions = DiffResultDescriptor("diff_role_transitions")

# Lists of rules for each policy
    _left_rbac_rules: RuleList[RBACRuletype, AnyRBACRule] = None
    _right_rbac_rules: RuleList[RBACRuletype, AnyRBACRule] = None

def diff_role_allows(self) -> None:
        """Generate the difference in role allow rules between the policies."""

self.log.info(
            "Generating role allow differences from {0.left_policy} to {0.right_policy}".
            format(self))

if self._left_rbac_rules is None or self._right_rbac_rules is None:
            self._create_rbac_rule_lists()

assert self._left_rbac_rules is not None, "Left RBAC rules didn't load, this a bug."
        assert self._right_rbac_rules is not None, "Right RBAC rules didn't load, this a bug."

self.added_role_allows, self.removed_role_allows, _ = self._set_diff(
            self._expand_generator(self._left_rbac_rules[RBACRuletype.allow], RoleAllowWrapper),
            self._expand_generator(self._right_rbac_rules[RBACRuletype.allow], RoleAllowWrapper))

def diff_role_transitions(self) -> None:
        """Generate the difference in role_transition rules between the policies."""

self.log.info(
            "Generating role_transition differences from {0.left_policy} to {0.right_policy}".
            format(self))

if self._left_rbac_rules is None or self._right_rbac_rules is None:
            self._create_rbac_rule_lists()

assert self._left_rbac_rules is not None, "Left RBAC rules didn't load, this a bug."
        assert self._right_rbac_rules is not None, "Right RBAC rules didn't load, this a bug."

added, removed, matched = self._set_diff(
            self._expand_generator(self._left_rbac_rules[RBACRuletype.role_transition],
                                   RoleTransitionWrapper),
            self._expand_generator(self._right_rbac_rules[RBACRuletype.role_transition],
                                   RoleTransitionWrapper))

modified = []
        for left_rule, right_rule in matched:
            # Criteria for modified rules
            # 1. change to default role
            if role_wrapper_factory(left_rule.default) != role_wrapper_factory(right_rule.default):
                modified.append(ModifiedRBACRule(left_rule,
                                                 right_rule.default,
                                                 left_rule.default))

self.added_role_transitions = added
        self.removed_role_transitions = removed
        self.modified_role_transitions = modified

#
    # Internal functions
    #
    def _create_rbac_rule_lists(self) -> None:
        """Create rule lists for both policies."""
        # do not expand yet, to keep memory
        # use down as long as possible
        self._left_rbac_rules = defaultdict(list)
        self.log.debug("Building RBAC rule lists from {0.left_policy}".format(self))
        for rule in self.left_policy.rbacrules():
            self._left_rbac_rules[rule.ruletype].append(rule)

self._right_rbac_rules = defaultdict(list)
        self.log.debug("Building RBAC rule lists from {0.right_policy}".format(self))
        for rule in self.right_policy.rbacrules():
            self._right_rbac_rules[rule.ruletype].append(rule)

self.log.debug("Completed building RBAC rule lists.")

def _reset_diff(self) -> None:
        """Reset diff results on policy changes."""
        self.log.debug("Resetting RBAC rule differences")
        self.added_role_allows = None
        self.removed_role_allows = None
        self.added_role_transitions = None
        self.removed_role_transitions = None
        self.modified_role_transitions = None

# Sets of rules for each policy
        self._left_rbac_rules = None
        self._right_rbac_rules = None

class RoleAllowWrapper(Wrapper[RoleAllow]):

"""Wrap role allow rules to allow set operations."""

__slots__ = ("source", "target")

def __init__(self, rule: RoleAllow) -> None:
        self.origin = rule
        self.source = role_wrapper_factory(rule.source)
        self.target = role_wrapper_factory(rule.target)
        self.key = hash(rule)

def __hash__(self):
        return self.key

def __lt__(self, other):
        return self.key < other.key

def __eq__(self, other):
        # because RBACRuleDifference groups rules by ruletype,
        # the ruletype always matches.
        return self.source == other.source and self.target == other.target

class RoleTransitionWrapper(Wrapper[RoleTransition]):

"""Wrap role_transition rules to allow set operations."""

__slots__ = ("source", "target", "tclass")

def __init__(self, rule: RoleTransition) -> None:
        self.origin = rule
        self.source = role_wrapper_factory(rule.source)
        self.target = type_or_attr_wrapper_factory(rule.target)
        self.tclass = class_wrapper_factory(rule.tclass)
        self.key = hash(rule)

def __hash__(self):
        return self.key

def __lt__(self, other):
        return self.key < other.key

def __eq__(self, other):
        # because RBACRuleDifference groups rules by ruletype,
        # the ruletype always matches.
        return self.source == other.source and \
            self.target == other.target and \
            self.tclass == other.tclass