[PATCH 02/14] Add TSEM specific documentation.
Roberto Sassu
roberto.sassu at huaweicloud.com
Tue Feb 14 12:18:45 UTC 2023
On Tue, 2023-02-14 at 05:58 -0600, Dr. Greg wrote:
> On Sun, Feb 12, 2023 at 11:33:26PM -0500, Paul Moore wrote:
> > On Sat, Feb 4, 2023 at 12:33 AM Dr. Greg <greg at enjellic.com> wrote:
> > > An entry was added to the ABI testing documentation to document
> > > the files in the TSEM management filesystem.
> > >
> > > The file documenting the kernel command-line parameters was
> > > updated to document the tsem_mode command-line parameter.
> > >
> > > The primary TSEM documentation file was added to the LSM
> > > administration guide and the file was linked to the index of LSM
> > > documentation.
> > >
> > > Signed-off-by: Greg Wettstein <greg at enjellic.com>
> > > ---
> > > Documentation/ABI/testing/tsemfs | 576 ++++++++
> > > Documentation/admin-guide/LSM/index.rst | 1 +
> > > Documentation/admin-guide/LSM/tsem.rst | 1240 +++++++++++++++++
> > > .../admin-guide/kernel-parameters.txt | 5 +
> > > 4 files changed, 1822 insertions(+)
> > > create mode 100644 Documentation/ABI/testing/tsemfs
> > > create mode 100644 Documentation/admin-guide/LSM/tsem.rst
> > One of the more important requirements for any new LSM is that it
> > documents a clear, understandable, and reasonable security model along
> > with an implementation that faithfully implements that model. Before
> > I looked at your code I wanted to try and understand the TSEM security
> > model and a few things jumped out at me rather quickly, I imagine
> > there would be others as I start to look a bit closer but I wanted to
> > send these questions/comments along now to get your take on them ...
>
> Hi Paul, thanks for taking time to review the documentation and raise
> questions, responses below.
>
> > > diff --git a/Documentation/ABI/testing/tsemfs b/Documentation/ABI/testing/tsemfs
> > > new file mode 100644
> > > index 000000000000..3d326934624c
> > > --- /dev/null
> > > +++ b/Documentation/ABI/testing/tsemfs
> > > @@ -0,0 +1,576 @@
> >
> > ...
> >
> > > +What: /sys/fs/tsem/aggregate
> > > +Date: November 2022
> > > +Contact: Greg Wettstein <greg at enjellic.com>
> > > +Description:
> > > + The aggregate file contains the ASCII base 16
> > > + representation of the 256 bit hardware platform
> > > + aggregate that TSEM is modeling under. The platform
> > > + aggregate is the extension measurement of the Trusted
> > > + Platform Module PCR registers 0 through 8.
> > I'm guessing the above is a typo and you mean PCRs 0 through 7 (not
> > 8)? If not, you need to provide an explanation somewhere as to what
> > you are using PCR 8 for in TSEM and how it is extended, etc.
>
> You are correct, it was a typo, it is registers 0 through 7, classic
> zero counted array error.... :-)
>
> We verified that the implementation is indeed aggregating registers 0
> through 7.
>
> > > +What: /sys/fs/tsem/measurement
> > > +Date: November 2022
> > > +Contact: Greg Wettstein <greg at enjellic.com>
> > > +Description:
> > > + The measurement file contains the ASCII base 16
> > > + hexadecimal representation of the 256 bit measurement
> > > + value of the security model that the process is
> > > + operating in.
> > > +
> > > + The measurement value is the classic linear extension
> > > + measurement of the model. An updated measurement
> > > + value is created by extending the current measurement
> > > + value with the state coefficient computed for a
> > > + security event.
> > > +
> > > + This measurement value represents a time dependent
> > > + measurement of a model and is susceptible to
> > > + deviations caused by scheduling differences between
> > > + subsequent invocations of a workload.
> > Given the very volatile nature of this value, what is it used for in
> > userspace? My apologies if I missed it in the docs.
>
> It serves the same role as PCR register 10 in IMA, or any other
> register in a TPM based architecture using a classic linear extension
> mechanism strategy, it can be used to validate a list of time or
> sequence ordered measurement values.
>
> Our personal prejudice is that these types of measurements are of
> limited value, which is why we introduce in TSEM, the notion of the
> 'state' value for a model, discussed below.
>
> I would have to go looking on lore for a reference to the exact thread
> but Roberto Sassu had offered up a patch set for IMA that addressed
> the deficiency of these types of measurements.
Hi Greg
yes, this:
https://lore.kernel.org/linux-integrity/20210914163401.864635-1-roberto.sassu@huawei.com/
DIGLIM makes the PCR extended with software measurements deterministic,
independent from how processes are scheduled, at the cost of not
knowing if files with matching digests from a list were accessed or
not, and in which order.
But, in exchange, you can seal a TLS key to IMA measurements that is
available for handshakes as long as the system does not execute
something unknown. After that, you have to reboot to use the key again.
(Didn't read your proposal yet.)
Roberto
> > > +What: /sys/fs/tsem/points
> > > +Date: November 2022
> > > +Contact: Greg Wettstein <greg at enjellic.com>
> > > +Description:
> > > + The points file contains the ASCII base 16
> > > + representation of the 256 bit security state points of
> > > + a security domain/model. The number of entries in
> > > + this file represent the number of security events that
> > > + are represented by the model.
> > A similar questions to the tsem/measurement file. If I understand
> > you correctly, this is basically a series of SHA256 digests without
> > any additional annotations, and without any ordering guarantees,
> > yes? What is it used for in userspace?
>
> The values in the points file represent the current state of a model,
> they are the coefficients that describe the security events that have
> been modeled.
>
> The output of this file can be captured and written to the
> /sys/fs/tsem/map file in order to define a security model that is to
> be subsequently enforced.
>
> > > +What: /sys/fs/tsem/state
> > > +Date: November 2022
> > > +Contact: Greg Wettstein <greg at enjellic.com>
> > > +Description:
> > > + The state file contains the ASCII base 16
> > > + representation of the 256 bit value of the functional
> > > + state of a security domain/model.
> > > +
> > > + The state value is a time independent representation
> > > + of the measurement of a model/domain, and unlike the
> > > + measurement value, is a time independent
> > > + representation of the security state of a workload.
> > > +
> > > + This value is designed to be a single value that can
> > > + be attested to represent whether or not a workload has
> > > + deviated from a defined security behavior.
> > It might be nice to explain how this value is calculated here in
> > this file to remove any time or ordering dependencies. Once again
> > my apologies if I missed it in the rest of the docs.
>
> The TSEM LSM documentation covers the issues surrounding the
> measurement and state values. See the section entitled 'Security
> model functional definitions'.
>
> Put succinctly, the state value is computed by generating a standard
> linear extension sum over a list of security state points that have
> been sorted in big-endian, ie. natural hash order.
>
> It is designed to provide a time and scheduling independent value that
> can be used to attest that a security model has not violated its
> definition.
>
> Don't apologize, there is a lot there to read, our loquaciousness
> knows no bounds.... :-)
>
> > > +What: /sys/fs/tsem/trajectory
> > > +Date: November 2022
> > > +Contact: Greg Wettstein <greg at enjellic.com>
> > > +Description:
> > > + The trajectory file contains a description of the
> > > + security events that have occurred in a security
> > > + domain/model.
> > > +
> > > + Each entry in this file represents a single security
> > > + event and consists of brace {} delimited fields that
> > > + describe the characteristics of a security event.
> > > + Each field has key=value pairs that define
> > > + characteristics of the field.
> > > +
> > > + Each line in a trajectory, or forensics, file will
> > > + always have the event{} and COE{} fields. The event
> > > + field describes the characteristics of a security
> > > + event while the COE field describes the Context Of
> > > + Execution that is executing the security event.
> > I think it would be good to provide a concrete definition of
> > CELL_DEFINITION field as other areas of the documentation make
> > reference to it within the tsem/trajectory file documentation. We can
> > somewhat infer it's format, fields, etc. but it's much better to be
> > explicit about these things.
>
> Valid point, we will incorporate a broad definition of what the 'CELL'
> represents.
>
> Conceptually, it is equivalent to the 'object' in mandatory access
> controls. In an events based architecture like TSEM, it is
> essentially the 'bucket' of values that describe the parameters of a
> security event that a COE/process is requesting permission for.
>
> The name is actually in deference to Turing theory, which all of this
> relates back to, but no need to go there now.
>
> > > + The event{} field consists of the following
> > > + characteristic definitions:
> > I'm unclear as to the purpose of the event{} field as it is neither
> > part of the COE or the CELL, is it here simply to make the event
> > easier to read? Or am I misunderstanding things and the event{}
> > field is part of the COE?
>
> It actually serves two roles, one of which, as you note, is to make
> the event description easier to read and understand.
>
> It probably comes as no surprise, but the trust orchestration system
> that this is all designed to support, has a security console that can
> be used to review the status of all the trust orchestrators that are
> supervising security workloads. Either in the cloud, or perhaps, a
> large body of edge devices protecting critical infrastructure, if that
> doesn't give away too much.... :-)
>
> Having the process name and executable easily visualized is fairly
> useful.
>
> The second role is to allow the event description records to be
> self-describing. The value for the type= key is used by the Trusted
> Modeling Agent (TMA) to determine what to look for in the remainder of
> the event description record in order to compute the CELL value.
>
> It also contains the TASK_ID value that ties the security state points
> to the integrity of the executable. Since that value is a synthetic
> value it was deemed most appropriate to be placed in the event{}
> field.
>
> > > + process=COMM
> > > + Where COMM is the ASCII representation
> > > + of the name of the process executing
> > > + the event.
> > > +
> > > + filename=PATH
> > > + If the CELL definition for an event
> > > + references a file the filename
> > > + characteristic contains a definition
> > > + of the path to the file.
> > > +
> > > + In the case where an event does not
> > > + have a file the PATH value is set to a
> > > + value of none.
> > What happens in cases where multiple file paths are present in an
> > event? Also, given this is visible to userspace, and multiple
> > things can affect the path to a file (e.g. namespaces), how is the
> > file path determined?
>
> Unless we have missed something, which is no doubt possible, all of
> the security event hooks that we have implemented, which number about
> 87 now, that act on a 'file', receive only a single 'struct file *'
> pointer as a parameter to the event.
>
> So we haven't encountered a situation where there would be multiple
> files for a single event description.
>
> There is certainly the case where multiple security state points
> involve the same file. This can easily be seen, for example, in a
> trust orchestrator running a workload in a runc container, where
> multiple state points are generated by different executable mappings
> of the runc binary at startup
>
> The file path is the absolute pathname in the mount namespace that the
> modeled workload is running in.
>
> See the following for details:
>
> security/tsem/event.c:get_path()
>
> > > + type=EVENT_TYPE
> > > + The value field for a type key is the
> > > + name of the security event that is
> > > + being modeled. The list of value
> > > + EVENT_TYPE names is defined in the
> > > + following source file:
> > > +
> > > + security/tsem/tsem.c
> > > +
> > > + If the security event is a generically
> > > + modeled event the EVENT_TYPE will be
> > > + generic_event. In this case the CELL
> > > + characteristics for the event will be
> > > + described by a generic_event{} field.
> > > +
> > > + task_id=TASK_ID
> > > + The value of the task_id key will the
> > > + ASCII base 16 representation of the
> > > + model identity of the task that is
> > > + executing the security event.
> > > +
> > > + The following documentation file:
> > > +
> > > + Documentation/admin-guide/LSM/TSEM.rst
> > > +
> > > + Describes how the TASK_ID value is
> > > + generated.
> > > +
> > > + The COE{} field consists of the following
> > > + characteristic definitions:
> > > +
> > > + uid=NN
> > > + The ASCII base 10 representation of
> > > + the numeric value of the discretionary
> > > + user id of the process that is
> > > + executing the security event.
> > Given the ability to map UID/GID values in the kernel, what will be
> > used as the basis for the COE? What happens when the basis used in
> > the kernel's COE generation does not match the basis used by the
> > external modeler?
>
> The UID/GID values used are the values defined in the initial
> user namespace, see security/tsem/event.c:get_COE().
>
> The basis set state that the trust orchestrator is running in has no
> effect on the generation of the security state point. The modeling
> engine only operates on the values presented to it and determines if
> the state point generated from the state description matches the model
> it has been requested to enforce.
>
> If it doesn't, the event is considered to violate the trust model.
>
> > > + euid=NN
> > > + The ASCII base 10 representation of
> > > + the numeric value of the effective
> > > + discretionary user id of the process
> > > + that is executing the security event.
> > > +
> > > + euid=NN
> > > + The ASCII base 10 representation of
> > > + the numeric value of the effective
> > > + discretionary user id of the process
> > > + that is executing the security event.
> > > +
> > > + suid=NN
> > > + The ASCII base 10 representation of
> > > + the numeric value of the saved user id
> > > + of the process that is executing the
> > > + security event.
> > > +
> > > + gid=NN
> > > + The ASCII base 10 representation of
> > > + the numeric value of the discretionary
> > > + group id of the process that is
> > > + executing the security event.
> > > +
> > > + egid=NN
> > > + The ASCII base 10 representation of
> > > + the numeric value of the discretionary
> > > + effective group id of the process that
> > > + is executing the security event.
> > > +
> > > + egid=NN
> > > + The ASCII base 10 representation of
> > > + the numeric value of the discretionary
> > > + effective group id of the process that
> > > + is executing the security event.
> > > +
> > > + sgid=NN
> > > + The base 10 ASCII representation of
> > > + the numeric value of the saved
> > > + discretionary group id of the process
> > > + that is executing the security event.
> > > +
> > > + fsuid=NN
> > > + The base 10 ASCII representation of
> > > + the numeric value of the discretionary
> > > + filesystem user id of the process that
> > > + is executing the security event.
> > > +
> > > + fsgid=NN
> > > + The ASCII base 10 representation of
> > > + the numeric value of the discretionary
> > > + filesystem group id of the process
> > > + that is executing the security event.
> > > +
> > > + cap=0xNNN
> > > + The ASCII base 16 representation of
> > > + the numeric value of effective
> > > + capabilities of the process that is
> > > + executing the security event.
> > > +
> > > + If the CELL value for a security event includes the
> > > + definition of a file a file{} event field will be
> > > + included. The following characteristics will be
> > > + encoded in this field:
> > > +
> > > + flags=NN
> > > + The ASCII base 10 representation of
> > > + the flags value of the 'struct file'
> > > + structure that is the source of the
> > > + file description.
> > > +
> > > + uid=NN
> > > + The ASCII base 10 representation of
> > > + the discretionary user id of the file.
> > > +
> > > + gid=NN
> > > + The base 10 ASCII representation of
> > > + the discretionary group id of the
> > > + file.
> > Similar to the task UID/GID mapping questions above, there are
> > mechanisms which map the file user/group IDs, which will be used in
> > the CELL definition and how will that be resolved between the kernel
> > and an external modeler?
>
> The answer is the same as with the COE, see the following function:
>
> security/tsem/event.c:get_file_cell()
>
> Once again, the TMA only operates on the event description presented
> to it and is not influenced by its own namespace.
>
> > > +What: /sys/fs/tsem/ExternalTMA
> > > +Date: November 2022
> > > +Contact: Greg Wettstein <greg at enjellic.com>
> > > +Description:
> > > + The ExternalTMA directory is a container directory
> > > + that hold files that will be used to export the
> > > + security events, and their associated parameters, for
> > > + externally modeled security domains/namespaces.
> > > +
> > > + The files created in this directory will be named by
> > > + the base 10 ASCII representation of the id value
> > > + assigned to the modeling domain/namespace. See the
> > > + documentation for the /sys/fs/tsem/id file in this
> > > + documentation for more details on this value.
> > > +
> > > + This file will is a read-only file that can be polled
> > > + by a userspace trust orchestration implementation to
> > > + process security events that are to be modeled by
> > > + an external Trusted Modeling Agent.
> > > +
> > > + The type of the exported event is the first keyword of
> > > + the line that is output and have the following
> > > + values and arguments:
> > > +
> > > + aggregate HEXID:
> > > + Where HEXID is the ASCII base 16
> > > + representation of the 256 bit hardware
> > > + platform aggregate value.
> > > +
> > > + export pid{NNN} COE{} CELL_DEFINITION
> > > + Where the NNN in the pid field is the ASCII
> > > + base 10 value of the id of the process that is
> > > + executing the security event that will be
> > > + modeled.
> > I worry whenever I see a PID used as an identifier shared across the
> > kernel/userspace boundary as it is inherently racy. Given the
> > somewhat coarse COE definition where one can expect multiple
> > processes/PIDs to share the same COE value, and the ability of
> > untrusted users/processes to manipulate the PID table, what do you
> > expect to use the pid{NNN} field for in this event?
> >
> > Similar to the other namespace/mapping issues discussed previously,
> > there is also the PID namespace issue to worry about. How is that
> > handled here?
>
> The concern over the PID issue is understandable, I will treat the
> reasoning behind its use below.
>
> The PID value is the 'native' value managed by the kernel, not a
> mapped value.
>
> > > + The COE field has the same format as the field
> > > + emitted for a trajectory or forensics event.
> > > +
> > > + The CELL_DEFINITION are the same field
> > > + definitions that are emitted for a trajectory
> > > + or forensics event.
> > > +
> > > + log process{name} event{type} action{type}
> > > + The log event is emitted when an untrusted
> > > + task attempts to execute a security event.
> > > +
> > > + The name value of the COE field is the name of
> > > + the process (comm value) that is executing the
> > > + security event.
> > > +
> > > + The type value of the event field is the name
> > > + of the security event being executed as
> > > + defined in the tsem_names array in the
> > > + security/tsem/tsem.c file.
> > > +
> > > + The type value of the action field is the type
> > > + of action the LSM enforced in response to
> > > + encountering the untrusted process. This
> > > + value will be either LOG or EPERM to represent
> > > + whether or not the trust violation is being
> > > + logged or enforced.
> > > +
> > > +What: /sys/fs/tsem/control
> > > +Date: November 2022
> > > +Contact: Greg Wettstein <greg at enjellic.com>
> > > +Description:
> > > + The control file is the only writable file in the
> > > + filesystem and is used by the trust orchestrators to
> > > + configure and control the behavior of the TSEM
> > > + implementation.
> > > +
> > > + The following keyword and arguments are recognized:
> > > +
> > > + internal:
> > > + The internal keyword causes an internally
> > > + modeled domain to be created for the calling
> > > + process.
> > > +
> > > + external:
> > > + The external keyword causes an externally
> > > + modeled domain to be created for the calling
> > > + process.
> > > +
> > > + enforce:
> > > + The enforce keyword causes the modeling
> > > + domain/namespace of the process to enter
> > > + enforcing mode. In this mode a value of
> > > + -EPERM will be returned for a security event
> > > + that does not map into the current set of
> > > + allowed state points for the security model
> > > + being implemented for the domain/namespace.
> > > +
> > > + seal:
> > > + The seal keyword causes the security model
> > > + being implemented for the model to be placed
> > > + in sealed state. In this state the current
> > > + set of security event points is considered to
> > > + be the only set of valid points for the
> > > + domain/model. Any subsequent events that map
> > > + to a point not in the current model will be
> > > + considered a violation of the model.
> > > +
> > > + trusted PID:
> > > + The trusted keyword is used by a trust
> > > + orchestrator to indicate that the process
> > > + identified by the PID argument should be
> > > + allowed to run in trusted status.
> > > +
> > > + untrusted PID:
> > > + The untrusted keyword is used by a trust
> > > + orchestrator to indicate that the process
> > > + identified by the PID argument should be
> > > + allowed to run but designated as an untrusted
> > > + process.
> > The 'trusted PID:' and 'untrusted PID:' commands are concerning for
> > the reasons described above about PIDs being racy and generally an
> > unreliable way of identifying processes across the kernel/userspace
> > boundary. I suspect it would not be too difficult for a malicious
> > user to trick an external modeler into marking the wrong process as
> > trusted/untrusted.
>
> An external TMA needs the PID value to determine which process to wake
> up and set the trust status value on in the task control structure,
> after the event is modeled. As was noted above, the PID value is the
> unmapped value maintained by the OS.
>
> Lets see if we can reason through why the PID can be used safely.
>
> CAP_TRUST, or whatever ends up getting used, is required by the trust
> orchestrator to create a security/modeling namespace for the workload
> being modeled. This results in the creation of the following
> pseudo-file for surfacing the security event descriptions for the
> namespace/workload:
>
> /sys/fs/tsem/ExternalTMA/N
>
> Where N is the id number of the modeling domain.
>
> CAP_TRUST, caveats applied, is required to open the pseudo-file. The
> trust orchestrator only receives and acts on PID values through this
> conduit from the kernel.
>
> When an event description is exported, the trust status of the task is
> set to 'pending' and the process is placed in interruptible sleep and
> scheduled away, with the 'wakeup' criteria being the trust status
> being changed from pending to either trusted or untrusted.
>
> The only path to change the trust status value in the LSM task control
> structure and wake up the process is by the trust orchestrator that
> created the namespace, by writing the appropriate value to the
> /sys/fs/tsem/control file. Access to that file is gated by CAP_TRUST
> or its equivalent.
>
> See the following code locations for further details:
>
> security/tsem/export.c:tsem_export_event()
>
> security/tsem/fs.c:control_COE()
>
> As long as the process 'exists', albeit sleeping, the PID slot is
> occupied and an adversary, regardless of namespace, cannot substitute
> a task with the same PID value.
>
> This leaves an adversary with the need to terminate the task being
> modeled in order to capture its PID slot.
>
> Precautions are implemented in the following function to protect the
> process from being terminated by an adversary:
>
> security/tsem/tsem.c:tsem_task_kill()
>
> The following is a summary of the criteria that is implemented:
>
> - Signal privileges are granted to any process with CAP_TRUST.
>
> - A process without CAP_TRUST cannot signal a process with CAP_TRUST.
>
> - Cross-model signaling is denied by a process without CAP_TRUST.
>
> So that leaves us in a scenario where, outside of the modeling
> namespace, CAP_TRUST would be required to kill the process waiting to
> be modeled. If CAP_TRUST has been lost to an adversary, the platform
> is owned and the game is over.
>
> So that leaves us with the threat of an adversary attempting to
> implement a PID race within the modeling domain itself.
>
> As I've noted previously in these threads, and in the LSM
> documentation proper, TSEM is about prospective generation of a
> security model, rather than retrospective correction of a MAC policy
> that has been demonstrated to have undesired effects. The distinction
> is important in this case.
>
> For an adversary to mount a PID race attack from within the modeled
> workload, one of three conditions must be met:
>
> - A shell script is read.
>
> - A malicious binary would have to be executed.
>
> - Memory would have had to have been mapped executable.
>
> Since TSEM captures the security events needed to implement these
> actions, the events would have had to have been incorporated into the
> security unit test for the workload or the actions would be denied.
>
> Hopefully this analysis is complete and correct with respect to this
> threat, comments and observations are obviously welcome.
>
> There is an opportunity to strengthen this model that I will touch on
> below.
>
> > > + state HEXID:
> > > + The state keyword is used to indicate that the
> > > + security state point identified by the ASCII
> > > + base 16 encoded value should be loaded into
> > > + the current security model as a valid security
> > > + event state.
> > > +
> > > + pseudonym HEXID
> > > + The pseudonym keyword is used to indicate that
> > > + the pathname, identified by the 256 bit ASCII
> > > + base 16 encoded value HEXID, should be
> > > + designated to return a constant digest value
> > > + for the contents of the file.
> > > +
> > > + The HEXID value is computed with the following
> > > + function:
> > > +
> > > + HEXID = SHA256(PATHNAME_LENGTH || PATHNAME)
> > This seems like an unusual design choice, and perhaps one born from
> > necessity ... ? It's nice that it is opt-in, but I would be curious
> > to hear what problems this solved.
>
> It is an approximation method that allows things like log files and
> .bash_history files to be effectively modeled.
>
> Once again, TSEM is a blending of integrity measurement and mandatory
> access controls. In a security event that has a file as a component
> of its CELL, the SHA256 digest value of the file is included in the
> computation of the CELL identity.
>
> These types of files have no known 'good' value, by definition. So
> 'pseudonym' declarations implement a model approximation to provide a
> fixed digest value for a file, regardless of its contents.
>
> The effect of this can easily be seen if one of the Quixote trust
> orchestrators is used to run a container based shell workload. If the
> .bash_history file in the container is not zeroed before execution, or
> treated as a pseudonym, the bash shell will be tagged and 'poisoned'
> as untrusted when it reads the file.
>
> It is a pretty solid understanding in modeling theory that
> approximations are almost universally required when dealing with
> physical phenomenon. As a quantum chemist by training, I spent a fair
> amount of time dealing with complete, intermediate and modified
> neglect of diatomic overlap as a result of this.... :-)
>
> > > + base HEXID
> > > + The base keyword is used to indicate that the
> > > + 256 bit ASCII base 16 encoded value HEXID
> > > + should be registered as the value used to
> > > + generate model specific security event points.
> > > +
> > > + A model specific base value is designed to be
> > > + used as a 'freshness' nonce, similar to an
> > > + attestation nonce, to prove that a model state
> > > + value or measurement is current and not being
> > > + replayed.
> > > diff --git a/Documentation/admin-guide/LSM/tsem.rst b/Documentation/admin-guide/LSM/tsem.rst
> > > new file mode 100644
> > > index 000000000000..f03e5269cd25
> > > --- /dev/null
> > > +++ b/Documentation/admin-guide/LSM/tsem.rst
> > > @@ -0,0 +1,1240 @@
> > > +====
> > > +TSEM
> > > +====
> >
> > ...
> >
> > > +Process and Platform Trust Status
> > > +=================================
> > > +
> > > +A fundamental concept in TSEM is the notion of providing a precise
> > > +definition for what it means for a platform or workload to be trusted.
> > > +A trusted platform or workload is one where there has not been an
> > > +attempt by a process to execute a security relevant event that does
> > > +not map into a known security state point.
> > > +
> > > +The process trust status is a characteristic of the process that is
> > > +passed to any subordinate processes that are descendants of that
> > > +process. Once a process is tagged as untrusted, that characteristic
> > > +cannot be removed from the process. In a 'fruit from the poisoned
> > > +vine' paradigm, all subordinate processes created by an untrusted
> > > +process are untrusted as well.
> > > +
> > > +On entry into each TSEM security event handler, the trust status of a
> > > +process is checked before an attempt to model the event is made. An
> > > +attempt to execute a security event by an untrusted process will cause
> > > +the event, and its characteristics, to be logged. The return status
> > > +of the hook will be determined by the enforcement state of the model.
> > > +A permission denial is only returned if the TMA is running in
> > > +enforcing mode.
> > > +
> > > +If the platform running the TSEM LSM has a TPM, the hardware aggregate
> > > +value is computed at the time that TSEM is initialized. This hardware
> > > +aggregate value is the linear extension sum over Platform
> > > +Configuration Registers (PCR's) 0 through 7. This is the same
> > > +aggregate value that is computed by the Integrity Measurement
> > > +Architecture (IMA) and is the industry standard method of providing an
> > > +evaluation measurement of the hardware platform state.
> > > +
> > > +Internally model domains have the hardware aggregate measurement
> > > +included as the first state point in the security model. Externally
> > > +modeled domains export the hardware aggregate value to the TMA for
> > > +inclusion as the first state point of the model maintained by the TMA.
> > > +
> > > +The root modeling domain extends each security state point into PCR
> > > +11. This allows hardware based TSEM measurements to coexist with IMA
> > > +measurement values. This hardware measurement value can be used to
> > > +attest to the security execution trajectory that the root model
> > > +maintains.
> > It seems like making the target PCR configurable would be a good
> > idea, at the very least make it a Kconfig option.
>
> That was something that we have thought about, it probably needs a
> Kconfig option.
>
> Contrary to all appearances, as a team we are really minimalists at
> heart and tend to not make things more complex or configurable than
> needed.... :-)
>
> > Also, can you elaborate on how the security state points are
> > extended into the PCR? I imagine for it to be useful at an
> > arbitrary point in time this would require the PCR to be extended as
> > the security points were generated, which would imply that the PCR
> > value would be dependent on execution order, and in most cases,
> > scheduling order as well. How useful do you expect this to be for
> > most users?
>
> Your assessment is correct, the state points are extended into the PCR
> whenever a unique security state point is generated.
>
> In a 'free-running' model, the value in the register will be fungible
> due to scheduling dependencies.
>
> If the model is pre-defined, the security state points will be
> extended into the register as they are loaded through the
> /sys/fs/tsem/map pseudo-file interface. In this case, the value will
> be fixed and any departure from the value would signal that the
> modeling domain has departed from its specification.
>
> With respect to the utility of the value, in a 'free-running' model it
> is about as useful as the value that IMA maintains in PCR 10, which in
> our opinion is not very useful and is why we implemented the notion of
> the 'state' value of a model.
>
> The primary utility of the value is that it is a hardware maintained
> reference value that can be used to confirm the set of measurements
> committed to the register.
>
> So our 'state' value gives us a constant 'good' value for the security
> model. The PCR 11 value provides a hardware root of trust for the set
> of points that lead to the state value.
>
> > > +Internal vs external modeling
> > > +-----------------------------
> > > +
> > > +When a TSEM modeling domain is created, a designation is made as to
> > > +whether the domain is to be internally or externally modeled.
> > > +
> > > +In an internally modeled domain, the security event handlers pass the
> > > +event type and its characteristics to the designated internal trusted
> > > +modeling agent. The agent provides the permission value for the
> > > +security event handler to return as the result of the event and sets
> > > +the trust status of the process executing the event.
> > > +
> > > +In an externally modeled domain, the event type and parameters are
> > > +exported to userspace for processing by a trust orchestrator with an
> > > +associated TMA. The trust orchestrator communicates the result of the
> > > +modeling back to the kernel to support the setting of the process
> > > +trust status.
> > > +
> > > +This model poses a limitation to the ability of TSEM to model some
> > > +security events. This is secondary to the fact that some event
> > > +handlers (LSM hooks) are called from a non-sleeping context, as a
> > > +result the process cannot be scheduled. This is particularly the case
> > > +with the task based hooks, since they are typically called with the
> > > +tasklist lock held.
> > > +
> > > +This limitation is also inherent to the root model that extends the
> > > +security state points into TPM PCR 11, secondary to the fact that the
> > > +process invoking the security event hook will be scheduled away while
> > > +the TPM transaction completes.
> > > +
> > > +Addressing this problem directly requires a consideration of the
> > > +context from which the security event handlers are being called.
> > > +Subsequent implementations of TSEM will include a mechanism for
> > > +asynchronous deferral of model processing, until when and if, a review
> > > +of the call context would be considered worthwhile by the LSM
> > > +community.
> > This is a pretty big limitation, and in conjunction with the some of
> > the other issues brought up earlier (the PID issue seems the most
> > concerning), I'm having a difficult time believeing that an external
> > modeler could operate safely given the design presented here.
>
> With respect to the PID issue, we would welcome any comments on the
> analysis that we provided above as to its design safety.
>
> If the PID issue remains a concern, we have an extension to the export
> descriptions that would include a random nonce that would be emitted
> with the PID. The nonce would be placed in the LSM task control
> 'blob' for the sleeping task and used to confirm that the task release
> directive was acting on the correct process.
>
> > Unfortunately, there will always be LSM hooks which need to operate
> > in a non-blocking context, meaning this challenge is here to stay.
> > Help me understand how you could safely do asynchronous policy
> > enforcement with an external modeler, I'm not sure it's possible.
>
> Electing to implement asynchronous enforcement would require further
> thought. We were operating in the context of full disclosure in our
> documentation and wanted to be up front about limitations and options.
>
> To be clear, at this time, we are not advocating for or bringing
> forward an asynchronous update architecture.
>
> So, at this time, there is a well understood modeling limitation with
> respect to the LSM hook implementations. That limitation is not
> limited to external TMA's, since the event state points cannot be
> extended into a TPM in a non-blocking context.
>
> So far we have only run into a handful of these events, almost
> exclusively due to the LSM hooks being called with the tasklist lock
> held. I see that Linus commented a couple of weeks ago that the
> tasklist lock is our last big lock that may need to be looked at.
>
> With respect to the need for external modeling, as is the case with
> all security designs, this is a cost/benefit decision.
>
> In some cases, for example SGX, using external modeling is the only
> option, since executing in the context of an SGX enclave is not
> possible from the kernel. Quixote/TSEM is actually one of the unsung
> 'killer' applications for SGX, at least from our long involvement with
> the technology.
>
> Having an external modeling option also means that you don't need to
> get code into the kernel proper in order to implement a security model
> that may be useful. I think we all can appreciate the utility and
> importance of that.
>
> We believe that the ability to do dedicated hardware security
> co-processors is important. External modeling opens the door to
> democratize how that can be done.
>
> The binary Quixote distribution includes firmware for an
> NRF52840-DONGLE implementation of a TMA. So you have a clear
> demonstration of the opportunity to create 'Yubikey' type devices to
> enforce kernel security.
>
> A reasonably interesting option for entities distributing dedicated
> Linux based devices, where for a few dollars you can include a USB
> based co-processor that would provide hardware based protections to
> prevent an embedded Linux implementation from being diverted from its
> design intent.
>
> Truth be told, after having looked at countless execution
> trajectories, processes are typically locked into untrusted status
> before they get to any of the non-blocking hooks.
>
> > Frankly, I also wonder how a system would perform with an external
> > modeler, indepdent of the issues with non-blocking hooks. How does
> > the system perform with every blockable LSM hook invocation
> > potentially blocking on a response from userspace? Or with the COE
> > being somewhat coarse, does the trajectory/policy populate itself
> > quickly?
>
> One obviously experiences a latency hit in going to userspace, by
> definition, implementing security always has an associated resource
> cost. So, once again, this comes down to a cost/benefit analysis.
>
> As a Gedanken exercise, consider the value proposition of a Linux
> based RTU, or other device, controlling infrastructure that can only
> execute security relevant events that are guaranteed to be known good
> by an external co-processor that is only accessible as a security
> oracle.
>
> Given that frame of reference.
>
> Time for a userspace or SGX based TMA transaction is running around
> 890 micro-seconds.
>
> Going to a TMA based in a Xen stubdomain implementation runs a bit
> longer, probably around 940 micro-seconds or so.
>
> The micro-controller implementations are decidedly slower, with the
> NRF52840-DONGLE clocking in at around 40 micro-seconds, but that is
> strictly a CPU horsepower issue.
>
> All of this with the caveat that we have been focusing almost
> exclusively on correctness and not optimizing performance.
>
> We've thought a bit, mainly on long walks with our Golden Retriever
> Izzy, about the issue of building a kernel based policy cache with
> externally modeled domains. Given that the kernel does not, a-priori,
> know what modeling algorithm a TMA might be using, we would need to
> come up with a method of deterministically mapping a security event
> description to a known good state point value.
>
> The other issue with all this is that with containerized workloads,
> particularly micro-services, the rate of security event generation can
> be surprisingly low. Obviously this is also the case with embedded
> implementations.
>
> Once again, what are you willing to pay to be safe?
>
> > > +Event handlers that cannot be directly modeled, still consider, on
> > > +entry, whether or not they are being called by an trusted or untrusted
> > > +process. As a result, an untrusted process will cause a non-modeled
> > > +event to return a permissions violation in enforcing mode, even if the
> > > +security event cannot be directly modeled.
> > > +
> > > +Security event modeling typically traps violations of trust by a COE
> > > +with unmodeled characteristics that is attempting to access/execute a
> > > +file or map memory as executable; or by a COE with known
> > > +characteristics attempting to access or execute a CELL not prescribed
> > > +by a model. As a result, the impact of the ability to not directly
> > > +model these events is lessened.
> >
> > ...
> >
> > > +Event modeling
> > > +--------------
> > > +
> > > +TSEM security event modeling is based on the following functional
> > > +definition for a security state point:
> > > +
> > > +Sp = SHA256(SHA256(EVENT_ID) || TASK_ID || SHA256(COE) || SHA256(CELL))
> > It appears that all of the hasing in TSEM is SHA256 based, you might
> > want to consider making that a Kconfig option at the very least.
>
> That has been something that we have talked about as well.
>
> As I indicated previously, we really are minimalists, particularly
> after watching IMA fight with issues surrounding algorithmic agility.
>
> It would be easy enough to make this configurable but does anyone see
> SHA256 as not being useful in in this role anywhere in the next 10
> years?
>
> > paul-moore.com
>
> Hopefully all of this is useful moving forward.
>
> Have a good day.
>
> As always,
> Dr. Greg
>
> The Quixote Project - Flailing at the Travails of Cybersecurity
More information about the Linux-security-module-archive
mailing list