クリーム色の背景、色付き表示、高コントラスト、大きな文字のほうが読みやすいですか?配色と文字を選ぶと、すべてのページに一度で反映されます。

無料レッスン

Wasmtime とケイパビリティモデル

このレッスンのあとで: Wasmtime のコマンドが、プログラムに何を使わせるかを判断できる。

60分のレッスンコマンド5件WebAssembly ラボ:Wasmtime、WASI のケイパビリティ、WIT コンポーネント、プラグインの上限

あなたのファイルを読めないプログラム

Wasmtime は、WebAssembly のプログラムをファイルなし、環境変数なし、ネットワークなしで動かします。使わせたいものは、コマンドラインで1つずつ許可します。これがケイパビリティモデルです。人が書いたプログラムでも、渡していないものは読めません。

今日はフォルダーと変数を1つずつ許可し、ほかがすべて断られる様子を見ます。

このレッスンのゴール

メモ

Wasmtime のコマンドが、プログラムに何を使わせるかを判断できる。

キーワード

ことばいみれい
WASIWebAssembly 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.txtWASI error 8フォルダーがなく、手がかりもない
--dir data cat.wat notes.txt買い物リストファイルはフォルダーの中にある
--dir data cat.wat ../private/key.txtWASI error 63パスがフォルダーの外へ出る
--dir data cat.wat missing.txtWASI error 44中だが、そのファイルはない

学生が入力するセルは、このプレビューでは空白です。

よくある間違い

注意

「WASI のプログラムは、wasmtime を動かした人が読めるものなら何でも読める」と考える人がいます。届くのは --dir で渡したフォルダーの中だけで、その上には届きません。root が動かしても、フォルダーの外のファイルは開けません。

試そう: パスは中にとどまるか

コード: python
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

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

このラボとソースについて: WebAssembly ラボ:Wasmtime、WASI のケイパビリティ、WIT コンポーネント、プラグインの上限

授業で使いますか?このモジュールを学生に割り当てると、教員用ガイド、自動採点つきの課題、学生ごとのラボを使えます。