89abbae6bd
Improve go apparmor lib. * aa: (62 commits) feat(aa): handle appending value to defined variables. chore(aa): cosmetic. fix: userspace prebuild test. chore: cleanup unit test. feat(aa): improve log conversion. feat(aa): move conversion function to its own file & add unit tests. fix: go linter issue & not defined variables. tests(aa): improve aa unit tests. tests(aa): improve rules unit tests. feat(aa): ensure the prebuild jobs are working. feat(aa): add more unit tests. chore(aa): cleanup. feat(aa): Move sort, merge and format methods to the rules interface. feat(aa): add the hat template. feat(aa): add the Kind struct to manage aa rules. feat(aa): cleanup rules methods. feat(aa): add function to resolve include preamble. feat(aa): updaqte mount flags order. feat(aa): update default tunable selection. feat(aa): parse apparmor preamble files. ... |
||
|---|---|---|
| .github | ||
| apparmor.d | ||
| cmd | ||
| debian | ||
| dists | ||
| docs | ||
| pkg | ||
| root/usr/share | ||
| systemd | ||
| tests | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| .golangci.yaml | ||
| go.mod | ||
| go.sum | ||
| LICENSE | ||
| Makefile | ||
| mkdocs.yml | ||
| PKGBUILD | ||
| README.md | ||
| requirements.txt | ||
apparmor.d
Full set of AppArmor profiles
Warning
This project is still in its early development. Help is very welcome; see the documentation website including its development section.
Description
AppArmor.d is a set of over 1500 AppArmor profiles whose aim is to confine most Linux based applications and processes.
Purpose
- Confine all root processes such as all
systemdtools,bluetooth,dbus,polkit,NetworkManager,OpenVPN,GDM,rtkit,colord - Confine all Desktop environments
- Confine all user services such as
Pipewire,Gvfsd,dbus,xdg,xwayland - Confine some "special" user applications: web browser, file browser...
- Should not break a normal usage of the confined software
Goals
- Target both desktops and servers
- Support all distributions that support AppArmor:
- Archlinux
- Ubuntu 22.04
- Debian 12
- OpenSUSE Tumbleweed
- Support major desktop environments:
- Gnome
- KDE
- XFCE (work in progress)
- Fully tested (Work in progress)
This project is originally based on the work from Morfikov and aims to extend it to more Linux distributions and desktop environments.
Concepts
One profile a day keeps the hacker away
There are over 50000 Linux packages and even more applications. It is simply not possible to write an AppArmor profile for all of them. Therefore, a question arises:
What to confine and why?
We take inspiration from the Android/ChromeOS Security Model, and we apply it to the Linux world. Modern Linux security distributions usually consider an immutable core base image with a carefully selected set of applications. Everything else should be sandboxed. Therefore, this project tries to confine all the core applications you will usually find in a Linux system: all systemd services, xwayland, network, Bluetooth, your desktop environment... Non-core user applications are out of scope as they should be sandboxed using a dedicated tool (minijail, bubblewrap, toolbox...).
This is fundamentally different from how AppArmor is usually used on Linux servers as it is common to only confine the applications that face the internet and/or the users.
Presentations
Building large set of AppArmor profiles:
Installation
Please see apparmor.pujol.io/install
Configuration
Please see apparmor.pujol.io/configuration
Usage
Please see apparmor.pujol.io/usage
Contribution
Feedbacks, contributors, pull requests are all very welcome. Please read apparmor.pujol.io/development for more details on the contribution process.
Development chat available on https://matrix.to/#/#apparmor.d:matrix.org
License
This Project was initially based on Mikhail Morfikov's apparmor profiles project and thus has the same license (GPL2).