apparmor.rst 1.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051
  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"
  16. CONFIG_SECURITY_APPARMOR_BOOTPARAM_VALUE=1
  17. Build the kernel
  18. If AppArmor is not the default security module it can be enabled by passing
  19. ``security=apparmor`` on the kernel's command line.
  20. If AppArmor is the default security module it can be disabled by passing
  21. ``apparmor=0, security=XXXX`` (where ``XXXX`` is valid security module), on the
  22. kernel's command line.
  23. For AppArmor to enforce any restrictions beyond standard Linux DAC permissions
  24. policy must be loaded into the kernel from user space (see the Documentation
  25. and tools links).
  26. Documentation
  27. =============
  28. Documentation can be found on the wiki, linked below.
  29. Links
  30. =====
  31. Mailing List - apparmor@lists.ubuntu.com
  32. Wiki - http://wiki.apparmor.net
  33. User space tools - https://gitlab.com/apparmor
  34. Kernel module - git://git.kernel.org/pub/scm/linux/kernel/git/jj/linux-apparmor