実験・実装 · 基礎から応用へ

読み取り用ハンドルの権限と共有状態を確かめる

読み取り用ファイル記述子を複製し、書込みの拒否、共有される位置、元の記述子を閉じた後の動作を確認します。

この記事をロゲイアに質問する確認問題3問に進むこれまでの誤答を復習する

更新日

この記事の目次
  1. 名前から開く処理とハンドルを渡す処理
  2. 一時ファイルと六つのバイトを用意する
  3. 複製しても読み取り位置は独立しない
  4. 元を閉じても複製先は使える
  5. 書込みの拒否と別経路を両方試す
  6. より強い分離へ進む際に確認すること
  7. 課題は位置と失効を予想する
  8. この記事をロゲイアに質問する理解を確かめる

名前から開く処理とハンドルを渡す処理

補助処理にファイルの名前を渡すと、その処理は自分の権限で対象を開き直すことがあります。一方、既に開いた読み取り用ハンドルを渡すと、渡された対象を読むという操作を表しやすくなります。この実験では、Linuxのファイル記述子を使って、そのハンドルを通す操作にどんな制限と共有状態があるかを確かめます。完全なケイパビリティOSや、任意のコードを閉じ込めるサンドボックスを実装するものではありません。読むだけのハンドルが書込みを拒否することと、プロセスが別の経路で書けないことは異なります。最後に同じパスを開き直して書ける試験もわざと残し、この違いを観測します。制限できた範囲だけでなく、制限していない範囲も確認することが、実験の中心です。

一時ファイルと六つのバイトを用意する

Python 3.12以降をLinux環境で使います。コードをhandle_test.pyへ保存して実行すると、専用の一時ディレクトリとdocument.txtを作り、abcdefという六つのASCIIバイトを入れます。実験終了時には一時ディレクトリごと片付けます。自分の文書や本番の保存先を指定する必要はありません。os.openへO_RDONLYを渡して、読み取り専用の記述子を取得します。ここではPythonのバッファ付きファイル読み取りではなくos.readを使うため、何バイト進んだかをOSの位置と対応させて追えます。高水準の読み取りを混ぜると、先読みのバッファによって見えている位置との対応が変わる場合があるからです。記述子の数値は実行環境が選ぶので、3や4など特定の値になることは試験の条件にしていません。対象と許可された操作の性質を比較します。

複製しても読み取り位置は独立しない

最初の記述子から二バイト読むとabが返り、位置は二つ進みます。os.dupで複製した記述子から次の二バイトを読むとcdが返ります。複製が最初から読み直す独立したファイルを作ったわけではありません。同じ開いたファイルの状態を共有しているためです。見た目には二つの数値のハンドルがあっても、読み取り位置を別々に持つとは限りません。ハンドルを別の処理へ渡す設計では、この共有も契約に含める必要があります。片方が読んだ結果、もう片方の次の読み取り内容が変わるなら、順序を無視した並行利用は予想と違う動作を生むかもしれません。独立した位置が必要な場合に、単純な複製だけで実現できたと考えないでください。位置指定の読み取りや別の開き方を検討する際も、使うAPIが共有する状態を確認します。

元を閉じても複製先は使える

originalを閉じた後にも、duplicateから次の二バイトefを読めることを確認します。元の記述子を閉じる操作は、その一つの参照を手放すことであって、複製して渡した全ての参照を強制的に失効させる操作ではありません。この例は、権限を渡すことと後から取り消すことを分けて設計する理由になります。実験では二つの記述子を同じプロセス内で扱っていますが、別の実行主体へハンドルを渡す設計でも、何が共有され、どの時点まで使えるかという問いは残ります。また、ファイル名を変更・削除した場合の挙動をこの結果だけから断定しないでください。今回は名前を変える操作を試していません。確認したのは、複製した記述子が元の記述子のcloseだけでは使えなくならないという点です。失効を必要とするAPIでは、その保証を提供する別の仕組みが要ります。

書込みの拒否と別経路を両方試す

duplicateへos.writeを使うと、Linuxでは読み取り専用の記述子なのでEBADFが返ることを期待します。例外の種類だけでなくerrnoを比較し、不正な記述子への書込みが想定した理由で拒否されたことを確認します。ファイル内容がabcdefのままであることも検査します。その後、全ての記述子を閉じて、同じpathを通常の書込み操作で開き直すとchangedへ変えられます。これにより、読み取り用ハンドルの制限を確かめても、プロセス全体の書込み権限を取り除いたわけではないと分かります。最後の成功を実験の失敗として隠すのではなく、残る権限を示す結果として読んでください。OSがその記述子を通す書込みを拒否したことと、プロセスを隔離したことは異なる主張です。出力の四つの確認項目を、この順序に対応させます。

python
import os, errno, tempfile
from pathlib import Path
with tempfile.TemporaryDirectory() as directory:
    path = Path(directory) / 'document.txt'
    path.write_bytes(b'abcdef')
    original = os.open(path, os.O_RDONLY)
    duplicate = None
    try:
        assert os.read(original, 2) == b'ab'
        duplicate = os.dup(original)
        assert os.read(duplicate, 2) == b'cd'
        os.close(original)
        original = None
        assert os.read(duplicate, 2) == b'ef'
        try:
            os.write(duplicate, b'X')
        except OSError as error:
            assert error.errno == errno.EBADF
        else:
            raise AssertionError('read-only handle accepted write')
        assert path.read_bytes() == b'abcdef'
    finally:
        if original is not None: os.close(original)
        if duplicate is not None: os.close(duplicate)
    path.write_bytes(b'changed')
    assert path.read_bytes() == b'changed'
print('shared offset, retained handle, rejected descriptor write, ambient reopen: passed')

より強い分離へ進む際に確認すること

この仕組みを権限分離へ応用する場合は、補助処理へ必要なハンドルだけを渡すことに加え、不要な記述子の継承や名前による別のアクセス経路を調べます。通信、プロセス生成、設定変更などは、この読み取りの試験とは別の権限です。OSが制限を強制する方式を使うなら、有効な設定と実際に拒否された操作を検証環境で確認します。あるAPIの名前にsandboxという語が入っているだけで十分とはしません。逆に、今回の小さい実験でも、読み取り専用で渡す対象と共有状態の関係は学べます。強制していない保証まで足さず、設計を段階的に分けることが大切です。エラーが出ないよう全ての操作へ強い権限を与えると、制限を検証する目的が失われます。必要な正常操作が通ることと、意図した禁止操作が止まることを対にして確かめます。

課題は位置と失効を予想する

課題として、最初にoriginalから一バイトだけ読んでから複製した場合、duplicateの次の二バイトを予想します。解答はbcです。位置を共有するので、複製先だけがaへ戻るわけではありません。次に、originalを閉じればduplicateも必ず使えなくなるという説明の誤りを述べてください。解答は、別に保持された参照が残るため、一つのcloseを全体の失効と同一視できない、です。最後に、O_RDONLYのハンドルを渡したから別のパスも読めないという結論が出せるかを考えます。この実験では出せません。最後に通常の再オープンが成功したように、プロセスは他の権限を持ったままです。自分の言葉でこの三つを区別できれば、権限の範囲と状態の共有、参照の寿命を混ぜずに設計を読めます。実験後は一時ディレクトリが消え、開いた記述子もfinallyで閉じられます。

読了と問題の結果を、言語ごとにこのブラウザへ保存します。

コースの順番に沿って学ぶ

サーバーの中で起きていること · STEP 19

学習コースから次を選ぶ