あなたのファイルを読めないプログラム
Wasmtime は、WebAssembly のプログラムをファイルなし、環境変数なし、ネットワークなしで動かします。使わせたいものは、コマンドラインで1つずつ許可します。これがケイパビリティモデルです。人が書いたプログラムでも、渡していないものは読めません。
今日はフォルダーと変数を1つずつ許可し、ほかがすべて断られる様子を見ます。
このレッスンのゴール
メモ
Wasmtime のコマンドが、プログラムに何を使わせるかを判断できる。
キーワード
| ことば | いみ | れい |
|---|---|---|
| WASI | WebAssembly System Interface。ファイルなどを使うための標準のインポート | |
| ケイパビリティ | 1つのものを使わせる、手渡しの権限 | |
| 事前オープンしたフォルダー | ホストが開いて手渡すフォルダー | --dir data |
| 環境変数 | プログラムに渡す、名前のついた設定 | CITY=Osaka |
| ファイル記述子 | 開いたファイルやフォルダーを表す番号 | |
| エラーコード | WASI が断るときに返す番号 |
学生が入力するセルは、このプレビューでは空白です。
ファイルを1つずつ求める理由
ふつうのプログラムは、使う人が読めるファイルなら何でも開けます。これをアンビエント権限と呼びます。力がまわりの空気に満ちているようなもので、悪いライブラリーもその力を全部使えます。
WASI のプログラムは何も持たずに始まります。ファイルを読むには、ホストがフォルダーを開き、そのファイル記述子を渡します。するとプログラムは、そのフォルダーの中のパスだけを開けます。
何も許可せずにファイルを求める
docker exec wasm wasmtime run cat.wat notes.txtここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
data フォルダーを許可する
docker exec wasm wasmtime run --dir data cat.wat notes.txtここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
許可したフォルダーは柵になる
エラー8は、フォルダーの手がかりが1つもなかったという意味です。--dir data で手がかりを1つ受け取ったので、notes.txt が開きました。表示は Shopping for Saturday で始まる買い物リストです。
次は ../private/key.txt を求めます。private フォルダーは data のすぐ隣にあり、wasmtime を動かしている人なら読めます。それでも WASI は断ります。許可したフォルダーの外へ上がるパスだからです。
フォルダーの外へ出てみる
docker exec wasm wasmtime run --dir data cat.wat ../private/key.txtここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
例: それぞれの断りの意味
| コマンド | 表示 | 理由 |
|---|---|---|
| cat.wat notes.txt | WASI error 8 | フォルダーがなく、手がかりもない |
| --dir data cat.wat notes.txt | 買い物リスト | ファイルはフォルダーの中にある |
| --dir data cat.wat ../private/key.txt | WASI error 63 | パスがフォルダーの外へ出る |
| --dir data cat.wat missing.txt | WASI error 44 | 中だが、そのファイルはない |
学生が入力するセルは、このプレビューでは空白です。
よくある間違い
注意
「WASI のプログラムは、wasmtime を動かした人が読めるものなら何でも読める」と考える人がいます。届くのは --dir で渡したフォルダーの中だけで、その上には届きません。root が動かしても、フォルダーの外のファイルは開けません。
試そう: パスは中にとどまるか
def stays_inside(path):
# パスを1つずつたどります。".." でフォルダーより上に出てはいけません。
if path.startswith("/"):
return False
depth = 0
for part in path.split("/"):
if part == "..":
depth = depth - 1
if depth < 0:
return False
elif part != "" and part != ".":
depth = depth + 1
return True
for path in ["notes.txt", "week1/../notes.txt", "../private/key.txt", "/etc/passwd"]:
print(path, "は中にとどまる:", stays_inside(path))
# "week1/../../key.txt" を足しましょう。中にとどまるでしょうか。
環境変数は引き継がれない
シェルから起動したプログラムは、ふつうシェルの変数をすべて見られます。パスワードもです。Wasmtime は1つも渡しません。
1つ設定するには --env NAME=value、ホストにある値を渡すには --env NAME を使います。-S inherit-env はすべてを渡すので、信頼できるプログラムだけに使います。ネットワークも同じで、-S のオプションで許可するまで何にも届きません。
何も許可せずに変数を一覧する
docker exec wasm wasmtime run env.watここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
変数を1つ許可して一覧する
docker exec wasm wasmtime run --env CITY=Osaka env.watここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。