Linux Audio

Check our new training course

Loading...
v5.4
  1/* SPDX-License-Identifier: GPL-2.0-only */
  2/*
  3 * Copyright (C) 2009-2010 IBM Corporation
  4 *
  5 * Authors:
  6 * Mimi Zohar <zohar@us.ibm.com>
  7 */
  8
 
 
 
 
 
 
  9#include <linux/types.h>
 10#include <linux/integrity.h>
 11#include <crypto/sha.h>
 
 12#include <linux/key.h>
 13#include <linux/audit.h>
 14
 15/* iint action cache flags */
 16#define IMA_MEASURE		0x00000001
 17#define IMA_MEASURED		0x00000002
 18#define IMA_APPRAISE		0x00000004
 19#define IMA_APPRAISED		0x00000008
 20/*#define IMA_COLLECT		0x00000010  do not use this flag */
 21#define IMA_COLLECTED		0x00000020
 22#define IMA_AUDIT		0x00000040
 23#define IMA_AUDITED		0x00000080
 24#define IMA_HASH		0x00000100
 25#define IMA_HASHED		0x00000200
 26
 27/* iint cache flags */
 28#define IMA_ACTION_FLAGS	0xff000000
 29#define IMA_DIGSIG_REQUIRED	0x01000000
 30#define IMA_PERMIT_DIRECTIO	0x02000000
 31#define IMA_NEW_FILE		0x04000000
 32#define EVM_IMMUTABLE_DIGSIG	0x08000000
 33#define IMA_FAIL_UNVERIFIABLE_SIGS	0x10000000
 34#define IMA_MODSIG_ALLOWED	0x20000000
 35
 36#define IMA_DO_MASK		(IMA_MEASURE | IMA_APPRAISE | IMA_AUDIT | \
 37				 IMA_HASH | IMA_APPRAISE_SUBMASK)
 38#define IMA_DONE_MASK		(IMA_MEASURED | IMA_APPRAISED | IMA_AUDITED | \
 39				 IMA_HASHED | IMA_COLLECTED | \
 40				 IMA_APPRAISED_SUBMASK)
 41
 42/* iint subaction appraise cache flags */
 43#define IMA_FILE_APPRAISE	0x00001000
 44#define IMA_FILE_APPRAISED	0x00002000
 45#define IMA_MMAP_APPRAISE	0x00004000
 46#define IMA_MMAP_APPRAISED	0x00008000
 47#define IMA_BPRM_APPRAISE	0x00010000
 48#define IMA_BPRM_APPRAISED	0x00020000
 49#define IMA_READ_APPRAISE	0x00040000
 50#define IMA_READ_APPRAISED	0x00080000
 51#define IMA_CREDS_APPRAISE	0x00100000
 52#define IMA_CREDS_APPRAISED	0x00200000
 53#define IMA_APPRAISE_SUBMASK	(IMA_FILE_APPRAISE | IMA_MMAP_APPRAISE | \
 54				 IMA_BPRM_APPRAISE | IMA_READ_APPRAISE | \
 55				 IMA_CREDS_APPRAISE)
 56#define IMA_APPRAISED_SUBMASK	(IMA_FILE_APPRAISED | IMA_MMAP_APPRAISED | \
 57				 IMA_BPRM_APPRAISED | IMA_READ_APPRAISED | \
 58				 IMA_CREDS_APPRAISED)
 59
 60/* iint cache atomic_flags */
 61#define IMA_CHANGE_XATTR	0
 62#define IMA_UPDATE_XATTR	1
 63#define IMA_CHANGE_ATTR		2
 64#define IMA_DIGSIG		3
 65#define IMA_MUST_MEASURE	4
 66
 67enum evm_ima_xattr_type {
 68	IMA_XATTR_DIGEST = 0x01,
 69	EVM_XATTR_HMAC,
 70	EVM_IMA_XATTR_DIGSIG,
 71	IMA_XATTR_DIGEST_NG,
 72	EVM_XATTR_PORTABLE_DIGSIG,
 
 73	IMA_XATTR_LAST
 74};
 75
 76struct evm_ima_xattr_data {
 77	u8 type;
 
 
 
 78	u8 data[];
 79} __packed;
 
 
 80
 81/* Only used in the EVM HMAC code. */
 82struct evm_xattr {
 83	struct evm_ima_xattr_data data;
 84	u8 digest[SHA1_DIGEST_SIZE];
 85} __packed;
 86
 87#define IMA_MAX_DIGEST_SIZE	64
 88
 89struct ima_digest_data {
 
 
 90	u8 algo;
 91	u8 length;
 92	union {
 93		struct {
 94			u8 unused;
 95			u8 type;
 96		} sha1;
 97		struct {
 98			u8 type;
 99			u8 algo;
100		} ng;
101		u8 data[2];
102	} xattr;
103	u8 digest[0];
 
104} __packed;
 
 
105
106/*
107 * signature format v2 - for using with asymmetric keys
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
108 */
109struct signature_v2_hdr {
110	uint8_t type;		/* xattr type */
111	uint8_t version;	/* signature format version */
112	uint8_t	hash_algo;	/* Digest algorithm [enum hash_algo] */
113	__be32 keyid;		/* IMA key identifier - not X509/PGP specific */
114	__be16 sig_size;	/* signature size */
115	uint8_t sig[0];		/* signature payload */
116} __packed;
117
118/* integrity data associated with an inode */
119struct integrity_iint_cache {
120	struct rb_node rb_node;	/* rooted in integrity_iint_tree */
121	struct mutex mutex;	/* protects: version, flags, digest */
122	struct inode *inode;	/* back pointer to inode in question */
123	u64 version;		/* track inode changes */
124	unsigned long flags;
125	unsigned long measured_pcrs;
126	unsigned long atomic_flags;
127	enum integrity_status ima_file_status:4;
128	enum integrity_status ima_mmap_status:4;
129	enum integrity_status ima_bprm_status:4;
130	enum integrity_status ima_read_status:4;
131	enum integrity_status ima_creds_status:4;
132	enum integrity_status evm_status:4;
133	struct ima_digest_data *ima_hash;
134};
135
136/* rbtree tree calls to lookup, insert, delete
137 * integrity data associated with an inode.
138 */
139struct integrity_iint_cache *integrity_iint_find(struct inode *inode);
 
 
 
 
140
141int integrity_kernel_read(struct file *file, loff_t offset,
142			  void *addr, unsigned long count);
143
144#define INTEGRITY_KEYRING_EVM		0
145#define INTEGRITY_KEYRING_IMA		1
146#define INTEGRITY_KEYRING_PLATFORM	2
147#define INTEGRITY_KEYRING_MAX		3
 
148
149extern struct dentry *integrity_dir;
150
151struct modsig;
152
153#ifdef CONFIG_INTEGRITY_SIGNATURE
154
155int integrity_digsig_verify(const unsigned int id, const char *sig, int siglen,
156			    const char *digest, int digestlen);
157int integrity_modsig_verify(unsigned int id, const struct modsig *modsig);
158
159int __init integrity_init_keyring(const unsigned int id);
160int __init integrity_load_x509(const unsigned int id, const char *path);
161int __init integrity_load_cert(const unsigned int id, const char *source,
162			       const void *data, size_t len, key_perm_t perm);
163#else
164
165static inline int integrity_digsig_verify(const unsigned int id,
166					  const char *sig, int siglen,
167					  const char *digest, int digestlen)
168{
169	return -EOPNOTSUPP;
170}
171
172static inline int integrity_modsig_verify(unsigned int id,
173					  const struct modsig *modsig)
174{
175	return -EOPNOTSUPP;
176}
177
178static inline int integrity_init_keyring(const unsigned int id)
179{
180	return 0;
181}
182
183static inline int __init integrity_load_cert(const unsigned int id,
184					     const char *source,
185					     const void *data, size_t len,
186					     key_perm_t perm)
187{
188	return 0;
189}
190#endif /* CONFIG_INTEGRITY_SIGNATURE */
191
192#ifdef CONFIG_INTEGRITY_ASYMMETRIC_KEYS
193int asymmetric_verify(struct key *keyring, const char *sig,
194		      int siglen, const char *data, int datalen);
195#else
196static inline int asymmetric_verify(struct key *keyring, const char *sig,
197				    int siglen, const char *data, int datalen)
198{
199	return -EOPNOTSUPP;
200}
201#endif
202
203#ifdef CONFIG_IMA_APPRAISE_MODSIG
204int ima_modsig_verify(struct key *keyring, const struct modsig *modsig);
205#else
206static inline int ima_modsig_verify(struct key *keyring,
207				    const struct modsig *modsig)
208{
209	return -EOPNOTSUPP;
210}
211#endif
212
213#ifdef CONFIG_IMA_LOAD_X509
214void __init ima_load_x509(void);
215#else
216static inline void ima_load_x509(void)
217{
218}
219#endif
220
221#ifdef CONFIG_EVM_LOAD_X509
222void __init evm_load_x509(void);
223#else
224static inline void evm_load_x509(void)
225{
226}
227#endif
228
229#ifdef CONFIG_INTEGRITY_AUDIT
230/* declarations */
231void integrity_audit_msg(int audit_msgno, struct inode *inode,
232			 const unsigned char *fname, const char *op,
233			 const char *cause, int result, int info);
234
 
 
 
 
 
235static inline struct audit_buffer *
236integrity_audit_log_start(struct audit_context *ctx, gfp_t gfp_mask, int type)
237{
238	return audit_log_start(ctx, gfp_mask, type);
239}
240
241#else
242static inline void integrity_audit_msg(int audit_msgno, struct inode *inode,
243				       const unsigned char *fname,
244				       const char *op, const char *cause,
245				       int result, int info)
246{
247}
248
 
 
 
 
 
 
 
 
249static inline struct audit_buffer *
250integrity_audit_log_start(struct audit_context *ctx, gfp_t gfp_mask, int type)
251{
252	return NULL;
253}
254
255#endif
256
257#ifdef CONFIG_INTEGRITY_PLATFORM_KEYRING
258void __init add_to_platform_keyring(const char *source, const void *data,
259				    size_t len);
260#else
261static inline void __init add_to_platform_keyring(const char *source,
262						  const void *data, size_t len)
263{
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
264}
265#endif
v6.13.7
  1/* SPDX-License-Identifier: GPL-2.0-only */
  2/*
  3 * Copyright (C) 2009-2010 IBM Corporation
  4 *
  5 * Authors:
  6 * Mimi Zohar <zohar@us.ibm.com>
  7 */
  8
  9#ifdef pr_fmt
 10#undef pr_fmt
 11#endif
 12
 13#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
 14
 15#include <linux/types.h>
 16#include <linux/integrity.h>
 17#include <crypto/sha1.h>
 18#include <crypto/hash.h>
 19#include <linux/key.h>
 20#include <linux/audit.h>
 21#include <linux/lsm_hooks.h>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 22
 23enum evm_ima_xattr_type {
 24	IMA_XATTR_DIGEST = 0x01,
 25	EVM_XATTR_HMAC,
 26	EVM_IMA_XATTR_DIGSIG,
 27	IMA_XATTR_DIGEST_NG,
 28	EVM_XATTR_PORTABLE_DIGSIG,
 29	IMA_VERITY_DIGSIG,
 30	IMA_XATTR_LAST
 31};
 32
 33struct evm_ima_xattr_data {
 34	/* New members must be added within the __struct_group() macro below. */
 35	__struct_group(evm_ima_xattr_data_hdr, hdr, __packed,
 36		u8 type;
 37	);
 38	u8 data[];
 39} __packed;
 40static_assert(offsetof(struct evm_ima_xattr_data, data) == sizeof(struct evm_ima_xattr_data_hdr),
 41	      "struct member likely outside of __struct_group()");
 42
 43/* Only used in the EVM HMAC code. */
 44struct evm_xattr {
 45	struct evm_ima_xattr_data_hdr data;
 46	u8 digest[SHA1_DIGEST_SIZE];
 47} __packed;
 48
 49#define IMA_MAX_DIGEST_SIZE	HASH_MAX_DIGESTSIZE
 50
 51struct ima_digest_data {
 52	/* New members must be added within the __struct_group() macro below. */
 53	__struct_group(ima_digest_data_hdr, hdr, __packed,
 54	u8 algo;
 55	u8 length;
 56	union {
 57		struct {
 58			u8 unused;
 59			u8 type;
 60		} sha1;
 61		struct {
 62			u8 type;
 63			u8 algo;
 64		} ng;
 65		u8 data[2];
 66	} xattr;
 67	);
 68	u8 digest[];
 69} __packed;
 70static_assert(offsetof(struct ima_digest_data, digest) == sizeof(struct ima_digest_data_hdr),
 71	      "struct member likely outside of __struct_group()");
 72
 73/*
 74 * Instead of wrapping the ima_digest_data struct inside a local structure
 75 * with the maximum hash size, define ima_max_digest_data struct.
 76 */
 77struct ima_max_digest_data {
 78	struct ima_digest_data_hdr hdr;
 79	u8 digest[HASH_MAX_DIGESTSIZE];
 80} __packed;
 81
 82/*
 83 * signature header format v2 - for using with asymmetric keys
 84 *
 85 * The signature_v2_hdr struct includes a signature format version
 86 * to simplify defining new signature formats.
 87 *
 88 * signature format:
 89 * version 2: regular file data hash based signature
 90 * version 3: struct ima_file_id data based signature
 91 */
 92struct signature_v2_hdr {
 93	uint8_t type;		/* xattr type */
 94	uint8_t version;	/* signature format version */
 95	uint8_t	hash_algo;	/* Digest algorithm [enum hash_algo] */
 96	__be32 keyid;		/* IMA key identifier - not X509/PGP specific */
 97	__be16 sig_size;	/* signature size */
 98	uint8_t sig[];		/* signature payload */
 99} __packed;
100
101/*
102 * IMA signature version 3 disambiguates the data that is signed, by
103 * indirectly signing the hash of the ima_file_id structure data,
104 * containing either the fsverity_descriptor struct digest or, in the
105 * future, the regular IMA file hash.
106 *
107 * (The hash of the ima_file_id structure is only of the portion used.)
 
 
 
 
 
 
 
 
 
 
 
 
 
108 */
109struct ima_file_id {
110	__u8 hash_type;		/* xattr type [enum evm_ima_xattr_type] */
111	__u8 hash_algorithm;	/* Digest algorithm [enum hash_algo] */
112	__u8 hash[HASH_MAX_DIGESTSIZE];
113} __packed;
114
115int integrity_kernel_read(struct file *file, loff_t offset,
116			  void *addr, unsigned long count);
117
118#define INTEGRITY_KEYRING_EVM		0
119#define INTEGRITY_KEYRING_IMA		1
120#define INTEGRITY_KEYRING_PLATFORM	2
121#define INTEGRITY_KEYRING_MACHINE	3
122#define INTEGRITY_KEYRING_MAX		4
123
124extern struct dentry *integrity_dir;
125
126struct modsig;
127
128#ifdef CONFIG_INTEGRITY_SIGNATURE
129
130int integrity_digsig_verify(const unsigned int id, const char *sig, int siglen,
131			    const char *digest, int digestlen);
132int integrity_modsig_verify(unsigned int id, const struct modsig *modsig);
133
134int __init integrity_init_keyring(const unsigned int id);
135int __init integrity_load_x509(const unsigned int id, const char *path);
136int __init integrity_load_cert(const unsigned int id, const char *source,
137			       const void *data, size_t len, key_perm_t perm);
138#else
139
140static inline int integrity_digsig_verify(const unsigned int id,
141					  const char *sig, int siglen,
142					  const char *digest, int digestlen)
143{
144	return -EOPNOTSUPP;
145}
146
147static inline int integrity_modsig_verify(unsigned int id,
148					  const struct modsig *modsig)
149{
150	return -EOPNOTSUPP;
151}
152
153static inline int integrity_init_keyring(const unsigned int id)
154{
155	return 0;
156}
157
158static inline int __init integrity_load_cert(const unsigned int id,
159					     const char *source,
160					     const void *data, size_t len,
161					     key_perm_t perm)
162{
163	return 0;
164}
165#endif /* CONFIG_INTEGRITY_SIGNATURE */
166
167#ifdef CONFIG_INTEGRITY_ASYMMETRIC_KEYS
168int asymmetric_verify(struct key *keyring, const char *sig,
169		      int siglen, const char *data, int datalen);
170#else
171static inline int asymmetric_verify(struct key *keyring, const char *sig,
172				    int siglen, const char *data, int datalen)
173{
174	return -EOPNOTSUPP;
175}
176#endif
177
178#ifdef CONFIG_IMA_APPRAISE_MODSIG
179int ima_modsig_verify(struct key *keyring, const struct modsig *modsig);
180#else
181static inline int ima_modsig_verify(struct key *keyring,
182				    const struct modsig *modsig)
183{
184	return -EOPNOTSUPP;
185}
186#endif
187
188#ifdef CONFIG_IMA_LOAD_X509
189void __init ima_load_x509(void);
190#else
191static inline void ima_load_x509(void)
192{
193}
194#endif
195
196#ifdef CONFIG_EVM_LOAD_X509
197void __init evm_load_x509(void);
198#else
199static inline void evm_load_x509(void)
200{
201}
202#endif
203
204#ifdef CONFIG_INTEGRITY_AUDIT
205/* declarations */
206void integrity_audit_msg(int audit_msgno, struct inode *inode,
207			 const unsigned char *fname, const char *op,
208			 const char *cause, int result, int info);
209
210void integrity_audit_message(int audit_msgno, struct inode *inode,
211			     const unsigned char *fname, const char *op,
212			     const char *cause, int result, int info,
213			     int errno);
214
215static inline struct audit_buffer *
216integrity_audit_log_start(struct audit_context *ctx, gfp_t gfp_mask, int type)
217{
218	return audit_log_start(ctx, gfp_mask, type);
219}
220
221#else
222static inline void integrity_audit_msg(int audit_msgno, struct inode *inode,
223				       const unsigned char *fname,
224				       const char *op, const char *cause,
225				       int result, int info)
226{
227}
228
229static inline void integrity_audit_message(int audit_msgno,
230					   struct inode *inode,
231					   const unsigned char *fname,
232					   const char *op, const char *cause,
233					   int result, int info, int errno)
234{
235}
236
237static inline struct audit_buffer *
238integrity_audit_log_start(struct audit_context *ctx, gfp_t gfp_mask, int type)
239{
240	return NULL;
241}
242
243#endif
244
245#ifdef CONFIG_INTEGRITY_PLATFORM_KEYRING
246void __init add_to_platform_keyring(const char *source, const void *data,
247				    size_t len);
248#else
249static inline void __init add_to_platform_keyring(const char *source,
250						  const void *data, size_t len)
251{
252}
253#endif
254
255#ifdef CONFIG_INTEGRITY_MACHINE_KEYRING
256void __init add_to_machine_keyring(const char *source, const void *data, size_t len);
257bool __init imputed_trust_enabled(void);
258#else
259static inline void __init add_to_machine_keyring(const char *source,
260						  const void *data, size_t len)
261{
262}
263
264static inline bool __init imputed_trust_enabled(void)
265{
266	return false;
267}
268#endif