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

無料レッスン

Wasm によるプラグインのサンドボックス

このレッスンのあとで: WebAssembly のプラグインがホストを傷つけないように、上限を選ぶことができる。

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

他人のコードを自分のプログラムの中で

プラグインのサンドボックスを使うと、アプリケーションは他人が書いたコードを、信頼しないまま動かせます。エディター、ウェブのプロキシ、データベース、ゲームが、そのために WebAssembly を使っています。プラグインが呼べるのはホストがインポートしたものだけで、ホストはいつでも止められます。

今日は、終わらないプラグインと、メモリーを欲しがりすぎるプラグインを止めます。

このレッスンのゴール

メモ

WebAssembly のプラグインがホストを傷つけないように、上限を選ぶことができる。

キーワード

ことばいみれい
プラグインホストのプログラムに機能を足すコード
ホストプラグインを読み込んで動かすプログラム
トラップWebAssembly のコードをその場で止めるエラー
燃料 (fuel)コードが動くと減っていく仕事の予算-W fuel=100000
タイムアウトコードが動いてよい時間の上限-W timeout=2s
ページWebAssembly のメモリーの 64 KiB の一区切り

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

終わらないプラグインの止め方

spin.wat は、出口のないループを持つプラグインです。そのまま動かすと、いつまでもプロセッサーを占めます。

Wasmtime には2つのブレーキがあります。タイムアウトは実際の時間を数えます。ランタイムがカウンターを進め、コードはループや呼び出しのたびにそれを確かめます。燃料は仕事の量を数えます。命令ごとに少しずつ使い、タンクが空になるとプラグインはトラップで止まります。

2秒で止める

コマンド
docker exec wasm wasmtime run -W timeout=2s spin.wat

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

燃料が尽きたら止める

コマンド
docker exec wasm wasmtime run -W fuel=100000 spin.wat

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

例: プラグインを止める2つの方法

ブレーキ数えるもの出たトラップ向いている場面
タイムアウト実際の時間wasm trap: interruptすぐ答えるべきリクエスト
燃料仕事の量wasm trap: all fuel consumed by WebAssemblyどの機械でも同じ上限

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

プラグインのメモリーには天井がある

メモリーは 64 KiB のページ単位で増えます。grow.wat は断られるまで1ページずつ求め、最後に持っているページ数を表示します。

モジュール自身は、最大100ページと宣言しています。ホストは -W max-memory-size で、もっと低い天井を設けられます。それ以上を求めると memory.grow は -1 を返し、プラグインは動き続けます。だから注意深いプラグインなら対処できます。

自分の上限まで増やさせる

コマンド
docker exec wasm wasmtime run grow.wat

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

1 MiB だけ与える

コマンド
docker exec wasm wasmtime run -W max-memory-size=1048576 grow.wat

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

試そう: 上限をページに直す

コード: python
PAGE = 64 * 1024   # WebAssembly の1ページは 64 KiB

for limit in [1048576, 4 * 1048576, 64 * 1048576]:
    print(limit, "バイトで", limit // PAGE, "ページ")
# ちょうど100ページになる上限は、何バイトでしょうか。

よくある間違い

注意

「サンドボックスがあれば、ホストが何を渡してもプラグインは安全だ」と考える人がいます。プラグインは、ホストがインポートした関数をどれでも悪用できます。フォルダーやネットワークを渡せば、それを使えます。サンドボックスが取り除くのは、渡さなかったものだけです。

サンドボックスがしないこと

Wasm はプラグインを自分のメモリーの中に閉じ込めますが、残る危険もあります。自分で書いたホストの関数のバグは、やはりバグです。ランタイム自体にもバグがありうるので、最新に保ちます。1つのプロセスの中では、時間差を使った手口で、プラグインのあいだで秘密が漏れることもあります。

境界を越えるには時間もかかります。値がコピーされるからです。値を1つずつ渡さず、仕事をまとめて1回の呼び出しで渡しましょう。

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

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