Debian 13 강좌 / 서비스 계정과 systemd 쓰기 경로 제한
Debian 13의 서비스는 전용 계정으로 실행하고, 실제로 필요한 상태 폴더만 쓸 수 있도록 범위를 좁히면 관리하기 쉽습니다. NoNewPrivileges·ProtectSystem·StateDirectory는 역할이 다르므로 단계별로 적용하고, 프로세스가 active인 것과 실제 기능이 성공하는 것을 구분해 확인해야 합니다.
전용 계정과 서비스별 제한의 역할
이 강좌는 Debian 13의 systemd 257과 Python 3.13에서 루프백 전용 쓰기 검사 서비스를 만듭니다. 전용 계정은 다른 사용자와 파일 소유권을 분리하고, systemd 제한은 그 서비스가 보는 파일 시스템과 권한 획득 범위를 추가로 제한합니다. AppArmor 프로파일의 경로 기반 접근 정책과 함께 사용할 수 있지만 같은 기능은 아닙니다.
| 설정 | 이 실습에서 확인할 역할 |
|---|---|
| User / Group | 전용 UID·GID로 프로세스 실행 |
| NoNewPrivileges | 이후 실행으로 새 권한을 얻는 경로 제한; 파일 쓰기 자체를 막는 옵션은 아님 |
| ProtectSystem=strict | 서비스의 파일 시스템 보기에서 광범위한 읽기 전용 제한 적용 |
| ProtectHome=true | 홈 관련 경로 접근 제한 |
| PrivateTmp=true | 서비스에 분리된 임시 디렉터리 제공; 전체 파일 시스템 격리와는 구분 |
| StateDirectory | 서비스 소유의 지속 상태 경로 준비와 환경 변수 제공 |
모든 서비스에 제한 옵션을 한꺼번에 복사하지 마세요. 홈에 있는 실행 파일, 다른 프로그램과 공유하는 임시 파일, 추가로 필요한 쓰기 경로가 있으면 동작이 바뀔 수 있습니다. Debian 13 systemd.exec 설명서와 실제 실행 결과를 함께 확인합니다.
경로 충돌 확인과 로그인하지 않는 계정 생성
새 계정은 lf-svc20, 서비스는 lf-service20.service입니다. 기존에 같은 계정·그룹·유닛·폴더가 없어야 합니다. 아래 조회에서 발견되는 기존 항목은 이 예제로 덮어쓰거나 제거하지 않습니다.
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
계정·그룹 조회는 미일치, 유닛은 not-found, 파일은 없음, 8080에는 수신 행 없음이 시작 조건입니다. Python·curl이 없다면 패키지 변경 목록을 확인하여 sudo apt install --no-install-recommends python3 curl로 준비합니다. 경로와 서비스 설정은 systemd 유닛과 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
시스템용 계정·같은 이름의 그룹을 만들고 일반 로그인 셸과 홈 생성은 사용하지 않습니다. 새 계정에 sudo 그룹이나 로그인 비밀번호를 주지 않습니다. UID·GID는 자동 할당되므로 예제 숫자를 고정하지 마세요. nologin 셸은 대화형 로그인 용도와 구분하기 위한 설정이며 systemd가 해당 UID로 프로그램을 실행하는 것을 막지 않습니다. 계정 생성 동작은 Debian adduser 설명서를 참고하세요.
/opt/lf-service20-scratch는 비교용 폴더입니다. 전용 계정이 일반 권한으로는 쓸 수 있게 만들고, 이후 서비스의 읽기 전용 제한이 쓰기를 막는지 확인합니다. 실제 애플리케이션 파일은 사용하지 않습니다.
쓰기 결과를 HTTP로 확인하는 전체 프로그램
sudo nano /usr/local/libexec/lf-service20.py에서 다음 전체 내용을 저장합니다. nano 대신 다른 편집기도 사용할 수 있습니다. 실행 파일은 관리자 소유로 유지하고 서비스 계정에는 읽기만 허용합니다.
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()
이 프로그램은 /health 요청마다 두 개의 테스트 쓰기를 수행합니다. required는 서비스의 필수 상태 경로, outside는 비교용 경로의 결과입니다. 필수 쓰기에 실패하면 프로세스를 종료하는 대신 HTTP 503을 돌려주도록 만들었습니다. 이 동작은 오류 관찰을 위한 실습 설계이며, 운영 상태 점검에 파일을 매번 쓰는 방식을 일반적으로 권장하는 것은 아닙니다.
systemd가 제공할 STATE_DIRECTORY를 사용하므로 아래 유닛을 통해 실행합니다. 터미널에서 환경 변수 없이 직접 실행하는 경로를 이 예제의 시작 방법으로 사용하지 않습니다. 표준 라이브러리만 사용하므로 pip 설치는 필요하지 않습니다. 루프백에서만 수신하며 운영용 웹 서버가 아닙니다.
sudo chmod 644 /usr/local/libexec/lf-service20.py
ls -l /usr/local/libexec/lf-service20.py
기본 서비스와 상태 경로 확인
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
시스템 서비스의 StateDirectory=lf-service20는 /var/lib/lf-service20를 준비하며, 이 예제에서는 지정한 사용자·그룹과 0750 모드를 사용합니다. 경로는 프로그램에 STATE_DIRECTORY 환경 변수로 전달됩니다. 코드와 설정은 관리자 소유, 변경 가능한 상태 파일은 전용 계정 소유로 구분합니다.
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
정상 시작 후 HTTP 200과 required·outside 모두 ok: true가 예상됩니다. 상태 폴더는 lf-svc20:lf-svc20·750으로 표시됩니다. 아직 파일 시스템 제한이 없어 비교용 폴더에도 쓸 수 있습니다. 시작 직후 포트가 준비되는 짧은 차이는 제한된 curl 재시도로 처리하며, 계속 실패하면 journal의 오류를 확인합니다.
권한 획득 제한과 파일 시스템 제한을 단계별 적용
먼저 sudo install -d /etc/systemd/system/lf-service20.service.d로 폴더를 만들고, 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
두 쓰기는 계속 성공하고 NoNewPrivs는 1로 표시되는지 확인합니다. 이 옵션은 프로세스와 자식이 다른 프로그램을 실행하며 새 권한을 얻는 경로를 제한합니다. 예를 들어 파일 소유자의 권한으로 실행하도록 하는 setuid 설정을 통한 권한 획득이 대상입니다. 이 옵션이 켜졌다는 이유로 모든 파일 접근이 제한되었다고 해석하면 안 됩니다. 이어 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
HTTP 200, required의 ok: true, outside의 ok: false가 예상됩니다. 실습에서는 outside의 errno가 30, 즉 읽기 전용 파일 시스템에 대한 쓰기 오류로 나타났습니다. STATE_DIRECTORY로 준비한 경로는 쓰기 가능한 예외로 유지되지만, 비교용 /opt 경로는 서비스의 보기에서 읽기 전용이 됩니다.
이 설정에서 서비스가 쓰는 모든 경로가 상태 폴더 하나로 한정되는 것은 아닙니다. PrivateTmp로 분리한 /tmp·/var/tmp도 쓰기 가능하며, API 파일 시스템과 다른 명시적 예외도 구분해야 합니다. 이 실습은 필요한 영구 상태 경로를 유지하면서 불필요한 일반 경로의 쓰기를 제한하는 비교입니다.
이는 호스트의 파일 시스템 전체를 읽기 전용으로 바꾼 것이 아닙니다. 같은 UID로 서비스 밖에서 쓰는 것을 비교하려면 다음처럼 별도 파일을 만들었다가 지울 수 있습니다.
sudo -u lf-svc20 touch /opt/lf-service20-scratch/from-normal-context
sudo rm -- /opt/lf-service20-scratch/from-normal-context
일반 권한상 쓰기가 가능하더라도 서비스의 격리된 실행 환경에서는 결과가 달라지는 비교입니다. ReadWritePaths로 추가 예외를 검토할 수는 있지만, 그 옵션이 파일의 소유권·모드 자체를 부여하는 것은 아닙니다. 실제 필요한 경로를 확인하고 기본 상태 경로로 충분한 경우에는 예외를 넓히지 않습니다.
잘못된 필수 경로와 active·503 비교
기능과 제한이 충돌하는 예를 만들기 위해 필수 쓰기 경로만 잘못 지정합니다. 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
서비스는 active지만 HTTP 503이고 required 쓰기도 false가 됩니다. 이 실습에서는 필수 경로의 errno 30과 HTTP 503을 확인했습니다. 프로세스가 요청을 받을 수 있다는 사실과 필요한 저장 기능이 정상이라는 사실은 다릅니다. 이 요청에서는 오류 본문을 보기 위해 curl의 --fail을 사용하지 않았습니다.
보안 제한을 전부 지우기보다 잘못 지정한 경로를 되돌립니다. 이번 실패 예시 파일만 제거하고 재시작합니다.
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
required 쓰기와 HTTP 200이 복구되면서 ProtectSystem=strict·NoNewPrivileges=yes는 유지되는지 확인합니다. 다른 보완 파일을 지우지 않습니다. 실제 서비스에서 접근 실패를 진단할 때도 UID·GID, 일반 파일 권한, 서비스 경로 제한, AppArmor 로그를 함께 살펴보고 실패한 조건만 수정합니다.
상태 폴더의 지속성과 실습 정리
StateDirectory의 파일은 서비스를 stop했다고 자동으로 삭제되지 않습니다. 이번 상태 파일을 확인한 후 다시 시작해 쓰기가 가능한지 비교합니다.
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
이 예제의 상태 폴더 지속성은 중지·시작으로 확인했습니다. 서비스의 부팅 자동 시작 연결은 별개이므로 이번 실습은 수동 시작 상태로 두었습니다. 운영 데이터를 지울 때는 유닛 삭제와 데이터 삭제가 서로 다른 작업임을 구분해야 합니다.
실습을 마치면 서비스부터 중지하고 이번 파일만 제거합니다. 아래 데이터 삭제는 이 글에서 새로 만든 테스트 파일만 있다는 조건입니다.
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'
계정이 없어지고 실습 포트의 수신이 끝났는지 확인합니다. 같은 이름의 전용 그룹이 남아 있고 다른 계정에서 사용하지 않는다면 sudo groupdel lf-svc20로 해당 그룹만 제거합니다. 폴더가 비어 있지 않으면 다른 파일이 있는지 확인하고 재귀 삭제로 처리하지 마세요. 계정 삭제는 해당 UID의 모든 데이터를 찾아 지우는 기능이 아니므로, 생성한 데이터 경로를 먼저 정리하는 순서를 유지합니다.




