ima_policy 2.5 KB
Newer Older
Mimi Zohar's avatar
Mimi Zohar committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14
What:		security/ima/policy
Date:		May 2008
Contact:	Mimi Zohar <zohar@us.ibm.com>
Description:
		The Trusted Computing Group(TCG) runtime Integrity
		Measurement Architecture(IMA) maintains a list of hash
		values of executables and other sensitive system files
		loaded into the run-time of this system.  At runtime,
		the policy can be constrained based on LSM specific data.
		Policies are loaded into the securityfs file ima/policy
		by opening the file, writing the rules one at a time and
		then closing the file.  The new policy takes effect after
		the file ima/policy is closed.

15 16 17
		IMA appraisal, if configured, uses these file measurements
		for local measurement appraisal.

Mimi Zohar's avatar
Mimi Zohar committed
18 19
		rule format: action [condition ...]

Peter Moody's avatar
Peter Moody committed
20
		action: measure | dont_measure | appraise | dont_appraise | audit
Mimi Zohar's avatar
Mimi Zohar committed
21
		condition:= base | lsm
22
			base:	[[func=] [mask=] [fsmagic=] [uid=] [fowner]]
Mimi Zohar's avatar
Mimi Zohar committed
23 24 25
			lsm:	[[subj_user=] [subj_role=] [subj_type=]
				 [obj_user=] [obj_role=] [obj_type=]]

26
		base: 	func:= [BPRM_CHECK][FILE_MMAP][FILE_CHECK]
Mimi Zohar's avatar
Mimi Zohar committed
27 28 29
			mask:= [MAY_READ] [MAY_WRITE] [MAY_APPEND] [MAY_EXEC]
			fsmagic:= hex value
			uid:= decimal value
30
			fowner:=decimal value
Mimi Zohar's avatar
Mimi Zohar committed
31 32 33 34 35
		lsm:  	are LSM specific

		default policy:
			# PROC_SUPER_MAGIC
			dont_measure fsmagic=0x9fa0
36
			dont_appraise fsmagic=0x9fa0
Mimi Zohar's avatar
Mimi Zohar committed
37 38
			# SYSFS_MAGIC
			dont_measure fsmagic=0x62656572
39
			dont_appraise fsmagic=0x62656572
Mimi Zohar's avatar
Mimi Zohar committed
40 41
			# DEBUGFS_MAGIC
			dont_measure fsmagic=0x64626720
42
			dont_appraise fsmagic=0x64626720
Mimi Zohar's avatar
Mimi Zohar committed
43 44
			# TMPFS_MAGIC
			dont_measure fsmagic=0x01021994
45 46 47 48
			dont_appraise fsmagic=0x01021994
			# RAMFS_MAGIC
			dont_measure fsmagic=0x858458f6
			dont_appraise fsmagic=0x858458f6
Mimi Zohar's avatar
Mimi Zohar committed
49 50
			# SECURITYFS_MAGIC
			dont_measure fsmagic=0x73636673
51
			dont_appraise fsmagic=0x73636673
Mimi Zohar's avatar
Mimi Zohar committed
52 53 54

			measure func=BPRM_CHECK
			measure func=FILE_MMAP mask=MAY_EXEC
55
			measure func=FILE_CHECK mask=MAY_READ uid=0
56
			appraise fowner=0
Mimi Zohar's avatar
Mimi Zohar committed
57 58 59

		The default policy measures all executables in bprm_check,
		all files mmapped executable in file_mmap, and all files
60 61
		open for read by root in do_filp_open.  The default appraisal
		policy appraises all files owned by root.
Mimi Zohar's avatar
Mimi Zohar committed
62 63 64 65 66

		Examples of LSM specific definitions:

		SELinux:
			# SELINUX_MAGIC
67 68
			dont_measure fsmagic=0xf97cff8c
			dont_appraise fsmagic=0xf97cff8c
Mimi Zohar's avatar
Mimi Zohar committed
69 70

			dont_measure obj_type=var_log_t
71
			dont_appraise obj_type=var_log_t
Mimi Zohar's avatar
Mimi Zohar committed
72
			dont_measure obj_type=auditd_log_t
73
			dont_appraise obj_type=auditd_log_t
74 75
			measure subj_user=system_u func=FILE_CHECK mask=MAY_READ
			measure subj_role=system_r func=FILE_CHECK mask=MAY_READ
Mimi Zohar's avatar
Mimi Zohar committed
76 77

		Smack:
78
			measure subj_user=_ func=FILE_CHECK mask=MAY_READ