apparmor.rst 1.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354
  1. ========
  2. AppArmor
  3. ========
  4. What is AppArmor?
  5. =================
  6. AppArmor is MAC style security extension for the Linux kernel. It implements
  7. a task centered policy, with task "profiles" being created and loaded
  8. from user space. Tasks on the system that do not have a profile defined for
  9. them run in an unconfined state which is equivalent to standard Linux DAC
  10. permissions.
  11. How to enable/disable
  12. =====================
  13. set ``CONFIG_SECURITY_APPARMOR=y``
  14. If AppArmor should be selected as the default security module then set::
  15. CONFIG_DEFAULT_SECURITY_APPARMOR=y
  16. The CONFIG_LSM parameter manages the order and selection of LSMs.
  17. Specify apparmor as the first "major" module (e.g. AppArmor, SELinux, Smack)
  18. in the list.
  19. Build the kernel
  20. If AppArmor is not the default security module it can be enabled by passing
  21. ``security=apparmor`` on the kernel's command line.
  22. If AppArmor is the default security module it can be disabled by passing
  23. ``apparmor=0, security=XXXX`` (where ``XXXX`` is valid security module), on the
  24. kernel's command line.
  25. For AppArmor to enforce any restrictions beyond standard Linux DAC permissions
  26. policy must be loaded into the kernel from user space (see the Documentation
  27. and tools links).
  28. Documentation
  29. =============
  30. Documentation can be found on the wiki, linked below.
  31. Links
  32. =====
  33. Mailing List - apparmor@lists.ubuntu.com
  34. Wiki - http://wiki.apparmor.net
  35. User space tools - https://gitlab.com/apparmor
  36. Kernel module - git://git.kernel.org/pub/scm/linux/kernel/git/jj/linux-apparmor