正しいエスケープ
なぜ大切か どのテンプレートの仕組みにも、どのフレームワークにも、中にエスケープの関数があります。一度自分で書いてみると、どの文字が大事で、なぜ手順の順番が大事なのかがはっきりわかります。そうすれば、エスケープがオフにされていたり、間違った場所で使われていたりするのを見つけられます。
たとえ:ラベルプリンター
ラベルプリンターは、入力したものを何でも印刷します。誰かがプリンター自身の制御コードを入力すると、不注意なラベルプリンターはそれに従ってしまうかもしれません。注意深いものは、代わりにそのコードの絵を印刷します。HTML のエスケープは注意深いラベルプリンターです。特別な文字は印刷されるだけで、決して従われません。
エンティティ:HTML が文字を安全に表示するためのコードです。& で始まり、; で終わります。< は < を、& は & を表示します。
5 つの文字
| 文字 | 変わる先 | 特別な理由 |
|---|---|---|
& | & | エンティティを始める |
< | < | タグを始める |
> | > | タグを終える |
" | " | 二重引用符の属性を終える |
' | ' | 一重引用符の属性を終える |
順番が大事:アンパサンドが最初
< を先に置き換えると < になります。それから & を置き換えると、それは &lt; に変わり、訪問者には < ではなく < というテキストが見えてしまいます。だから & を最初に、それから残りを置き換えます。
"<".replace("<", "<").replace("&", "&") # '&lt;' wrong: escaped twice
"<".replace("&", "&").replace("<", "<") # '<' right引用符が大事な理由:属性
テキストはタグの間にだけ入るのではありません。入力したものを覚えている検索欄のように、しばしば属性の中に入ります:
template = '<input name="q" value="{}">'
typed = 'tent" onfocus="alert(1)'
print(template.format(typed))
# <input name="q" value="tent" onfocus="alert(1)"> the quote ended the value early山かっこは必要ありませんでした。" が値を閉じ、残りが新しい属性になったのです。" を " にエスケープすれば、すべてが値の中にとどまります。一重引用符を使うテンプレートもあるので、' もエスケープします。そして属性の値は常に引用符で囲んでください。囲まなければ、空白ひとつで新しい属性を始められてしまいます。
エスケープが対象にしないもの
HTML のエスケープは、タグの間のテキストと、引用符で囲んだ 属性の中のための正しい道具です。<script> のブロックの中、CSS の中、そしてリンクのアドレスには間違った道具です。href="javascript:..." には特別な文字がまったく含まれていません。リンクについては、https:// か http:// で始まる(または相対の)アドレスだけを許してください。スクリプトが必要とするデータは、data- 属性か、フレームワークが作ってくれる JSON のブロック(例えば Django の json_script)に入れてください。
演習
escape_html(text) を書いてください。ここでは html.escape を使わないでください。要点は自分で作ることです。テストは、タグの間、二重引用符と一重引用符の属性の中、そして何百ものランダムな文字列でそれを試します。
よくある誤解
「2 回エスケープすればさらに安全だ」。安全ではなく、壊れています。訪問者の画面に &lt; のようながらくたが見えます。テキストが HTML に入るその瞬間に、ちょうど一度だけエスケープしてください。
試してみよう 合格したら、escape_html("Fish & chips <3") を表示し、その結果を load("<p>" + ... + "</p>").text に貼り付けてください。元の言葉が戻ってきます。エスケープは情報を失わないのです。
ほかの言語では
// JavaScript
function escapeHtml(text) {
return String(text)
.replaceAll("&", "&") // first
.replaceAll("<", "<")
.replaceAll(">", ">")
.replaceAll('"', """)
.replaceAll("'", "'");
}
// Rust (by hand, one pass)
fn escape_html(s: &str) -> String {
let mut out = String::with_capacity(s.len());
for c in s.chars() {
match c {
'&' => out.push_str("&"),
'<' => out.push_str("<"),
'>' => out.push_str(">"),
'"' => out.push_str("""),
'\'' => out.push_str("'"),
_ => out.push(c),
}
}
out
}
// PHP has it built in
htmlspecialchars($text, ENT_QUOTES | ENT_HTML5, "UTF-8");まとめ
- 5 つの文字をエスケープします:
&、<、>、"、'。 &を最初に置き換えます。そうしないと、自分のエンティティを 2 回エスケープしてしまいます。- テキストはしばしば属性の中に入るので、引用符が大事です。属性の値は常に引用符で囲みましょう。
- HTML のエスケープは、スクリプトのブロック、CSS、リンクのアドレスのための道具ではありません。
html.escape を使わずに escape_html(text) を書いてください。str() で入力を文字列に変え、それから 最初に & を & に、次に < を < に、> を > に、" を " に、' を ' に置き換えます。結果を返します。
この演習はまもなく開きます
その前のレッスンを終えると、このレッスンが解放されます。コース全体が無料でアカウントも不要、このレッスンは今すぐ読めます。
このブラウザは learn.floati.life の Cookie をブロックしているため、ここで修了したレッスンを順番どおりに開けません。このサイトの Cookie を許可して再読み込みしてください。