linux-stable/Documentation/security
David Howells 7743c48e54 keys: Cache result of request_key*() temporarily in task_struct
If a filesystem uses keys to hold authentication tokens, then it needs a
token for each VFS operation that might perform an authentication check -
either by passing it to the server, or using to perform a check based on
authentication data cached locally.

For open files this isn't a problem, since the key should be cached in the
file struct since it represents the subject performing operations on that
file descriptor.

During pathwalk, however, there isn't anywhere to cache the key, except
perhaps in the nameidata struct - but that isn't exposed to the
filesystems.  Further, a pathwalk can incur a lot of operations, calling
one or more of the following, for instance:

	->lookup()
	->permission()
	->d_revalidate()
	->d_automount()
	->get_acl()
	->getxattr()

on each dentry/inode it encounters - and each one may need to call
request_key().  And then, at the end of pathwalk, it will call the actual
operation:

	->mkdir()
	->mknod()
	->getattr()
	->open()
	...

which may need to go and get the token again.

However, it is very likely that all of the operations on a single
dentry/inode - and quite possibly a sequence of them - will all want to use
the same authentication token, which suggests that caching it would be a
good idea.

To this end:

 (1) Make it so that a positive result of request_key() and co. that didn't
     require upcalling to userspace is cached temporarily in task_struct.

 (2) The cache is 1 deep, so a new result displaces the old one.

 (3) The key is released by exit and by notify-resume.

 (4) The cache is cleared in a newly forked process.

Signed-off-by: David Howells <dhowells@redhat.com>
2019-06-19 16:10:15 +01:00
..
keys keys: Cache result of request_key*() temporarily in task_struct 2019-06-19 16:10:15 +01:00
tpm tpm: move documentation under Documentation/security 2016-11-07 18:56:42 -07:00
credentials.rst Documentation: Use "while" instead of "whilst" 2018-11-20 09:30:43 -07:00
IMA-templates.rst doc: ReSTify IMA-templates.txt 2017-05-18 10:30:14 -06:00
index.rst doc: sctp: Merge and clean up rst files 2019-02-22 08:51:40 -07:00
LSM.rst doc: security: Add kern-doc for lsm_hooks.h 2019-02-22 08:54:09 -07:00
SCTP.rst doc: sctp: Merge and clean up rst files 2019-02-22 08:51:40 -07:00
self-protection.rst doc: self-protection: Add information about STACKLEAK feature 2018-09-04 10:35:48 -07:00