Debian 13 講座 / systemdでサービス権限と書き込み先を絞る

Debian 13でサービスを専用アカウント下で実行し、永続データの書き込み先を必要な状態保存ディレクトリに絞ることで、管理が容易になります。NoNewPrivileges · ProtectSystem · StateDirectory には異なる役割があるため、段階的に適用する必要があり、プロセスが稼働しているかどうかと実際の機能が正常に動作しているかを区別する必要があります。

アカウントの所有権とサービス内の制限を区別する

このチュートリアルでは、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

初期条件:アカウント/グループのクエリは一致なしを返し、ユニットは見つからず、ファイルは存在せず、ポート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 の各リクエストに対して2回のテスト書き込みを行います。応答はJSON(JavaScript Object Notation:構造化データを表す形式)です。requiredは必須の状態保存先への書き込み結果、outsideは比較用パスへの書き込み結果です。required 書き込みが失敗した場合、プロセスを終了させる代わりに 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 リトライで処理され、失敗が続く場合はジャーナルのエラーを確認してください。

段階的に特権とファイルシステムの制限を適用する

先にls -ld /etc/systemd/system/lf-service20.service.dで追加設定用パスが存在しないことも確認します。既存のディレクトリがあれば作業を止めて所有者と内容を確認してください。その後、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(OSのエラー番号)が30となり、これは読み取り専用ファイルシステムでの書き込みエラーを示しています。STATE_DIRECTORY として準備されたパスは例外として書き込み可能なままですが、比較のために使用される /opt パスはサービスの観点からは読み取り専用になります。

この設定では、サービスによって書き込まれるすべてのパスが単一のステートフォルダに限定されるわけではありません。PrivateTmp で分離された /tmp および /var/tmp も書き込み可能であり、カーネル情報などを公開するAPIファイルシステム(/dev・/proc・/sys)やその他の明示的な例外も考慮する必要があります。この演習では、必要な永続的ステートパスを維持しながら、不要な一般パスへの書き込みを制限することを比較します。

これによりホストのファイルシステム全体が読み取り専用になるわけではありません。同じUIDでサービス外で書き込みを比較するには、次のように個別のファイルを作成して削除することができます。

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

一般的な権限で書き込みが可能であっても、サービスの分離実行環境では結果が異なります。ReadWritePaths で追加の例外を確認することは可能ですが、そのオプションはファイル自体の所有権やモードを付与するものではありません。実際に必要なパスを確認し、デフォルト状態のパスで十分であれば、例外を拡張しないでください。

HTTP 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のokが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 内のファイルは、サービス停止時に自動的に削除されません。現在の状態ファイルを確認した後、サービスを再度起動した場合に書き込みできるかを比較してください。

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のすべてのデータを探して削除する機能は含まれていないため、作成したデータを先に片付けてからアカウントを削除する順序を維持してください。