1 // SPDX-License-Identifier: GPL-2.0-only 2 /* 3 * Integrity Measurement Architecture 4 * 5 * Copyright (C) 2005,2006,2007,2008 IBM Corporation 6 * 7 * Authors: 8 * Reiner Sailer <sailer@watson.ibm.com> 9 * Serge Hallyn <serue@us.ibm.com> 10 * Kylene Hall <kylene@us.ibm.com> 11 * Mimi Zohar <zohar@us.ibm.com> 12 * 13 * File: ima_main.c 14 * implements the IMA hooks: ima_bprm_check, ima_file_mmap, 15 * and ima_file_check. 16 */ 17 18 #include <linux/module.h> 19 #include <linux/file.h> 20 #include <linux/binfmts.h> 21 #include <linux/kernel_read_file.h> 22 #include <linux/mount.h> 23 #include <linux/mman.h> 24 #include <linux/slab.h> 25 #include <linux/xattr.h> 26 #include <linux/ima.h> 27 #include <linux/iversion.h> 28 #include <linux/fs.h> 29 30 #include "ima.h" 31 32 #ifdef CONFIG_IMA_APPRAISE 33 int ima_appraise = IMA_APPRAISE_ENFORCE; 34 #else 35 int ima_appraise; 36 #endif 37 38 int ima_hash_algo = HASH_ALGO_SHA1; 39 static int hash_setup_done; 40 41 static struct notifier_block ima_lsm_policy_notifier = { 42 .notifier_call = ima_lsm_policy_change, 43 }; 44 45 static int __init hash_setup(char *str) 46 { 47 struct ima_template_desc *template_desc = ima_template_desc_current(); 48 int i; 49 50 if (hash_setup_done) 51 return 1; 52 53 if (strcmp(template_desc->name, IMA_TEMPLATE_IMA_NAME) == 0) { 54 if (strncmp(str, "sha1", 4) == 0) { 55 ima_hash_algo = HASH_ALGO_SHA1; 56 } else if (strncmp(str, "md5", 3) == 0) { 57 ima_hash_algo = HASH_ALGO_MD5; 58 } else { 59 pr_err("invalid hash algorithm \"%s\" for template \"%s\"", 60 str, IMA_TEMPLATE_IMA_NAME); 61 return 1; 62 } 63 goto out; 64 } 65 66 i = match_string(hash_algo_name, HASH_ALGO__LAST, str); 67 if (i < 0) { 68 pr_err("invalid hash algorithm \"%s\"", str); 69 return 1; 70 } 71 72 ima_hash_algo = i; 73 out: 74 hash_setup_done = 1; 75 return 1; 76 } 77 __setup("ima_hash=", hash_setup); 78 79 /* Prevent mmap'ing a file execute that is already mmap'ed write */ 80 static int mmap_violation_check(enum ima_hooks func, struct file *file, 81 char **pathbuf, const char **pathname, 82 char *filename) 83 { 84 struct inode *inode; 85 int rc = 0; 86 87 if ((func == MMAP_CHECK) && mapping_writably_mapped(file->f_mapping)) { 88 rc = -ETXTBSY; 89 inode = file_inode(file); 90 91 if (!*pathbuf) /* ima_rdwr_violation possibly pre-fetched */ 92 *pathname = ima_d_path(&file->f_path, pathbuf, 93 filename); 94 integrity_audit_msg(AUDIT_INTEGRITY_DATA, inode, *pathname, 95 "mmap_file", "mmapped_writers", rc, 0); 96 } 97 return rc; 98 } 99 100 /* 101 * ima_rdwr_violation_check 102 * 103 * Only invalidate the PCR for measured files: 104 * - Opening a file for write when already open for read, 105 * results in a time of measure, time of use (ToMToU) error. 106 * - Opening a file for read when already open for write, 107 * could result in a file measurement error. 108 * 109 */ 110 static void ima_rdwr_violation_check(struct file *file, 111 struct integrity_iint_cache *iint, 112 int must_measure, 113 char **pathbuf, 114 const char **pathname, 115 char *filename) 116 { 117 struct inode *inode = file_inode(file); 118 fmode_t mode = file->f_mode; 119 bool send_tomtou = false, send_writers = false; 120 121 if (mode & FMODE_WRITE) { 122 if (atomic_read(&inode->i_readcount) && IS_IMA(inode)) { 123 if (!iint) 124 iint = integrity_iint_find(inode); 125 /* IMA_MEASURE is set from reader side */ 126 if (iint && test_bit(IMA_MUST_MEASURE, 127 &iint->atomic_flags)) 128 send_tomtou = true; 129 } 130 } else { 131 if (must_measure) 132 set_bit(IMA_MUST_MEASURE, &iint->atomic_flags); 133 if (inode_is_open_for_write(inode) && must_measure) 134 send_writers = true; 135 } 136 137 if (!send_tomtou && !send_writers) 138 return; 139 140 *pathname = ima_d_path(&file->f_path, pathbuf, filename); 141 142 if (send_tomtou) 143 ima_add_violation(file, *pathname, iint, 144 "invalid_pcr", "ToMToU"); 145 if (send_writers) 146 ima_add_violation(file, *pathname, iint, 147 "invalid_pcr", "open_writers"); 148 } 149 150 static void ima_check_last_writer(struct integrity_iint_cache *iint, 151 struct inode *inode, struct file *file) 152 { 153 fmode_t mode = file->f_mode; 154 bool update; 155 156 if (!(mode & FMODE_WRITE)) 157 return; 158 159 mutex_lock(&iint->mutex); 160 if (atomic_read(&inode->i_writecount) == 1) { 161 update = test_and_clear_bit(IMA_UPDATE_XATTR, 162 &iint->atomic_flags); 163 if (!IS_I_VERSION(inode) || 164 !inode_eq_iversion(inode, iint->version) || 165 (iint->flags & IMA_NEW_FILE)) { 166 iint->flags &= ~(IMA_DONE_MASK | IMA_NEW_FILE); 167 iint->measured_pcrs = 0; 168 if (update) 169 ima_update_xattr(iint, file); 170 } 171 } 172 mutex_unlock(&iint->mutex); 173 } 174 175 /** 176 * ima_file_free - called on __fput() 177 * @file: pointer to file structure being freed 178 * 179 * Flag files that changed, based on i_version 180 */ 181 void ima_file_free(struct file *file) 182 { 183 struct inode *inode = file_inode(file); 184 struct integrity_iint_cache *iint; 185 186 if (!ima_policy_flag || !S_ISREG(inode->i_mode)) 187 return; 188 189 iint = integrity_iint_find(inode); 190 if (!iint) 191 return; 192 193 ima_check_last_writer(iint, inode, file); 194 } 195 196 static int process_measurement(struct file *file, const struct cred *cred, 197 u32 secid, char *buf, loff_t size, int mask, 198 enum ima_hooks func) 199 { 200 struct inode *inode = file_inode(file); 201 struct integrity_iint_cache *iint = NULL; 202 struct ima_template_desc *template_desc = NULL; 203 char *pathbuf = NULL; 204 char filename[NAME_MAX]; 205 const char *pathname = NULL; 206 int rc = 0, action, must_appraise = 0; 207 int pcr = CONFIG_IMA_MEASURE_PCR_IDX; 208 struct evm_ima_xattr_data *xattr_value = NULL; 209 struct modsig *modsig = NULL; 210 int xattr_len = 0; 211 bool violation_check; 212 enum hash_algo hash_algo; 213 214 if (!ima_policy_flag || !S_ISREG(inode->i_mode)) 215 return 0; 216 217 /* Return an IMA_MEASURE, IMA_APPRAISE, IMA_AUDIT action 218 * bitmask based on the appraise/audit/measurement policy. 219 * Included is the appraise submask. 220 */ 221 action = ima_get_action(inode, cred, secid, mask, func, &pcr, 222 &template_desc, NULL); 223 violation_check = ((func == FILE_CHECK || func == MMAP_CHECK) && 224 (ima_policy_flag & IMA_MEASURE)); 225 if (!action && !violation_check) 226 return 0; 227 228 must_appraise = action & IMA_APPRAISE; 229 230 /* Is the appraise rule hook specific? */ 231 if (action & IMA_FILE_APPRAISE) 232 func = FILE_CHECK; 233 234 inode_lock(inode); 235 236 if (action) { 237 iint = integrity_inode_get(inode); 238 if (!iint) 239 rc = -ENOMEM; 240 } 241 242 if (!rc && violation_check) 243 ima_rdwr_violation_check(file, iint, action & IMA_MEASURE, 244 &pathbuf, &pathname, filename); 245 246 inode_unlock(inode); 247 248 if (rc) 249 goto out; 250 if (!action) 251 goto out; 252 253 mutex_lock(&iint->mutex); 254 255 if (test_and_clear_bit(IMA_CHANGE_ATTR, &iint->atomic_flags)) 256 /* reset appraisal flags if ima_inode_post_setattr was called */ 257 iint->flags &= ~(IMA_APPRAISE | IMA_APPRAISED | 258 IMA_APPRAISE_SUBMASK | IMA_APPRAISED_SUBMASK | 259 IMA_ACTION_FLAGS); 260 261 /* 262 * Re-evaulate the file if either the xattr has changed or the 263 * kernel has no way of detecting file change on the filesystem. 264 * (Limited to privileged mounted filesystems.) 265 */ 266 if (test_and_clear_bit(IMA_CHANGE_XATTR, &iint->atomic_flags) || 267 ((inode->i_sb->s_iflags & SB_I_IMA_UNVERIFIABLE_SIGNATURE) && 268 !(inode->i_sb->s_iflags & SB_I_UNTRUSTED_MOUNTER) && 269 !(action & IMA_FAIL_UNVERIFIABLE_SIGS))) { 270 iint->flags &= ~IMA_DONE_MASK; 271 iint->measured_pcrs = 0; 272 } 273 274 /* Determine if already appraised/measured based on bitmask 275 * (IMA_MEASURE, IMA_MEASURED, IMA_XXXX_APPRAISE, IMA_XXXX_APPRAISED, 276 * IMA_AUDIT, IMA_AUDITED) 277 */ 278 iint->flags |= action; 279 action &= IMA_DO_MASK; 280 action &= ~((iint->flags & (IMA_DONE_MASK ^ IMA_MEASURED)) >> 1); 281 282 /* If target pcr is already measured, unset IMA_MEASURE action */ 283 if ((action & IMA_MEASURE) && (iint->measured_pcrs & (0x1 << pcr))) 284 action ^= IMA_MEASURE; 285 286 /* HASH sets the digital signature and update flags, nothing else */ 287 if ((action & IMA_HASH) && 288 !(test_bit(IMA_DIGSIG, &iint->atomic_flags))) { 289 xattr_len = ima_read_xattr(file_dentry(file), &xattr_value); 290 if ((xattr_value && xattr_len > 2) && 291 (xattr_value->type == EVM_IMA_XATTR_DIGSIG)) 292 set_bit(IMA_DIGSIG, &iint->atomic_flags); 293 iint->flags |= IMA_HASHED; 294 action ^= IMA_HASH; 295 set_bit(IMA_UPDATE_XATTR, &iint->atomic_flags); 296 } 297 298 /* Nothing to do, just return existing appraised status */ 299 if (!action) { 300 if (must_appraise) { 301 rc = mmap_violation_check(func, file, &pathbuf, 302 &pathname, filename); 303 if (!rc) 304 rc = ima_get_cache_status(iint, func); 305 } 306 goto out_locked; 307 } 308 309 if ((action & IMA_APPRAISE_SUBMASK) || 310 strcmp(template_desc->name, IMA_TEMPLATE_IMA_NAME) != 0) { 311 /* read 'security.ima' */ 312 xattr_len = ima_read_xattr(file_dentry(file), &xattr_value); 313 314 /* 315 * Read the appended modsig if allowed by the policy, and allow 316 * an additional measurement list entry, if needed, based on the 317 * template format and whether the file was already measured. 318 */ 319 if (iint->flags & IMA_MODSIG_ALLOWED) { 320 rc = ima_read_modsig(func, buf, size, &modsig); 321 322 if (!rc && ima_template_has_modsig(template_desc) && 323 iint->flags & IMA_MEASURED) 324 action |= IMA_MEASURE; 325 } 326 } 327 328 hash_algo = ima_get_hash_algo(xattr_value, xattr_len); 329 330 rc = ima_collect_measurement(iint, file, buf, size, hash_algo, modsig); 331 if (rc != 0 && rc != -EBADF && rc != -EINVAL) 332 goto out_locked; 333 334 if (!pathbuf) /* ima_rdwr_violation possibly pre-fetched */ 335 pathname = ima_d_path(&file->f_path, &pathbuf, filename); 336 337 if (action & IMA_MEASURE) 338 ima_store_measurement(iint, file, pathname, 339 xattr_value, xattr_len, modsig, pcr, 340 template_desc); 341 if (rc == 0 && (action & IMA_APPRAISE_SUBMASK)) { 342 rc = ima_check_blacklist(iint, modsig, pcr); 343 if (rc != -EPERM) { 344 inode_lock(inode); 345 rc = ima_appraise_measurement(func, iint, file, 346 pathname, xattr_value, 347 xattr_len, modsig); 348 inode_unlock(inode); 349 } 350 if (!rc) 351 rc = mmap_violation_check(func, file, &pathbuf, 352 &pathname, filename); 353 } 354 if (action & IMA_AUDIT) 355 ima_audit_measurement(iint, pathname); 356 357 if ((file->f_flags & O_DIRECT) && (iint->flags & IMA_PERMIT_DIRECTIO)) 358 rc = 0; 359 out_locked: 360 if ((mask & MAY_WRITE) && test_bit(IMA_DIGSIG, &iint->atomic_flags) && 361 !(iint->flags & IMA_NEW_FILE)) 362 rc = -EACCES; 363 mutex_unlock(&iint->mutex); 364 kfree(xattr_value); 365 ima_free_modsig(modsig); 366 out: 367 if (pathbuf) 368 __putname(pathbuf); 369 if (must_appraise) { 370 if (rc && (ima_appraise & IMA_APPRAISE_ENFORCE)) 371 return -EACCES; 372 if (file->f_mode & FMODE_WRITE) 373 set_bit(IMA_UPDATE_XATTR, &iint->atomic_flags); 374 } 375 return 0; 376 } 377 378 /** 379 * ima_file_mmap - based on policy, collect/store measurement. 380 * @file: pointer to the file to be measured (May be NULL) 381 * @prot: contains the protection that will be applied by the kernel. 382 * 383 * Measure files being mmapped executable based on the ima_must_measure() 384 * policy decision. 385 * 386 * On success return 0. On integrity appraisal error, assuming the file 387 * is in policy and IMA-appraisal is in enforcing mode, return -EACCES. 388 */ 389 int ima_file_mmap(struct file *file, unsigned long prot) 390 { 391 u32 secid; 392 393 if (file && (prot & PROT_EXEC)) { 394 security_task_getsecid(current, &secid); 395 return process_measurement(file, current_cred(), secid, NULL, 396 0, MAY_EXEC, MMAP_CHECK); 397 } 398 399 return 0; 400 } 401 402 /** 403 * ima_file_mprotect - based on policy, limit mprotect change 404 * @prot: contains the protection that will be applied by the kernel. 405 * 406 * Files can be mmap'ed read/write and later changed to execute to circumvent 407 * IMA's mmap appraisal policy rules. Due to locking issues (mmap semaphore 408 * would be taken before i_mutex), files can not be measured or appraised at 409 * this point. Eliminate this integrity gap by denying the mprotect 410 * PROT_EXECUTE change, if an mmap appraise policy rule exists. 411 * 412 * On mprotect change success, return 0. On failure, return -EACESS. 413 */ 414 int ima_file_mprotect(struct vm_area_struct *vma, unsigned long prot) 415 { 416 struct ima_template_desc *template = NULL; 417 struct file *file = vma->vm_file; 418 char filename[NAME_MAX]; 419 char *pathbuf = NULL; 420 const char *pathname = NULL; 421 struct inode *inode; 422 int result = 0; 423 int action; 424 u32 secid; 425 int pcr; 426 427 /* Is mprotect making an mmap'ed file executable? */ 428 if (!(ima_policy_flag & IMA_APPRAISE) || !vma->vm_file || 429 !(prot & PROT_EXEC) || (vma->vm_flags & VM_EXEC)) 430 return 0; 431 432 security_task_getsecid(current, &secid); 433 inode = file_inode(vma->vm_file); 434 action = ima_get_action(inode, current_cred(), secid, MAY_EXEC, 435 MMAP_CHECK, &pcr, &template, 0); 436 437 /* Is the mmap'ed file in policy? */ 438 if (!(action & (IMA_MEASURE | IMA_APPRAISE_SUBMASK))) 439 return 0; 440 441 if (action & IMA_APPRAISE_SUBMASK) 442 result = -EPERM; 443 444 file = vma->vm_file; 445 pathname = ima_d_path(&file->f_path, &pathbuf, filename); 446 integrity_audit_msg(AUDIT_INTEGRITY_DATA, inode, pathname, 447 "collect_data", "failed-mprotect", result, 0); 448 if (pathbuf) 449 __putname(pathbuf); 450 451 return result; 452 } 453 454 /** 455 * ima_bprm_check - based on policy, collect/store measurement. 456 * @bprm: contains the linux_binprm structure 457 * 458 * The OS protects against an executable file, already open for write, 459 * from being executed in deny_write_access() and an executable file, 460 * already open for execute, from being modified in get_write_access(). 461 * So we can be certain that what we verify and measure here is actually 462 * what is being executed. 463 * 464 * On success return 0. On integrity appraisal error, assuming the file 465 * is in policy and IMA-appraisal is in enforcing mode, return -EACCES. 466 */ 467 int ima_bprm_check(struct linux_binprm *bprm) 468 { 469 int ret; 470 u32 secid; 471 472 security_task_getsecid(current, &secid); 473 ret = process_measurement(bprm->file, current_cred(), secid, NULL, 0, 474 MAY_EXEC, BPRM_CHECK); 475 if (ret) 476 return ret; 477 478 security_cred_getsecid(bprm->cred, &secid); 479 return process_measurement(bprm->file, bprm->cred, secid, NULL, 0, 480 MAY_EXEC, CREDS_CHECK); 481 } 482 483 /** 484 * ima_path_check - based on policy, collect/store measurement. 485 * @file: pointer to the file to be measured 486 * @mask: contains MAY_READ, MAY_WRITE, MAY_EXEC or MAY_APPEND 487 * 488 * Measure files based on the ima_must_measure() policy decision. 489 * 490 * On success return 0. On integrity appraisal error, assuming the file 491 * is in policy and IMA-appraisal is in enforcing mode, return -EACCES. 492 */ 493 int ima_file_check(struct file *file, int mask) 494 { 495 u32 secid; 496 497 security_task_getsecid(current, &secid); 498 return process_measurement(file, current_cred(), secid, NULL, 0, 499 mask & (MAY_READ | MAY_WRITE | MAY_EXEC | 500 MAY_APPEND), FILE_CHECK); 501 } 502 EXPORT_SYMBOL_GPL(ima_file_check); 503 504 static int __ima_inode_hash(struct inode *inode, char *buf, size_t buf_size) 505 { 506 struct integrity_iint_cache *iint; 507 int hash_algo; 508 509 if (!ima_policy_flag) 510 return -EOPNOTSUPP; 511 512 iint = integrity_iint_find(inode); 513 if (!iint) 514 return -EOPNOTSUPP; 515 516 mutex_lock(&iint->mutex); 517 518 /* 519 * ima_file_hash can be called when ima_collect_measurement has still 520 * not been called, we might not always have a hash. 521 */ 522 if (!iint->ima_hash) { 523 mutex_unlock(&iint->mutex); 524 return -EOPNOTSUPP; 525 } 526 527 if (buf) { 528 size_t copied_size; 529 530 copied_size = min_t(size_t, iint->ima_hash->length, buf_size); 531 memcpy(buf, iint->ima_hash->digest, copied_size); 532 } 533 hash_algo = iint->ima_hash->algo; 534 mutex_unlock(&iint->mutex); 535 536 return hash_algo; 537 } 538 539 /** 540 * ima_file_hash - return the stored measurement if a file has been hashed and 541 * is in the iint cache. 542 * @file: pointer to the file 543 * @buf: buffer in which to store the hash 544 * @buf_size: length of the buffer 545 * 546 * On success, return the hash algorithm (as defined in the enum hash_algo). 547 * If buf is not NULL, this function also outputs the hash into buf. 548 * If the hash is larger than buf_size, then only buf_size bytes will be copied. 549 * It generally just makes sense to pass a buffer capable of holding the largest 550 * possible hash: IMA_MAX_DIGEST_SIZE. 551 * The file hash returned is based on the entire file, including the appended 552 * signature. 553 * 554 * If IMA is disabled or if no measurement is available, return -EOPNOTSUPP. 555 * If the parameters are incorrect, return -EINVAL. 556 */ 557 int ima_file_hash(struct file *file, char *buf, size_t buf_size) 558 { 559 if (!file) 560 return -EINVAL; 561 562 return __ima_inode_hash(file_inode(file), buf, buf_size); 563 } 564 EXPORT_SYMBOL_GPL(ima_file_hash); 565 566 /** 567 * ima_inode_hash - return the stored measurement if the inode has been hashed 568 * and is in the iint cache. 569 * @inode: pointer to the inode 570 * @buf: buffer in which to store the hash 571 * @buf_size: length of the buffer 572 * 573 * On success, return the hash algorithm (as defined in the enum hash_algo). 574 * If buf is not NULL, this function also outputs the hash into buf. 575 * If the hash is larger than buf_size, then only buf_size bytes will be copied. 576 * It generally just makes sense to pass a buffer capable of holding the largest 577 * possible hash: IMA_MAX_DIGEST_SIZE. 578 * The hash returned is based on the entire contents, including the appended 579 * signature. 580 * 581 * If IMA is disabled or if no measurement is available, return -EOPNOTSUPP. 582 * If the parameters are incorrect, return -EINVAL. 583 */ 584 int ima_inode_hash(struct inode *inode, char *buf, size_t buf_size) 585 { 586 if (!inode) 587 return -EINVAL; 588 589 return __ima_inode_hash(inode, buf, buf_size); 590 } 591 EXPORT_SYMBOL_GPL(ima_inode_hash); 592 593 /** 594 * ima_post_create_tmpfile - mark newly created tmpfile as new 595 * @file : newly created tmpfile 596 * 597 * No measuring, appraising or auditing of newly created tmpfiles is needed. 598 * Skip calling process_measurement(), but indicate which newly, created 599 * tmpfiles are in policy. 600 */ 601 void ima_post_create_tmpfile(struct inode *inode) 602 { 603 struct integrity_iint_cache *iint; 604 int must_appraise; 605 606 must_appraise = ima_must_appraise(inode, MAY_ACCESS, FILE_CHECK); 607 if (!must_appraise) 608 return; 609 610 /* Nothing to do if we can't allocate memory */ 611 iint = integrity_inode_get(inode); 612 if (!iint) 613 return; 614 615 /* needed for writing the security xattrs */ 616 set_bit(IMA_UPDATE_XATTR, &iint->atomic_flags); 617 iint->ima_file_status = INTEGRITY_PASS; 618 } 619 620 /** 621 * ima_post_path_mknod - mark as a new inode 622 * @dentry: newly created dentry 623 * 624 * Mark files created via the mknodat syscall as new, so that the 625 * file data can be written later. 626 */ 627 void ima_post_path_mknod(struct dentry *dentry) 628 { 629 struct integrity_iint_cache *iint; 630 struct inode *inode = dentry->d_inode; 631 int must_appraise; 632 633 must_appraise = ima_must_appraise(inode, MAY_ACCESS, FILE_CHECK); 634 if (!must_appraise) 635 return; 636 637 /* Nothing to do if we can't allocate memory */ 638 iint = integrity_inode_get(inode); 639 if (!iint) 640 return; 641 642 /* needed for re-opening empty files */ 643 iint->flags |= IMA_NEW_FILE; 644 } 645 646 /** 647 * ima_read_file - pre-measure/appraise hook decision based on policy 648 * @file: pointer to the file to be measured/appraised/audit 649 * @read_id: caller identifier 650 * @contents: whether a subsequent call will be made to ima_post_read_file() 651 * 652 * Permit reading a file based on policy. The policy rules are written 653 * in terms of the policy identifier. Appraising the integrity of 654 * a file requires a file descriptor. 655 * 656 * For permission return 0, otherwise return -EACCES. 657 */ 658 int ima_read_file(struct file *file, enum kernel_read_file_id read_id, 659 bool contents) 660 { 661 enum ima_hooks func; 662 u32 secid; 663 664 /* 665 * Do devices using pre-allocated memory run the risk of the 666 * firmware being accessible to the device prior to the completion 667 * of IMA's signature verification any more than when using two 668 * buffers? It may be desirable to include the buffer address 669 * in this API and walk all the dma_map_single() mappings to check. 670 */ 671 672 /* 673 * There will be a call made to ima_post_read_file() with 674 * a filled buffer, so we don't need to perform an extra 675 * read early here. 676 */ 677 if (contents) 678 return 0; 679 680 /* Read entire file for all partial reads. */ 681 func = read_idmap[read_id] ?: FILE_CHECK; 682 security_task_getsecid(current, &secid); 683 return process_measurement(file, current_cred(), secid, NULL, 684 0, MAY_READ, func); 685 } 686 687 const int read_idmap[READING_MAX_ID] = { 688 [READING_FIRMWARE] = FIRMWARE_CHECK, 689 [READING_MODULE] = MODULE_CHECK, 690 [READING_KEXEC_IMAGE] = KEXEC_KERNEL_CHECK, 691 [READING_KEXEC_INITRAMFS] = KEXEC_INITRAMFS_CHECK, 692 [READING_POLICY] = POLICY_CHECK 693 }; 694 695 /** 696 * ima_post_read_file - in memory collect/appraise/audit measurement 697 * @file: pointer to the file to be measured/appraised/audit 698 * @buf: pointer to in memory file contents 699 * @size: size of in memory file contents 700 * @read_id: caller identifier 701 * 702 * Measure/appraise/audit in memory file based on policy. Policy rules 703 * are written in terms of a policy identifier. 704 * 705 * On success return 0. On integrity appraisal error, assuming the file 706 * is in policy and IMA-appraisal is in enforcing mode, return -EACCES. 707 */ 708 int ima_post_read_file(struct file *file, void *buf, loff_t size, 709 enum kernel_read_file_id read_id) 710 { 711 enum ima_hooks func; 712 u32 secid; 713 714 /* permit signed certs */ 715 if (!file && read_id == READING_X509_CERTIFICATE) 716 return 0; 717 718 if (!file || !buf || size == 0) { /* should never happen */ 719 if (ima_appraise & IMA_APPRAISE_ENFORCE) 720 return -EACCES; 721 return 0; 722 } 723 724 func = read_idmap[read_id] ?: FILE_CHECK; 725 security_task_getsecid(current, &secid); 726 return process_measurement(file, current_cred(), secid, buf, size, 727 MAY_READ, func); 728 } 729 730 /** 731 * ima_load_data - appraise decision based on policy 732 * @id: kernel load data caller identifier 733 * @contents: whether the full contents will be available in a later 734 * call to ima_post_load_data(). 735 * 736 * Callers of this LSM hook can not measure, appraise, or audit the 737 * data provided by userspace. Enforce policy rules requring a file 738 * signature (eg. kexec'ed kernel image). 739 * 740 * For permission return 0, otherwise return -EACCES. 741 */ 742 int ima_load_data(enum kernel_load_data_id id, bool contents) 743 { 744 bool ima_enforce, sig_enforce; 745 746 ima_enforce = 747 (ima_appraise & IMA_APPRAISE_ENFORCE) == IMA_APPRAISE_ENFORCE; 748 749 switch (id) { 750 case LOADING_KEXEC_IMAGE: 751 if (IS_ENABLED(CONFIG_KEXEC_SIG) 752 && arch_ima_get_secureboot()) { 753 pr_err("impossible to appraise a kernel image without a file descriptor; try using kexec_file_load syscall.\n"); 754 return -EACCES; 755 } 756 757 if (ima_enforce && (ima_appraise & IMA_APPRAISE_KEXEC)) { 758 pr_err("impossible to appraise a kernel image without a file descriptor; try using kexec_file_load syscall.\n"); 759 return -EACCES; /* INTEGRITY_UNKNOWN */ 760 } 761 break; 762 case LOADING_FIRMWARE: 763 if (ima_enforce && (ima_appraise & IMA_APPRAISE_FIRMWARE) && !contents) { 764 pr_err("Prevent firmware sysfs fallback loading.\n"); 765 return -EACCES; /* INTEGRITY_UNKNOWN */ 766 } 767 break; 768 case LOADING_MODULE: 769 sig_enforce = is_module_sig_enforced(); 770 771 if (ima_enforce && (!sig_enforce 772 && (ima_appraise & IMA_APPRAISE_MODULES))) { 773 pr_err("impossible to appraise a module without a file descriptor. sig_enforce kernel parameter might help\n"); 774 return -EACCES; /* INTEGRITY_UNKNOWN */ 775 } 776 default: 777 break; 778 } 779 return 0; 780 } 781 782 /** 783 * ima_post_load_data - appraise decision based on policy 784 * @buf: pointer to in memory file contents 785 * @size: size of in memory file contents 786 * @id: kernel load data caller identifier 787 * @description: @id-specific description of contents 788 * 789 * Measure/appraise/audit in memory buffer based on policy. Policy rules 790 * are written in terms of a policy identifier. 791 * 792 * On success return 0. On integrity appraisal error, assuming the file 793 * is in policy and IMA-appraisal is in enforcing mode, return -EACCES. 794 */ 795 int ima_post_load_data(char *buf, loff_t size, 796 enum kernel_load_data_id load_id, 797 char *description) 798 { 799 if (load_id == LOADING_FIRMWARE) { 800 if ((ima_appraise & IMA_APPRAISE_FIRMWARE) && 801 (ima_appraise & IMA_APPRAISE_ENFORCE)) { 802 pr_err("Prevent firmware loading_store.\n"); 803 return -EACCES; /* INTEGRITY_UNKNOWN */ 804 } 805 return 0; 806 } 807 808 return 0; 809 } 810 811 /* 812 * process_buffer_measurement - Measure the buffer to ima log. 813 * @inode: inode associated with the object being measured (NULL for KEY_CHECK) 814 * @buf: pointer to the buffer that needs to be added to the log. 815 * @size: size of buffer(in bytes). 816 * @eventname: event name to be used for the buffer entry. 817 * @func: IMA hook 818 * @pcr: pcr to extend the measurement 819 * @keyring: keyring name to determine the action to be performed 820 * 821 * Based on policy, the buffer is measured into the ima log. 822 */ 823 void process_buffer_measurement(struct inode *inode, const void *buf, int size, 824 const char *eventname, enum ima_hooks func, 825 int pcr, const char *keyring) 826 { 827 int ret = 0; 828 const char *audit_cause = "ENOMEM"; 829 struct ima_template_entry *entry = NULL; 830 struct integrity_iint_cache iint = {}; 831 struct ima_event_data event_data = {.iint = &iint, 832 .filename = eventname, 833 .buf = buf, 834 .buf_len = size}; 835 struct ima_template_desc *template; 836 struct { 837 struct ima_digest_data hdr; 838 char digest[IMA_MAX_DIGEST_SIZE]; 839 } hash = {}; 840 int violation = 0; 841 int action = 0; 842 u32 secid; 843 844 if (!ima_policy_flag) 845 return; 846 847 template = ima_template_desc_buf(); 848 if (!template) { 849 ret = -EINVAL; 850 audit_cause = "ima_template_desc_buf"; 851 goto out; 852 } 853 854 /* 855 * Both LSM hooks and auxilary based buffer measurements are 856 * based on policy. To avoid code duplication, differentiate 857 * between the LSM hooks and auxilary buffer measurements, 858 * retrieving the policy rule information only for the LSM hook 859 * buffer measurements. 860 */ 861 if (func) { 862 security_task_getsecid(current, &secid); 863 action = ima_get_action(inode, current_cred(), secid, 0, func, 864 &pcr, &template, keyring); 865 if (!(action & IMA_MEASURE)) 866 return; 867 } 868 869 if (!pcr) 870 pcr = CONFIG_IMA_MEASURE_PCR_IDX; 871 872 iint.ima_hash = &hash.hdr; 873 iint.ima_hash->algo = ima_hash_algo; 874 iint.ima_hash->length = hash_digest_size[ima_hash_algo]; 875 876 ret = ima_calc_buffer_hash(buf, size, iint.ima_hash); 877 if (ret < 0) { 878 audit_cause = "hashing_error"; 879 goto out; 880 } 881 882 ret = ima_alloc_init_template(&event_data, &entry, template); 883 if (ret < 0) { 884 audit_cause = "alloc_entry"; 885 goto out; 886 } 887 888 ret = ima_store_template(entry, violation, NULL, buf, pcr); 889 if (ret < 0) { 890 audit_cause = "store_entry"; 891 ima_free_template_entry(entry); 892 } 893 894 out: 895 if (ret < 0) 896 integrity_audit_message(AUDIT_INTEGRITY_PCR, NULL, eventname, 897 func_measure_str(func), 898 audit_cause, ret, 0, ret); 899 900 return; 901 } 902 903 /** 904 * ima_kexec_cmdline - measure kexec cmdline boot args 905 * @kernel_fd: file descriptor of the kexec kernel being loaded 906 * @buf: pointer to buffer 907 * @size: size of buffer 908 * 909 * Buffers can only be measured, not appraised. 910 */ 911 void ima_kexec_cmdline(int kernel_fd, const void *buf, int size) 912 { 913 struct fd f; 914 915 if (!buf || !size) 916 return; 917 918 f = fdget(kernel_fd); 919 if (!f.file) 920 return; 921 922 process_buffer_measurement(file_inode(f.file), buf, size, 923 "kexec-cmdline", KEXEC_CMDLINE, 0, NULL); 924 fdput(f); 925 } 926 927 static int __init init_ima(void) 928 { 929 int error; 930 931 ima_appraise_parse_cmdline(); 932 ima_init_template_list(); 933 hash_setup(CONFIG_IMA_DEFAULT_HASH); 934 error = ima_init(); 935 936 if (error && strcmp(hash_algo_name[ima_hash_algo], 937 CONFIG_IMA_DEFAULT_HASH) != 0) { 938 pr_info("Allocating %s failed, going to use default hash algorithm %s\n", 939 hash_algo_name[ima_hash_algo], CONFIG_IMA_DEFAULT_HASH); 940 hash_setup_done = 0; 941 hash_setup(CONFIG_IMA_DEFAULT_HASH); 942 error = ima_init(); 943 } 944 945 if (error) 946 return error; 947 948 error = register_blocking_lsm_notifier(&ima_lsm_policy_notifier); 949 if (error) 950 pr_warn("Couldn't register LSM notifier, error %d\n", error); 951 952 if (!error) 953 ima_update_policy_flag(); 954 955 return error; 956 } 957 958 late_initcall(init_ima); /* Start IMA after the TPM is available */ 959