Skip to content

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.

16.8 KB
Raw Blame
{
  "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"
      }
    }
  ]
}