LordOS — a free, fast and secure GNU/Linux distribution based on Debian, with its own desktop environment: display server and Wayland compositor in C, a React UI engine on QuickJS, and private native apps.
C cdebiandesktop-environmentebpffirewalllandlocklinuxlinux-distributionopen-sourceprivacyquickjsraspberry-pi-5reactsecuritywaylandwayland-compositor
{
"slug": "visible-firewall",
"order": 3,
"title": {
"en": "A firewall you can see",
"es": "Un firewall que podés ver",
"pt": "Um firewall que você pode ver"
},
"tagline": {
"en": "See every app's connections on a live map, then allow, block or limit each app, enforced in the kernel.",
"es": "Mirá las conexiones de cada app en un mapa en vivo y después permití, bloqueá o limitá cada app, con reglas que aplica el kernel.",
"pt": "Veja as conexões de cada app num mapa ao vivo e depois permita, bloqueie ou limite cada app, com regras aplicadas pelo kernel."
},
"lumo": {
"pose": "shield",
"intro": {
"en": "This is my favourite room: the map! I watch every app that talks to the internet, and when you say an app may not, I make sure the kernel itself says no.",
"es": "Esta es mi habitación favorita: ¡el mapa! Vigilo cada app que habla con internet, y cuando decís que una app no puede, me aseguro de que el propio kernel diga que no.",
"pt": "Este é meu cômodo favorito: o mapa! Eu vigio cada app que fala com a internet, e quando você diz que um app não pode, garanto que o próprio kernel diga não."
}
},
"screenshots": [
{
"file": "docs/screenshots/monitor-network-map.png",
"caption": {
"en": "Monitor → Network: apps on the left, their destinations on a world map, the summary on the right.",
"es": "Monitor → Red: las apps a la izquierda, sus destinos en un mapa del mundo y el resumen a la derecha.",
"pt": "Monitor → Rede: os apps à esquerda, os destinos num mapa-múndi e o resumo à direita."
}
},
{
"file": "docs/firewall-monitor-denied.png",
"caption": {
"en": "The Rule switch set to deny for one app, with the kernel's allowed and denied counters.",
"es": "El interruptor de Regla en denegar para una app, con los contadores de permitidas y denegadas del kernel.",
"pt": "O botão de Regra em negar para um app, com os contadores de permitidas e negadas do kernel."
}
},
{
"file": "docs/firewall-settings.png",
"caption": {
"en": "Settings → Privacy → App network access: the mode, Trusted apps and Restricted apps.",
"es": "Ajustes → Red de las apps: el modo, las apps de confianza y las restringidas.",
"pt": "Ajustes → Rede dos apps: o modo, os apps confiáveis e os restritos."
}
},
{
"file": "docs/firewall-escape-blocked.png",
"caption": {
"en": "Escape attempts through the user's service manager, all denied.",
"es": "Intentos de escape a través del gestor de servicios del usuario, todos denegados.",
"pt": "Tentativas de fuga pelo gerenciador de serviços do usuário, todas negadas."
}
},
{
"file": "docs/firewall-app-denied.png",
"caption": {
"en": "A denied app: its commands get \"Operation not permitted\".",
"es": "Una app denegada: sus comandos reciben \"Operation not permitted\".",
"pt": "Um app negado: os comandos recebem \"Operation not permitted\"."
}
}
],
"diagrams": [
{
"id": "path",
"kind": "flow",
"title": {
"en": "The path of a connection or a device",
"es": "El camino de una conexión o un dispositivo",
"pt": "O caminho de uma conexão ou de um dispositivo"
},
"nodes": [
{
"id": "socket",
"label": {
"en": "App opens a connection or a device",
"es": "La app abre una conexión o un dispositivo",
"pt": "O app abre uma conexão ou um dispositivo"
},
"sub": {
"en": "connect, sendto, bind, socket, or open() of a device node",
"es": "connect, sendto, bind, socket u open() de un nodo de dispositivo",
"pt": "connect, sendto, bind, socket ou open() de um nó de dispositivo"
},
"tone": "user"
},
{
"id": "hook",
"label": {
"en": "eBPF programs in the kernel",
"es": "Programas eBPF en el kernel",
"pt": "Programas eBPF no kernel"
},
"sub": {
"en": "cgroup network hooks; cgroup/dev for camera, USB, ALSA capture and /dev/fb; BPF LSM socket_create for Bluetooth. The app is found by its scope",
"es": "Ganchos de red de cgroup; cgroup/dev para cámara, USB, captura ALSA y /dev/fb; BPF LSM socket_create para Bluetooth. La app se reconoce por su scope",
"pt": "Ganchos de rede do cgroup; cgroup/dev para câmera, USB, captura ALSA e /dev/fb; BPF LSM socket_create para Bluetooth. O app é reconhecido pelo escopo"
},
"tone": "kernel"
},
{
"id": "rule",
"label": {
"en": "Per-app rules",
"es": "Reglas por app",
"pt": "Regras por app"
},
"sub": {
"en": "Restrictions first, then the most specific rule, then trusted, then mode",
"es": "Primero las restricciones, luego la regla más específica, luego confianza, luego el modo",
"pt": "Primeiro as restrições, depois a regra mais específica, depois confiança, depois o modo"
},
"tone": "ours"
},
{
"id": "verdict",
"label": {
"en": "Allow or deny",
"es": "Permitir o denegar",
"pt": "Permitir ou negar"
},
"sub": {
"en": "Denied: the app gets EPERM",
"es": "Denegada: la app recibe EPERM",
"pt": "Negada: o app recebe EPERM"
},
"tone": "deny"
},
{
"id": "monitor",
"label": {
"en": "Monitor map",
"es": "Mapa del Monitor",
"pt": "Mapa do Monitor"
},
"sub": {
"en": "New connections, denials and counters, once per second",
"es": "Conexiones nuevas, rechazos y contadores, una vez por segundo",
"pt": "Conexões novas, negações e contadores, uma vez por segundo"
},
"tone": "ours"
}
],
"edges": [
{
"from": "socket",
"to": "hook",
"label": {
"en": "system call",
"es": "llamada al sistema",
"pt": "chamada de sistema"
}
},
{
"from": "hook",
"to": "rule",
"label": {
"en": "map lookup",
"es": "búsqueda en el mapa",
"pt": "consulta ao mapa"
}
},
{
"from": "rule",
"to": "verdict",
"label": {
"en": "decision",
"es": "decisión",
"pt": "decisão"
}
},
{
"from": "verdict",
"to": "monitor",
"label": {
"en": "ring buffer",
"es": "anillo de eventos",
"pt": "anel de eventos"
}
}
],
"caption": {
"en": "The decision happens in the kernel when a connection, a socket or a device opens; nothing runs per packet.",
"es": "La decisión ocurre en el kernel cuando se abre una conexión, un socket o un dispositivo; nada corre por cada paquete.",
"pt": "A decisão acontece no kernel quando abre uma conexão, um socket ou um dispositivo; nada roda por pacote."
}
},
{
"id": "restrictions",
"kind": "stack",
"title": {
"en": "Where each restriction is enforced",
"es": "Dónde se aplica cada restricción",
"pt": "Onde cada restrição é aplicada"
},
"nodes": [
{
"id": "broker",
"label": {
"en": "Broker in lord-server",
"es": "Broker en lord-server",
"pt": "Broker no lord-server"
},
"sub": {
"en": ".lpk apps and Passwords: all eight restrictions, refused without a prompt",
"es": "Apps .lpk y Contraseñas: las ocho restricciones, rechazadas sin aviso",
"pt": "Apps .lpk e Senhas: as oito restrições, recusadas sem aviso"
},
"tone": "ours"
},
{
"id": "launcher",
"label": {
"en": "App launcher",
"es": "Lanzador de apps",
"pt": "Lançador de apps"
},
"sub": {
"en": "Linux apps, no access to your files: own user, mount and PID namespaces, a tmpfs home and Landlock, from the next launch",
"es": "Apps de Linux, sin acceso a tus archivos: espacios de nombres de usuario, montaje y PID propios, un home en tmpfs y Landlock, desde el próximo inicio",
"pt": "Apps Linux, sem acesso aos seus arquivos: namespaces próprios de usuário, montagem e PID, uma home em tmpfs e Landlock, a partir da próxima abertura"
},
"tone": "ours"
},
{
"id": "notifyd",
"label": {
"en": "Notification server (notifyd)",
"es": "Servidor de notificaciones (notifyd)",
"pt": "Servidor de notificações (notifyd)"
},
"sub": {
"en": "Linux apps' notifications: the sender's identity comes from the bus; failures drop it",
"es": "Notificaciones de apps de Linux: la identidad del remitente la da el bus; si algo falla, se descarta",
"pt": "Notificações de apps Linux: a identidade do remetente vem do barramento; se algo falha, é descartada"
},
"tone": "ours"
},
{
"id": "pwguard",
"label": {
"en": "PipeWire guard (pwguard)",
"es": "Guardia de PipeWire (pwguard)",
"pt": "Guarda do PipeWire (pwguard)"
},
"sub": {
"en": "Microphone and camera through PipeWire: identity from the socket's credentials, applied live",
"es": "Micrófono y cámara por PipeWire: identidad tomada de las credenciales del socket, en vivo",
"pt": "Microfone e câmera pelo PipeWire: identidade tirada das credenciais do socket, ao vivo"
},
"tone": "ours"
},
{
"id": "kernel",
"label": {
"en": "lord-netperm's eBPF programs in the kernel",
"es": "Programas eBPF de lord-netperm en el kernel",
"pt": "Programas eBPF do lord-netperm no kernel"
},
"sub": {
"en": "Network hooks; cgroup/dev for camera, USB, ALSA capture and /dev/fb; BPF LSM socket_create for Bluetooth sockets",
"es": "Ganchos de red; cgroup/dev para cámara, USB, captura ALSA y /dev/fb; BPF LSM socket_create para sockets Bluetooth",
"pt": "Ganchos de rede; cgroup/dev para câmera, USB, captura ALSA e /dev/fb; BPF LSM socket_create para sockets Bluetooth"
},
"tone": "kernel"
}
],
"edges": [],
"caption": {
"en": "Each restriction is checked where the resource is handed out, against the app's root-owned scope, never against a name the app gives itself.",
"es": "Cada restricción se revisa donde se entrega el recurso, contra el scope de la app, que es de root, nunca contra un nombre que la app se da a sí misma.",
"pt": "Cada restrição é conferida onde o recurso é entregue, contra o escopo do app, que é do root, nunca contra um nome que o app dá a si mesmo."
}
},
{
"id": "dns",
"kind": "flow",
"title": {
"en": "Where domain names come from",
"es": "De dónde salen los nombres de dominio",
"pt": "De onde vêm os nomes de domínio"
},
"nodes": [
{
"id": "resolver",
"label": {
"en": "System resolver",
"es": "Resolvedor del sistema",
"pt": "Resolvedor do sistema"
},
"sub": {
"en": "systemd-resolved, or replies from port 53 of the configured servers",
"es": "systemd-resolved, o respuestas del puerto 53 de los servidores configurados",
"pt": "systemd-resolved, ou respostas da porta 53 dos servidores configurados"
},
"tone": "reused"
},
{
"id": "reader",
"label": {
"en": "Strict DNS reader",
"es": "Lector DNS estricto",
"pt": "Leitor DNS estrito"
},
"sub": {
"en": "Only the chain that follows from the question",
"es": "Solo la cadena que sale de la pregunta",
"pt": "Só a cadeia que decorre da pergunta"
},
"tone": "ours"
},
{
"id": "maps",
"label": {
"en": "Address entries",
"es": "Entradas por dirección",
"pt": "Entradas por endereço"
},
"sub": {
"en": "One kernel map node per learned address",
"es": "Un nodo del mapa del kernel por dirección aprendida",
"pt": "Um nó do mapa do kernel por endereço aprendido"
},
"tone": "kernel"
},
{
"id": "nope",
"label": {
"en": "App's own DNS",
"es": "DNS propio de la app",
"pt": "DNS próprio do app"
},
"sub": {
"en": "Never learned: such addresses don't match an allow rule",
"es": "Nunca se aprende: esas direcciones no coinciden con una regla de permitir",
"pt": "Nunca é aprendido: esses endereços não batem com regra de permitir"
},
"tone": "deny"
}
],
"edges": [
{
"from": "resolver",
"to": "reader",
"label": {
"en": "answers",
"es": "respuestas",
"pt": "respostas"
}
},
{
"from": "reader",
"to": "maps",
"label": {
"en": "name → IP",
"es": "nombre → IP",
"pt": "nome → IP"
}
}
],
"caption": {
"en": "Domain rules trust only answers the system resolver received, never packets an app received itself.",
"es": "Las reglas por dominio solo confían en respuestas que recibió el resolvedor del sistema, nunca en paquetes que recibió la app.",
"pt": "Regras por domínio só confiam em respostas recebidas pelo resolvedor do sistema, nunca em pacotes recebidos pelo próprio app."
}
}
],
"sources": [
{
"path": "server/src/netperm/np.bpf.c",
"what": {
"en": "The cgroup and LSM eBPF programs",
"es": "Los programas eBPF de cgroup y LSM",
"pt": "Os programas eBPF de cgroup e LSM"
}
},
{
"path": "server/src/netperm/netperm.c",
"what": {
"en": "The root service lord-netperm",
"es": "El servicio root lord-netperm",
"pt": "O serviço root lord-netperm"
}
},
{
"path": "server/src/netperm/npcompile.c",
"what": {
"en": "Rules compiled into kernel maps",
"es": "Reglas compiladas a mapas del kernel",
"pt": "Regras compiladas em mapas do kernel"
}
},
{
"path": "server/src/netperm/npdns.c",
"what": {
"en": "Names from the system resolver",
"es": "Nombres desde el resolvedor del sistema",
"pt": "Nomes do resolvedor do sistema"
}
},
{
"path": "server/src/fw/rules.c",
"what": {
"en": "Rules, precedence and the file reader",
"es": "Reglas, precedencia y lector del archivo",
"pt": "Regras, precedência e leitor do arquivo"
}
},
{
"path": "server/src/ui/js_fw.c",
"what": {
"en": "lord.fw, the session API",
"es": "lord.fw, la API de la sesión",
"pt": "lord.fw, a API da sessão"
}
},
{
"path": "apps/monitor/FwRules.jsx",
"what": {
"en": "Network rules by app in Settings",
"es": "Reglas de red por app en Ajustes",
"pt": "Regras de rede por app nos Ajustes"
}
},
{
"path": "server/src/sec/restrict.c",
"what": {
"en": "Restrictions in the broker",
"es": "Restricciones en el broker",
"pt": "Restrições no broker"
}
},
{
"path": "server/src/sec/pwguard.c",
"what": {
"en": "The PipeWire guard",
"es": "La guardia de PipeWire",
"pt": "O guarda do PipeWire"
}
},
{
"path": "server/tests/netperm_integration.sh",
"what": {
"en": "Kernel integration test",
"es": "Prueba de integración con el kernel",
"pt": "Teste de integração com o kernel"
}
},
{
"path": "docs/FIREWALL.md",
"what": {
"en": "Full design and measurements",
"es": "Diseño completo y mediciones",
"pt": "Projeto completo e medições"
}
}
]
}