file.c 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457
  1. /*
  2. * AppArmor security module
  3. *
  4. * This file contains AppArmor mediation of files
  5. *
  6. * Copyright (C) 1998-2008 Novell/SUSE
  7. * Copyright 2009-2010 Canonical Ltd.
  8. *
  9. * This program is free software; you can redistribute it and/or
  10. * modify it under the terms of the GNU General Public License as
  11. * published by the Free Software Foundation, version 2 of the
  12. * License.
  13. */
  14. #include "include/apparmor.h"
  15. #include "include/audit.h"
  16. #include "include/file.h"
  17. #include "include/match.h"
  18. #include "include/path.h"
  19. #include "include/policy.h"
  20. struct file_perms nullperms;
  21. /**
  22. * audit_file_mask - convert mask to permission string
  23. * @buffer: buffer to write string to (NOT NULL)
  24. * @mask: permission mask to convert
  25. */
  26. static void audit_file_mask(struct audit_buffer *ab, u32 mask)
  27. {
  28. char str[10];
  29. char *m = str;
  30. if (mask & AA_EXEC_MMAP)
  31. *m++ = 'm';
  32. if (mask & (MAY_READ | AA_MAY_META_READ))
  33. *m++ = 'r';
  34. if (mask & (MAY_WRITE | AA_MAY_META_WRITE | AA_MAY_CHMOD |
  35. AA_MAY_CHOWN))
  36. *m++ = 'w';
  37. else if (mask & MAY_APPEND)
  38. *m++ = 'a';
  39. if (mask & AA_MAY_CREATE)
  40. *m++ = 'c';
  41. if (mask & AA_MAY_DELETE)
  42. *m++ = 'd';
  43. if (mask & AA_MAY_LINK)
  44. *m++ = 'l';
  45. if (mask & AA_MAY_LOCK)
  46. *m++ = 'k';
  47. if (mask & MAY_EXEC)
  48. *m++ = 'x';
  49. *m = '\0';
  50. audit_log_string(ab, str);
  51. }
  52. /**
  53. * file_audit_cb - call back for file specific audit fields
  54. * @ab: audit_buffer (NOT NULL)
  55. * @va: audit struct to audit values of (NOT NULL)
  56. */
  57. static void file_audit_cb(struct audit_buffer *ab, void *va)
  58. {
  59. struct common_audit_data *sa = va;
  60. uid_t fsuid = current_fsuid();
  61. if (sa->aad->fs.request & AA_AUDIT_FILE_MASK) {
  62. audit_log_format(ab, " requested_mask=");
  63. audit_file_mask(ab, sa->aad->fs.request);
  64. }
  65. if (sa->aad->fs.denied & AA_AUDIT_FILE_MASK) {
  66. audit_log_format(ab, " denied_mask=");
  67. audit_file_mask(ab, sa->aad->fs.denied);
  68. }
  69. if (sa->aad->fs.request & AA_AUDIT_FILE_MASK) {
  70. audit_log_format(ab, " fsuid=%d", fsuid);
  71. audit_log_format(ab, " ouid=%d", sa->aad->fs.ouid);
  72. }
  73. if (sa->aad->fs.target) {
  74. audit_log_format(ab, " target=");
  75. audit_log_untrustedstring(ab, sa->aad->fs.target);
  76. }
  77. }
  78. /**
  79. * aa_audit_file - handle the auditing of file operations
  80. * @profile: the profile being enforced (NOT NULL)
  81. * @perms: the permissions computed for the request (NOT NULL)
  82. * @gfp: allocation flags
  83. * @op: operation being mediated
  84. * @request: permissions requested
  85. * @name: name of object being mediated (MAYBE NULL)
  86. * @target: name of target (MAYBE NULL)
  87. * @ouid: object uid
  88. * @info: extra information message (MAYBE NULL)
  89. * @error: 0 if operation allowed else failure error code
  90. *
  91. * Returns: %0 or error on failure
  92. */
  93. int aa_audit_file(struct aa_profile *profile, struct file_perms *perms,
  94. gfp_t gfp, int op, u32 request, const char *name,
  95. const char *target, uid_t ouid, const char *info, int error)
  96. {
  97. int type = AUDIT_APPARMOR_AUTO;
  98. struct common_audit_data sa;
  99. struct apparmor_audit_data aad = {0,};
  100. COMMON_AUDIT_DATA_INIT(&sa, NONE);
  101. sa.aad = &aad;
  102. aad.op = op,
  103. aad.fs.request = request;
  104. aad.name = name;
  105. aad.fs.target = target;
  106. aad.fs.ouid = ouid;
  107. aad.info = info;
  108. aad.error = error;
  109. if (likely(!sa.aad->error)) {
  110. u32 mask = perms->audit;
  111. if (unlikely(AUDIT_MODE(profile) == AUDIT_ALL))
  112. mask = 0xffff;
  113. /* mask off perms that are not being force audited */
  114. sa.aad->fs.request &= mask;
  115. if (likely(!sa.aad->fs.request))
  116. return 0;
  117. type = AUDIT_APPARMOR_AUDIT;
  118. } else {
  119. /* only report permissions that were denied */
  120. sa.aad->fs.request = sa.aad->fs.request & ~perms->allow;
  121. if (sa.aad->fs.request & perms->kill)
  122. type = AUDIT_APPARMOR_KILL;
  123. /* quiet known rejects, assumes quiet and kill do not overlap */
  124. if ((sa.aad->fs.request & perms->quiet) &&
  125. AUDIT_MODE(profile) != AUDIT_NOQUIET &&
  126. AUDIT_MODE(profile) != AUDIT_ALL)
  127. sa.aad->fs.request &= ~perms->quiet;
  128. if (!sa.aad->fs.request)
  129. return COMPLAIN_MODE(profile) ? 0 : sa.aad->error;
  130. }
  131. sa.aad->fs.denied = sa.aad->fs.request & ~perms->allow;
  132. return aa_audit(type, profile, gfp, &sa, file_audit_cb);
  133. }
  134. /**
  135. * map_old_perms - map old file perms layout to the new layout
  136. * @old: permission set in old mapping
  137. *
  138. * Returns: new permission mapping
  139. */
  140. static u32 map_old_perms(u32 old)
  141. {
  142. u32 new = old & 0xf;
  143. if (old & MAY_READ)
  144. new |= AA_MAY_META_READ;
  145. if (old & MAY_WRITE)
  146. new |= AA_MAY_META_WRITE | AA_MAY_CREATE | AA_MAY_DELETE |
  147. AA_MAY_CHMOD | AA_MAY_CHOWN;
  148. if (old & 0x10)
  149. new |= AA_MAY_LINK;
  150. /* the old mapping lock and link_subset flags where overlaid
  151. * and use was determined by part of a pair that they were in
  152. */
  153. if (old & 0x20)
  154. new |= AA_MAY_LOCK | AA_LINK_SUBSET;
  155. if (old & 0x40) /* AA_EXEC_MMAP */
  156. new |= AA_EXEC_MMAP;
  157. return new;
  158. }
  159. /**
  160. * compute_perms - convert dfa compressed perms to internal perms
  161. * @dfa: dfa to compute perms for (NOT NULL)
  162. * @state: state in dfa
  163. * @cond: conditions to consider (NOT NULL)
  164. *
  165. * TODO: convert from dfa + state to permission entry, do computation conversion
  166. * at load time.
  167. *
  168. * Returns: computed permission set
  169. */
  170. static struct file_perms compute_perms(struct aa_dfa *dfa, unsigned int state,
  171. struct path_cond *cond)
  172. {
  173. struct file_perms perms;
  174. /* FIXME: change over to new dfa format
  175. * currently file perms are encoded in the dfa, new format
  176. * splits the permissions from the dfa. This mapping can be
  177. * done at profile load
  178. */
  179. perms.kill = 0;
  180. if (current_fsuid() == cond->uid) {
  181. perms.allow = map_old_perms(dfa_user_allow(dfa, state));
  182. perms.audit = map_old_perms(dfa_user_audit(dfa, state));
  183. perms.quiet = map_old_perms(dfa_user_quiet(dfa, state));
  184. perms.xindex = dfa_user_xindex(dfa, state);
  185. } else {
  186. perms.allow = map_old_perms(dfa_other_allow(dfa, state));
  187. perms.audit = map_old_perms(dfa_other_audit(dfa, state));
  188. perms.quiet = map_old_perms(dfa_other_quiet(dfa, state));
  189. perms.xindex = dfa_other_xindex(dfa, state);
  190. }
  191. perms.allow |= AA_MAY_META_READ;
  192. /* change_profile wasn't determined by ownership in old mapping */
  193. if (ACCEPT_TABLE(dfa)[state] & 0x80000000)
  194. perms.allow |= AA_MAY_CHANGE_PROFILE;
  195. if (ACCEPT_TABLE(dfa)[state] & 0x40000000)
  196. perms.allow |= AA_MAY_ONEXEC;
  197. return perms;
  198. }
  199. /**
  200. * aa_str_perms - find permission that match @name
  201. * @dfa: to match against (MAYBE NULL)
  202. * @state: state to start matching in
  203. * @name: string to match against dfa (NOT NULL)
  204. * @cond: conditions to consider for permission set computation (NOT NULL)
  205. * @perms: Returns - the permissions found when matching @name
  206. *
  207. * Returns: the final state in @dfa when beginning @start and walking @name
  208. */
  209. unsigned int aa_str_perms(struct aa_dfa *dfa, unsigned int start,
  210. const char *name, struct path_cond *cond,
  211. struct file_perms *perms)
  212. {
  213. unsigned int state;
  214. if (!dfa) {
  215. *perms = nullperms;
  216. return DFA_NOMATCH;
  217. }
  218. state = aa_dfa_match(dfa, start, name);
  219. *perms = compute_perms(dfa, state, cond);
  220. return state;
  221. }
  222. /**
  223. * is_deleted - test if a file has been completely unlinked
  224. * @dentry: dentry of file to test for deletion (NOT NULL)
  225. *
  226. * Returns: %1 if deleted else %0
  227. */
  228. static inline bool is_deleted(struct dentry *dentry)
  229. {
  230. if (d_unlinked(dentry) && dentry->d_inode->i_nlink == 0)
  231. return 1;
  232. return 0;
  233. }
  234. /**
  235. * aa_path_perm - do permissions check & audit for @path
  236. * @op: operation being checked
  237. * @profile: profile being enforced (NOT NULL)
  238. * @path: path to check permissions of (NOT NULL)
  239. * @flags: any additional path flags beyond what the profile specifies
  240. * @request: requested permissions
  241. * @cond: conditional info for this request (NOT NULL)
  242. *
  243. * Returns: %0 else error if access denied or other error
  244. */
  245. int aa_path_perm(int op, struct aa_profile *profile, struct path *path,
  246. int flags, u32 request, struct path_cond *cond)
  247. {
  248. char *buffer = NULL;
  249. struct file_perms perms = {};
  250. const char *name, *info = NULL;
  251. int error;
  252. flags |= profile->path_flags | (S_ISDIR(cond->mode) ? PATH_IS_DIR : 0);
  253. error = aa_path_name(path, flags, &buffer, &name, &info);
  254. if (error) {
  255. if (error == -ENOENT && is_deleted(path->dentry)) {
  256. /* Access to open files that are deleted are
  257. * give a pass (implicit delegation)
  258. */
  259. error = 0;
  260. info = NULL;
  261. perms.allow = request;
  262. }
  263. } else {
  264. aa_str_perms(profile->file.dfa, profile->file.start, name, cond,
  265. &perms);
  266. if (request & ~perms.allow)
  267. error = -EACCES;
  268. }
  269. error = aa_audit_file(profile, &perms, GFP_KERNEL, op, request, name,
  270. NULL, cond->uid, info, error);
  271. kfree(buffer);
  272. return error;
  273. }
  274. /**
  275. * xindex_is_subset - helper for aa_path_link
  276. * @link: link permission set
  277. * @target: target permission set
  278. *
  279. * test target x permissions are equal OR a subset of link x permissions
  280. * this is done as part of the subset test, where a hardlink must have
  281. * a subset of permissions that the target has.
  282. *
  283. * Returns: %1 if subset else %0
  284. */
  285. static inline bool xindex_is_subset(u32 link, u32 target)
  286. {
  287. if (((link & ~AA_X_UNSAFE) != (target & ~AA_X_UNSAFE)) ||
  288. ((link & AA_X_UNSAFE) && !(target & AA_X_UNSAFE)))
  289. return 0;
  290. return 1;
  291. }
  292. /**
  293. * aa_path_link - Handle hard link permission check
  294. * @profile: the profile being enforced (NOT NULL)
  295. * @old_dentry: the target dentry (NOT NULL)
  296. * @new_dir: directory the new link will be created in (NOT NULL)
  297. * @new_dentry: the link being created (NOT NULL)
  298. *
  299. * Handle the permission test for a link & target pair. Permission
  300. * is encoded as a pair where the link permission is determined
  301. * first, and if allowed, the target is tested. The target test
  302. * is done from the point of the link match (not start of DFA)
  303. * making the target permission dependent on the link permission match.
  304. *
  305. * The subset test if required forces that permissions granted
  306. * on link are a subset of the permission granted to target.
  307. *
  308. * Returns: %0 if allowed else error
  309. */
  310. int aa_path_link(struct aa_profile *profile, struct dentry *old_dentry,
  311. struct path *new_dir, struct dentry *new_dentry)
  312. {
  313. struct path link = { new_dir->mnt, new_dentry };
  314. struct path target = { new_dir->mnt, old_dentry };
  315. struct path_cond cond = {
  316. old_dentry->d_inode->i_uid,
  317. old_dentry->d_inode->i_mode
  318. };
  319. char *buffer = NULL, *buffer2 = NULL;
  320. const char *lname, *tname = NULL, *info = NULL;
  321. struct file_perms lperms, perms;
  322. u32 request = AA_MAY_LINK;
  323. unsigned int state;
  324. int error;
  325. lperms = nullperms;
  326. /* buffer freed below, lname is pointer in buffer */
  327. error = aa_path_name(&link, profile->path_flags, &buffer, &lname,
  328. &info);
  329. if (error)
  330. goto audit;
  331. /* buffer2 freed below, tname is pointer in buffer2 */
  332. error = aa_path_name(&target, profile->path_flags, &buffer2, &tname,
  333. &info);
  334. if (error)
  335. goto audit;
  336. error = -EACCES;
  337. /* aa_str_perms - handles the case of the dfa being NULL */
  338. state = aa_str_perms(profile->file.dfa, profile->file.start, lname,
  339. &cond, &lperms);
  340. if (!(lperms.allow & AA_MAY_LINK))
  341. goto audit;
  342. /* test to see if target can be paired with link */
  343. state = aa_dfa_null_transition(profile->file.dfa, state);
  344. aa_str_perms(profile->file.dfa, state, tname, &cond, &perms);
  345. /* force audit/quiet masks for link are stored in the second entry
  346. * in the link pair.
  347. */
  348. lperms.audit = perms.audit;
  349. lperms.quiet = perms.quiet;
  350. lperms.kill = perms.kill;
  351. if (!(perms.allow & AA_MAY_LINK)) {
  352. info = "target restricted";
  353. goto audit;
  354. }
  355. /* done if link subset test is not required */
  356. if (!(perms.allow & AA_LINK_SUBSET))
  357. goto done_tests;
  358. /* Do link perm subset test requiring allowed permission on link are a
  359. * subset of the allowed permissions on target.
  360. */
  361. aa_str_perms(profile->file.dfa, profile->file.start, tname, &cond,
  362. &perms);
  363. /* AA_MAY_LINK is not considered in the subset test */
  364. request = lperms.allow & ~AA_MAY_LINK;
  365. lperms.allow &= perms.allow | AA_MAY_LINK;
  366. request |= AA_AUDIT_FILE_MASK & (lperms.allow & ~perms.allow);
  367. if (request & ~lperms.allow) {
  368. goto audit;
  369. } else if ((lperms.allow & MAY_EXEC) &&
  370. !xindex_is_subset(lperms.xindex, perms.xindex)) {
  371. lperms.allow &= ~MAY_EXEC;
  372. request |= MAY_EXEC;
  373. info = "link not subset of target";
  374. goto audit;
  375. }
  376. done_tests:
  377. error = 0;
  378. audit:
  379. error = aa_audit_file(profile, &lperms, GFP_KERNEL, OP_LINK, request,
  380. lname, tname, cond.uid, info, error);
  381. kfree(buffer);
  382. kfree(buffer2);
  383. return error;
  384. }
  385. /**
  386. * aa_file_perm - do permission revalidation check & audit for @file
  387. * @op: operation being checked
  388. * @profile: profile being enforced (NOT NULL)
  389. * @file: file to revalidate access permissions on (NOT NULL)
  390. * @request: requested permissions
  391. *
  392. * Returns: %0 if access allowed else error
  393. */
  394. int aa_file_perm(int op, struct aa_profile *profile, struct file *file,
  395. u32 request)
  396. {
  397. struct path_cond cond = {
  398. .uid = file->f_path.dentry->d_inode->i_uid,
  399. .mode = file->f_path.dentry->d_inode->i_mode
  400. };
  401. return aa_path_perm(op, profile, &file->f_path, PATH_DELEGATE_DELETED,
  402. request, &cond);
  403. }