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.9 KB
Raw Blame
{
  "slug": "private-by-design",
  "order": 2,
  "title": {
    "en": "Private by design",
    "es": "Privado por diseño",
    "pt": "Privado por padrão"
  },
  "tagline": {
    "en": "Installable apps run locked in their own process and ask before touching your camera, microphone or files.",
    "es": "Las apps instalables corren encerradas en su propio proceso y piden permiso antes de tocar tu cámara, micrófono o archivos.",
    "pt": "Apps instaláveis rodam trancados no próprio processo e pedem permissão antes de tocar na câmera, no microfone ou nos arquivos."
  },
  "lumo": {
    "pose": "front",
    "intro": {
      "en": "I'm the one standing at the door. Apps you install get a room of their own, and when they want your camera, your microphone or a file, they have to ask me first, and I ask you.",
      "es": "Yo soy el que está en la puerta. Las apps que instalás tienen su propio cuarto, y cuando quieren tu cámara, tu micrófono o un archivo, primero me lo tienen que pedir a mí, y yo te pregunto a vos.",
      "pt": "Eu sou quem fica na porta. Os apps que você instala ganham um quarto só deles, e quando querem sua câmera, seu microfone ou um arquivo, primeiro precisam pedir para mim, e eu pergunto para você."
    }
  },
  "screenshots": [
    {
      "file": "docs/privacy-prompt-broker.png",
      "caption": {
        "en": "An isolated test app asks for the microphone; the system draws the prompt.",
        "es": "Una app de prueba aislada pide el micrófono; el aviso lo dibuja el sistema.",
        "pt": "Um app de teste isolado pede o microfone; o aviso é desenhado pelo sistema."
      }
    },
    {
      "file": "docs/privacy-rogue-process.png",
      "caption": {
        "en": "The deliberately malicious test app in its own process: every attempt blocked.",
        "es": "La app de prueba maliciosa a propósito, en su propio proceso: todos los intentos bloqueados.",
        "pt": "O app de teste propositalmente malicioso, no próprio processo: todas as tentativas bloqueadas."
      }
    },
    {
      "file": "docs/privacy-file-picker.png",
      "caption": {
        "en": "The system file dialog: lord-server draws it and the app receives only the chosen file.",
        "es": "El diálogo de archivos del sistema: lo dibuja lord-server y la app recibe solo el archivo elegido.",
        "pt": "O diálogo de arquivos do sistema: o lord-server o desenha e o app recebe só o arquivo escolhido."
      }
    },
    {
      "file": "docs/isolation-camera-revoked.png",
      "caption": {
        "en": "After Deny in Settings, the camera stream stopped and the green dot went away.",
        "es": "Después de Denegar en Ajustes, la cámara se cortó y el punto verde desapareció.",
        "pt": "Depois de Negar em Ajustes, a câmera parou e o ponto verde sumiu."
      }
    },
    {
      "file": "docs/privacy-settings.png",
      "caption": {
        "en": "Settings → Privacy: each permission with its apps and an Allow / Ask / Deny control.",
        "es": "Ajustes → Privacidad: cada permiso con sus apps y un control Permitir / Preguntar / Denegar.",
        "pt": "Ajustes → Privacidade: cada permissão com seus apps e um controle Permitir / Perguntar / Negar."
      }
    },
    {
      "file": "docs/protected-window-capture.png",
      "caption": {
        "en": "A protected window comes out black in a LordOS screenshot.",
        "es": "Una ventana protegida sale en negro en una captura de LordOS.",
        "pt": "Uma janela protegida sai preta numa captura do LordOS."
      }
    },
    {
      "file": "docs/sysinfo-probe.png",
      "caption": {
        "en": "System Information → Checks (since 0.8.5): the Sandbox Probe's tries, each refused or flagged.",
        "es": "Información del sistema → Verificaciones (desde 0.8.5): los intentos de la Prueba del aislamiento, cada uno rechazado o señalado.",
        "pt": "Informações do sistema → Verificações (desde a 0.8.5): as tentativas do Teste do isolamento, cada uma recusada ou sinalizada."
      }
    }
  ],
  "diagrams": [
    {
      "id": "permission",
      "kind": "flow",
      "title": {
        "en": "How a permission request travels",
        "es": "Cómo viaja un pedido de permiso",
        "pt": "Como um pedido de permissão viaja"
      },
      "nodes": [
        {
          "id": "app",
          "label": {
            "en": "Isolated app",
            "es": "App aislada",
            "pt": "App isolado"
          },
          "sub": {
            "en": "Asks through the broker socket",
            "es": "Pide por el socket del broker",
            "pt": "Pede pelo socket do broker"
          },
          "tone": "user"
        },
        {
          "id": "broker",
          "label": {
            "en": "Broker in lord-server",
            "es": "Broker en lord-server",
            "pt": "Broker no lord-server"
          },
          "sub": {
            "en": "Looks up the stored decision (perms.c)",
            "es": "Busca la decisión guardada (perms.c)",
            "pt": "Consulta a decisão salva (perms.c)"
          },
          "tone": "ours"
        },
        {
          "id": "prompt",
          "label": {
            "en": "System prompt",
            "es": "Aviso del sistema",
            "pt": "Aviso do sistema"
          },
          "sub": {
            "en": "Only if not decided yet; drawn by the session",
            "es": "Solo si todavía no se decidió; lo dibuja la sesión",
            "pt": "Só se ainda não foi decidido; desenhado pela sessão"
          },
          "tone": "ours"
        },
        {
          "id": "user",
          "label": {
            "en": "You decide",
            "es": "Vos decidís",
            "pt": "Você decide"
          },
          "sub": {
            "en": "Allow or Don't Allow, saved in permisos.json",
            "es": "Permitir o No permitir, guardado en permisos.json",
            "pt": "Permitir ou Não permitir, salvo em permisos.json"
          },
          "tone": "user"
        },
        {
          "id": "enforce",
          "label": {
            "en": "Enforced",
            "es": "Se aplica",
            "pt": "Aplicado"
          },
          "sub": {
            "en": "Broker checks every call; sandbox and kernel block the rest",
            "es": "El broker revisa cada llamada; la caja de arena y el kernel bloquean el resto",
            "pt": "O broker confere cada chamada; o sandbox e o kernel bloqueiam o resto"
          },
          "tone": "kernel"
        },
        {
          "id": "revoke",
          "label": {
            "en": "Revocable",
            "es": "Revocable",
            "pt": "Revogável"
          },
          "sub": {
            "en": "Settings → Privacy; camera and microphone stop at once",
            "es": "Ajustes → Privacidad; cámara y micrófono se cortan al instante",
            "pt": "Ajustes → Privacidade; câmera e microfone param na hora"
          },
          "tone": "allow"
        }
      ],
      "edges": [
        {
          "from": "app",
          "to": "broker",
          "label": {
            "en": "request",
            "es": "pedido",
            "pt": "pedido"
          }
        },
        {
          "from": "broker",
          "to": "prompt",
          "label": {
            "en": "state is Ask",
            "es": "estado Preguntar",
            "pt": "estado Perguntar"
          }
        },
        {
          "from": "prompt",
          "to": "user",
          "label": {
            "en": "shown",
            "es": "se muestra",
            "pt": "exibido"
          }
        },
        {
          "from": "user",
          "to": "enforce",
          "label": {
            "en": "answer",
            "es": "respuesta",
            "pt": "resposta"
          }
        },
        {
          "from": "enforce",
          "to": "revoke",
          "label": {
            "en": "later",
            "es": "después",
            "pt": "depois"
          }
        }
      ],
      "caption": {
        "en": "The app never answers its own prompt: the decision is stored where it can't write, and checked in C on every request.",
        "es": "La app nunca responde su propio aviso: la decisión se guarda donde no puede escribir y se revisa en C en cada pedido.",
        "pt": "O app nunca responde ao próprio aviso: a decisão fica onde ele não pode escrever e é conferida em C a cada pedido."
      }
    },
    {
      "id": "sandbox",
      "kind": "stack",
      "title": {
        "en": "The walls around an installed app",
        "es": "Las paredes alrededor de una app instalada",
        "pt": "As paredes em volta de um app instalado"
      },
      "nodes": [
        {
          "id": "code",
          "label": {
            "en": "The app's code",
            "es": "El código de la app",
            "pt": "O código do app"
          },
          "sub": {
            "en": "Loaded only after the walls are up",
            "es": "Se carga recién cuando las paredes están puestas",
            "pt": "Carregado só depois que as paredes estão de pé"
          },
          "tone": "user"
        },
        {
          "id": "landlock",
          "label": {
            "en": "Landlock",
            "es": "Landlock",
            "pt": "Landlock"
          },
          "sub": {
            "en": "Files: its package read-only, its own data folder read-write, nothing else of your home",
            "es": "Archivos: su paquete de solo lectura, su carpeta de datos de lectura y escritura, nada más de tu carpeta personal",
            "pt": "Arquivos: o pacote só leitura, a pasta de dados leitura e escrita, nada mais da sua pasta pessoal"
          },
          "tone": "kernel"
        },
        {
          "id": "seccomp",
          "label": {
            "en": "seccomp-bpf",
            "es": "seccomp-bpf",
            "pt": "seccomp-bpf"
          },
          "sub": {
            "en": "An allow list of system calls; no exec, ptrace, mount or new sockets",
            "es": "Una lista de llamadas al sistema permitidas; sin exec, ptrace, mount ni sockets nuevos",
            "pt": "Uma lista de chamadas de sistema permitidas; sem exec, ptrace, mount nem sockets novos"
          },
          "tone": "kernel"
        },
        {
          "id": "caps",
          "label": {
            "en": "No privileges",
            "es": "Sin privilegios",
            "pt": "Sem privilégios"
          },
          "sub": {
            "en": "no_new_privs, every capability dropped",
            "es": "no_new_privs, todas las capacidades quitadas",
            "pt": "no_new_privs, todas as capacidades removidas"
          },
          "tone": "kernel"
        },
        {
          "id": "cgroup",
          "label": {
            "en": "cgroup v2 scope",
            "es": "Scope de cgroup v2",
            "pt": "Escopo de cgroup v2"
          },
          "sub": {
            "en": "Root-owned; 512 MB and one core at most; the firewall knows the app by it",
            "es": "De root; 512 MB y un núcleo como máximo; el firewall reconoce la app por él",
            "pt": "Do root; no máximo 512 MB e um núcleo; o firewall reconhece o app por ele"
          },
          "tone": "kernel"
        }
      ],
      "edges": [],
      "caption": {
        "en": "All of this is LordOS's own code calling the kernel directly; no container tool is involved.",
        "es": "Todo esto es código propio de LordOS que llama directamente al kernel; no interviene ninguna herramienta de contenedores.",
        "pt": "Tudo isso é código próprio do LordOS chamando o kernel diretamente; nenhuma ferramenta de contêiner é usada."
      }
    },
    {
      "id": "camera",
      "kind": "flow",
      "title": {
        "en": "The camera without handing over the camera",
        "es": "La cámara sin entregar la cámara",
        "pt": "A câmera sem entregar a câmera"
      },
      "nodes": [
        {
          "id": "dev",
          "label": {
            "en": "/dev/videoN",
            "es": "/dev/videoN",
            "pt": "/dev/videoN"
          },
          "sub": {
            "en": "Opened by lord-server after consent",
            "es": "Lo abre lord-server después del permiso",
            "pt": "Aberto pelo lord-server após o consentimento"
          },
          "tone": "kernel"
        },
        {
          "id": "media",
          "label": {
            "en": "lord-media",
            "es": "lord-media",
            "pt": "lord-media"
          },
          "sub": {
            "en": "Sandboxed decoder; frames into a sealed ring",
            "es": "Decodificador en caja de arena; cuadros a un anillo sellado",
            "pt": "Decodificador em sandbox; quadros num anel selado"
          },
          "tone": "ours"
        },
        {
          "id": "ls",
          "label": {
            "en": "lord-server",
            "es": "lord-server",
            "pt": "lord-server"
          },
          "sub": {
            "en": "Validates every acknowledgement",
            "es": "Valida cada confirmación",
            "pt": "Valida cada confirmação"
          },
          "tone": "ours"
        },
        {
          "id": "app",
          "label": {
            "en": "Isolated app",
            "es": "App aislada",
            "pt": "App isolado"
          },
          "sub": {
            "en": "Read-only view of the frames",
            "es": "Vista de solo lectura de los cuadros",
            "pt": "Visão somente leitura dos quadros"
          },
          "tone": "user"
        }
      ],
      "edges": [
        {
          "from": "dev",
          "to": "media",
          "label": {
            "en": "device fd",
            "es": "fd del dispositivo",
            "pt": "fd do dispositivo"
          }
        },
        {
          "from": "media",
          "to": "ls",
          "label": {
            "en": "frame ring",
            "es": "anillo de cuadros",
            "pt": "anel de quadros"
          }
        },
        {
          "from": "ls",
          "to": "app",
          "label": {
            "en": "read-only reopen",
            "es": "reapertura de solo lectura",
            "pt": "reabertura só leitura"
          }
        }
      ],
      "caption": {
        "en": "Revoking the permission kills the app's lord-media and the stream stops at once.",
        "es": "Revocar el permiso mata el lord-media de la app y la imagen se corta al instante.",
        "pt": "Revogar a permissão encerra o lord-media do app e a imagem para na hora."
      }
    }
  ],
  "sources": [
    {
      "path": "server/src/sec/sandbox.c",
      "what": {
        "en": "Landlock, seccomp, capabilities, network",
        "es": "Landlock, seccomp, capacidades, red",
        "pt": "Landlock, seccomp, capacidades, rede"
      }
    },
    {
      "path": "server/src/sec/brokersrv.c",
      "what": {
        "en": "The broker, server side",
        "es": "El broker, del lado del servidor",
        "pt": "O broker, lado do servidor"
      }
    },
    {
      "path": "server/src/sec/perms.c",
      "what": {
        "en": "Per-app permissions",
        "es": "Permisos por app",
        "pt": "Permissões por app"
      }
    },
    {
      "path": "server/src/sec/brokercam.c",
      "what": {
        "en": "Camera for isolated apps",
        "es": "Cámara para apps aisladas",
        "pt": "Câmera para apps isolados"
      }
    },
    {
      "path": "server/src/sec/restrict.c",
      "what": {
        "en": "Firewall restrictions in the broker",
        "es": "Restricciones del firewall en el broker",
        "pt": "Restrições do firewall no broker"
      }
    },
    {
      "path": "server/src/sec/cgroup.c",
      "what": {
        "en": "Per-app cgroup scopes",
        "es": "Scopes de cgroup por app",
        "pt": "Escopos de cgroup por app"
      }
    },
    {
      "path": "server/src/app/appclient.c",
      "what": {
        "en": "The isolated app process",
        "es": "El proceso de la app aislada",
        "pt": "O processo do app isolado"
      }
    },
    {
      "path": "sdk/powerbox.jsx",
      "what": {
        "en": "The system file dialog",
        "es": "El diálogo de archivos del sistema",
        "pt": "O diálogo de arquivos do sistema"
      }
    },
    {
      "path": "server/tests/sandbox_test.c",
      "what": {
        "en": "Sandbox tests",
        "es": "Pruebas de la caja de arena",
        "pt": "Testes do sandbox"
      }
    },
    {
      "path": "docs/PRIVACY.md",
      "what": {
        "en": "Full design notes",
        "es": "Notas de diseño completas",
        "pt": "Notas de projeto completas"
      }
    },
    {
      "path": "server/src/sec/codesig.c",
      "what": {
        "en": "Verified system code",
        "es": "Código del sistema verificado",
        "pt": "Código do sistema verificado"
      }
    },
    {
      "path": "server/src/app/probe.c",
      "what": {
        "en": "The Sandbox Probe (since 0.8.5)",
        "es": "La Prueba del aislamiento (desde 0.8.5)",
        "pt": "O Teste do isolamento (desde a 0.8.5)"
      }
    }
  ]
}