Tutorial do Debian 13 / Restringir contas de serviço e caminhos de escrita com systemd

Executar serviços no Debian 13 sob contas dedicadas e limitar suas escritas persistentes aos diretórios de estado necessários facilita o gerenciamento. NoNewPrivileges · ProtectSystem · StateDirectory têm funções diferentes, então devem ser aplicados passo a passo, e você precisa distinguir entre o processo estar ativo e a funcionalidade real sendo executada com sucesso.

Separe a propriedade dos arquivos das restrições do serviço

Este tutorial cria um serviço de verificação de escrita apenas de loopback no Debian 13 com systemd 257 e Python 3.13. Contas dedicadas separam a propriedade de arquivos dos outros usuários, e as restrições do systemd limitam ainda mais a visibilidade do sistema de arquivos e o escopo de aquisição de privilégios para esse serviço. Essas restrições podem complementar as políticas baseadas em caminho no laboratório de perfis AppArmor, mas os mecanismos são diferentes.

Configurações Funções a verificar neste exercício
User / Group Executando o processo sob UID (identificador do usuário) e GID (identificador do grupo) dedicados
NoNewPrivileges Evitar a aquisição de novos privilégios através da execução posterior do programa; não bloqueia por si só gravações de arquivos
ProtectSystem=strict Aplicando restrições amplas de somente leitura à visão do sistema de arquivos do serviço
ProtectHome=true Restringindo o acesso a caminhos relacionados à home
PrivateTmp=true Fornecer um diretório temporário separado para o serviço; distinto do isolamento completo do sistema de arquivos
StateDirectory Preparar um caminho de estado persistente de propriedade do serviço e fornecer variáveis de ambiente

Não copie todas as restrições para cada serviço. Executáveis armazenados em diretórios pessoais, arquivos temporários compartilhados com outros programas e caminhos adicionais graváveis podem ser afetados. Verifique o manual systemd.exec do Debian 13 juntamente com o comportamento real do serviço.

Verifique conflitos e crie uma conta de serviço

A nova conta é lf-svc20, e o serviço é lf-service20.service. Não devem existir contas, grupos, unidades ou pastas com os mesmos nomes. Não sobrescreva nem remova itens existentes encontrados nas consultas abaixo com este exemplo.

getent passwd lf-svc20
getent group lf-svc20
systemctl show lf-service20.service -p LoadState
ls -ld /var/lib/lf-service20 /opt/lf-service20-scratch
ls -l /usr/local/libexec/lf-service20.py
sudo ss -lntp 'sport = :8080'
python3 --version
curl --version

Condições iniciais: consultas de conta/grupo não retornam correspondência, a unidade exibe LoadState=not-found, arquivos não existem, e a porta 8080 não possui linhas de escuta. Se Python ou curl estiverem ausentes, verifique a lista de alterações do pacote e prepare com sudo apt install --no-install-recommends python3 curl. Para caminhos e configurações de serviço, use unidade systemd e procedimentos de aplicação drop-in.

sudo adduser --system --group --no-create-home --home /nonexistent --shell /usr/sbin/nologin lf-svc20
getent passwd lf-svc20
id lf-svc20
sudo passwd -S lf-svc20
sudo install -d -m 750 -o lf-svc20 -g lf-svc20 /opt/lf-service20-scratch
sudo install -d /usr/local/libexec

Crie contas e grupos do sistema com o mesmo nome, e não use um shell de login normal nem crie um diretório home. Não dê ao novo usuário um grupo sudo ou senha de login. UID e GID são atribuídos automaticamente, então não fixe os identificadores nos números de um exemplo. O shell nologin é uma configuração para distingui-lo dos logins interativos e não impede que o systemd execute programas com esse UID. Para o comportamento de criação de contas, consulte a documentação do adduser do Debian.

/opt/lf-service20-scratch é uma pasta para comparação. Dê à conta dedicada permissão comum de escrita para este diretório e, mais tarde, verifique se a restrição de somente leitura aplicada ao serviço impede a escrita. Não use arquivos reais de aplicação.

Escreva o programa completo de teste de escrita HTTP

Salve todo o conteúdo a seguir em sudo nano /usr/local/libexec/lf-service20.py. Você pode usar editores diferentes do nano. Mantenha o executável como propriedade do administrador e permita acesso somente leitura para a conta de serviço.

import json
import os
from http.server import BaseHTTPRequestHandler, HTTPServer
from pathlib import Path

def write_probe(path):
    try:
        path.write_text("write-probe-ok\n", encoding="utf-8")
        return {"ok": True, "errno": None}
    except OSError as error:
        return {"ok": False, "errno": error.errno}

class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
        if self.path != "/health":
            self.send_error(404)
            return
        required_dir = Path(os.environ.get("LF_WRITE_DIR", os.environ["STATE_DIRECTORY"]))
        required = write_probe(required_dir / "required.txt")
        outside = write_probe(Path("/opt/lf-service20-scratch/outside.txt"))
        payload = json.dumps({"uid": os.getuid(), "required": required, "outside": outside}).encode()
        self.send_response(200 if required["ok"] else 503)
        self.send_header("Content-Type", "application/json")
        self.send_header("Content-Length", str(len(payload)))
        self.end_headers()
        self.wfile.write(payload)

HTTPServer(("127.0.0.1", 8080), Handler).serve_forever()

Este programa realiza duas escritas de teste para cada requisição ao /health. A resposta usa JSON (JavaScript Object Notation), um formato de dados estruturados. O campo required contém o resultado da escrita no diretório de estado necessário; outside contém o resultado no diretório de comparação. Se a escrita requerida falhar, ele foi projetado para retornar HTTP 503 em vez de encerrar o processo. Esse comportamento é para prática, para observar erros, e não é geralmente recomendado escrever arquivos toda vez durante verificações de status operacionais.

Como ele utiliza o STATE_DIRECTORY fornecido pelo systemd, ele é executado pela unidade abaixo. Não inicie o programa diretamente em um terminal sem essa variável: use a unidade abaixo. Apenas a biblioteca padrão é usada, portanto, a instalação pelo pip não é necessária. Ele escuta somente no loopback e não é um servidor web de produção.

sudo chmod 644 /usr/local/libexec/lf-service20.py
ls -l /usr/local/libexec/lf-service20.py

Crie o serviço base e seu diretório de estado

Salve-o em sudo nano /etc/systemd/system/lf-service20.service.

[Unit]
Description=Lesson 20 service write probe

[Service]
Type=exec
User=lf-svc20
Group=lf-svc20
ExecStart=/usr/bin/python3 /usr/local/libexec/lf-service20.py
StateDirectory=lf-service20
StateDirectoryMode=0750
UMask=0027

[Install]
WantedBy=multi-user.target

O StateDirectory=lf-service20 do serviço do sistema prepara /var/lib/lf-service20, e neste exemplo, o usuário e grupo especificados e o modo 0750 são utilizados. O caminho é passado para o programa como a variável de ambiente STATE_DIRECTORY. O código e a configuração são de propriedade do administrador, enquanto os arquivos de estado modificáveis são de propriedade de uma conta dedicada para diferenciar a propriedade.

sudo systemd-analyze verify /etc/systemd/system/lf-service20.service
sudo systemctl daemon-reload
sudo systemctl start lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/health
sudo stat -c '%U:%G %a %n' /var/lib/lf-service20
systemctl show lf-service20.service -p User -p Group -p MainPID

Após a inicialização normal, espera-se HTTP 200, com ok: true nos campos required e outside. A pasta de estado é exibida como lf-svc20:lf-svc20 com modo 750. Como ainda não há restrições no sistema de arquivos, o processo também consegue escrever no diretório de comparação. O curto atraso até a porta ficar pronta imediatamente após a inicialização é tratado com tentativas limitadas de curl, e se continuar falhando, verifique os erros no journal.

Aplique restrições de privilégios e do sistema de arquivos em etapas

Primeiro, consulte ls -ld /etc/systemd/system/lf-service20.service.d e confirme que o diretório de drop-ins também não existe. Se existir, pare e examine seu conteúdo e proprietário. Depois, crie a pasta com sudo install -d /etc/systemd/system/lf-service20.service.d e salve o conteúdo abaixo usando sudo nano /etc/systemd/system/lf-service20.service.d/20-privileges.conf.

[Service]
NoNewPrivileges=true
sudo systemctl daemon-reload
sudo systemctl restart lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/health
service_pid=$(systemctl show lf-service20.service -p MainPID --value)
sudo grep '^NoNewPrivs:' /proc/"$service_pid"/status

Verifique se ambas as gravações continuam a ter sucesso e se NoNewPrivs está definido como 1. Esta opção impede que o processo e seus filhos obtenham novos privilégios ao executar outro programa. Por exemplo, ela visa impedir a obtenção de privilégios por meio de configurações setuid que permitem a execução com os privilégios do proprietário do arquivo. Não deve ser interpretado que todo o acesso a arquivos está restrito apenas porque esta opção está ativada. Em seguida, grave sudo nano /etc/systemd/system/lf-service20.service.d/30-filesystem.conf.

[Service]
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
sudo systemd-analyze verify /etc/systemd/system/lf-service20.service
sudo systemctl daemon-reload
sudo systemctl restart lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/health
systemctl show lf-service20.service -p NoNewPrivileges -p ProtectSystem -p ProtectHome -p PrivateTmp -p StateDirectory

Espera-se HTTP 200, com ok: true em required e ok: false em outside. No teste original, errno (número de erro do sistema) valia 30 para outside, indicando um erro de escrita em um sistema de arquivos somente leitura. O caminho preparado como STATE_DIRECTORY permanece gravável como uma exceção, enquanto o caminho /opt usado para comparação torna-se somente leitura do ponto de vista do serviço.

Neste cenário, nem todos os caminhos escritos pelo serviço estão limitados a uma única pasta de estado. /tmp e /var/tmp, separados com PrivateTmp, também são graváveis, e os sistemas de arquivos de interface do kernel, como /dev, /proc e /sys e quaisquer outras exceções explícitas também devem ser considerados. Este exercício compara a limitação de gravações em caminhos gerais desnecessários, enquanto mantém os caminhos de estado persistentes necessários.

Isso não torna todo o sistema de arquivos do host somente leitura. Para comparar a escrita fora do serviço com o mesmo UID, você pode criar e depois excluir arquivos separados da seguinte forma.

sudo -u lf-svc20 touch /opt/lf-service20-scratch/from-normal-context
sudo rm -- /opt/lf-service20-scratch/from-normal-context

Mesmo que a escrita seja possível com permissões gerais, os resultados diferem no ambiente de execução isolado do serviço. É possível revisar exceções adicionais com ReadWritePaths, mas essa opção não concede propriedade ou modo do próprio arquivo. Verifique os caminhos realmente necessários e, se o caminho do estado padrão for suficiente, não expanda as exceções.

Observe um serviço ativo retornando HTTP 503

Para criar um exemplo onde recursos e restrições entram em conflito, especifique incorretamente apenas um caminho de escrita necessário. Salve-o em sudo nano /etc/systemd/system/lf-service20.service.d/90-wrong-path.conf.

[Service]
Environment=LF_WRITE_DIR=/opt/lf-service20-scratch
sudo systemctl daemon-reload
sudo systemctl restart lf-service20.service
systemctl is-active lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -sS -i http://127.0.0.1:8080/health
sudo journalctl -u lf-service20.service -b --no-pager -n 20

O serviço está ativo, mas retorna HTTP 503, e o campo ok de required passa a false. No teste original, errno 30 para o caminho necessário e HTTP 503 foram confirmados. O fato de o processo poder receber solicitações é diferente do fato de que a funcionalidade de armazenamento necessária está normal. Nesta solicitação, o --fail do curl não foi usado para visualizar o corpo do erro.

Em vez de remover todas as restrições de segurança, restaure o caminho especificado incorretamente. Remova apenas o arquivo de exemplo com falha desta vez e reinicie.

sudo rm -- /etc/systemd/system/lf-service20.service.d/90-wrong-path.conf
sudo systemctl daemon-reload
sudo systemctl restart lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/health
systemctl show lf-service20.service -p ProtectSystem -p NoNewPrivileges

Confirme que a escrita required volta a funcionar e a resposta é HTTP 200, mantendo ProtectSystem=strict e NoNewPrivileges=yes. Não exclua outros arquivos suplementares. Ao diagnosticar falhas de acesso em um serviço real, considere também UID e GID, permissões gerais de arquivos, restrições de caminho do serviço e logs do AppArmor, modificando apenas as condições que falharam.

Verifique a persistência do estado e limpe o laboratório

Arquivos no StateDirectory não são automaticamente deletados quando o serviço é interrompido. Após verificar os arquivos de estado atuais, verifique se a escrita volta a funcionar após iniciar o serviço novamente.

sudo systemctl stop lf-service20.service
sudo cat /var/lib/lf-service20/required.txt
sudo systemctl start lf-service20.service
curl --noproxy '*' --retry 5 --retry-connrefused --retry-delay 1 --max-time 10 -fsS http://127.0.0.1:8080/health

A persistência da pasta de estado neste exemplo foi confirmada no teste original ao parar e iniciar o serviço, sem um teste de reinicialização da VM. A configuração do link de inicialização do serviço é separada, então este exercício manteve-o em um estado iniciado manualmente. Ao excluir dados operacionais, é importante distinguir que excluir unidades e excluir dados são ações separadas.

Ao finalizar o exercício, pare o serviço primeiro e remova apenas esses arquivos. A exclusão de dados abaixo assume que existem apenas os arquivos de teste recém-criados mencionados neste texto.

sudo systemctl disable --now lf-service20.service
sudo rm -- /etc/systemd/system/lf-service20.service.d/20-privileges.conf /etc/systemd/system/lf-service20.service.d/30-filesystem.conf
sudo rmdir -- /etc/systemd/system/lf-service20.service.d
sudo rm -- /etc/systemd/system/lf-service20.service /usr/local/libexec/lf-service20.py
sudo systemctl daemon-reload
sudo rm -- /var/lib/lf-service20/required.txt /opt/lf-service20-scratch/outside.txt
sudo rmdir -- /var/lib/lf-service20 /opt/lf-service20-scratch
sudo userdel lf-svc20
getent passwd lf-svc20
getent group lf-svc20
sudo ss -lntp 'sport = :8080'

Confirme que a conta foi removida e que nada está escutando na porta do laboratório. Se um grupo dedicado com o mesmo nome permanecer e não for usado por outra conta, remova apenas esse grupo com sudo groupdel lf-svc20. Se a pasta não estiver vazia, verifique outros arquivos e não a trate com exclusão recursiva. A exclusão da conta não inclui uma função para encontrar e excluir todos os dados do UID, portanto, mantenha a ordem de primeiro limpar os caminhos dos dados que você criou.