Sinatra で Webアプリケーションを作った
1年以上ぶりの記事ですね。
去年の12月からフィヨルドブートキャンプに通っており、もう1年以上経ちます。 途中半年以上全然プラクティスをやっていないに等しいような時期があったのですが、ここ2ヶ月くらいはなんとか勉強が習慣化してきたようで連日のようにプラクティスを進めることができている状態です。
フィヨルドブートキャンプではプラクティスをやった日は必ず日報を書くようになっており、僕も必ず書いています。 その日報をブログにも書いて勉強の過程を公開しようしようと思いつつやれておらず、また過去にさかのぼってブログ書くのもしんどいので中途半端で唐突な始まりですが今日から本気出す。
作ったアプリケーションはこれ。
REST のリソース設計は思っているより全然難しい
提出物を作成した段階ではわりとスムーズに進められたな〜とか思っていたが、レビューをいただくと色々考慮漏れがあることが分かってきた。
- リソース名の単数形と複数形を統一する
- URI の構造を統一する
- 実際にブラウザからアクセスするときの URL を考える
- ブラウザからアクセスしたときに分かりにくいリソース表現になっていないか
- 実際にブラウザからアクセスするときに区別できない URL になっていないか
- 異なるリソースを同じ URL で表現しようとしていないか
- 安易に id だけでリソースを区別しようとするとブラウザから見たときに人間が区別できない
.DS_Store に困らせられた
データベースで管理せずにファイルにデータを保存する関係でファイル操作を行うためか、今までは特に気にしていなかった .DS_Store ファイルがいつの間にかできており、うっかりリモートリポジトリへ追加してしまうことがあった。
今までの経験から安易に rm したり、リモートリポジトリ側で消しちゃうと差分に困るのでしっかり git rm できたのは良かった。
.gitignore に追記することでリモートリポジトリに追加されることは回避できる。
空のディレクトリは git add できない
メモを格納する空のディレクトリを作成していたのだが、リモートリポジトリ側に反映せずにちょっと困った。
そのような場合は .gitkeep ファイルを置いたりするらしい。 https://qiita.com/tommy_aka_jps/items/b2ae85cbeab77e12a925
これで無事にリモートリポジトリへ空ディレクトリを追加できた。
Rubocop の言うことをちゃんと聞く
提出直前になって rubocop を通してみたときにセキュリティ関連の警告が出たが、これはデータベースを利用せずにメモをファイルで管理しているために表示されるものであり、今回の実装ではしょうがないと思いこんでいた。
のでそのまま提出しようとしたが、ファイルを読み込むだけで警告が出るはずないだろう、自分よりはるかに経験豊富な人達が作ってくれているライブラリなのに安易にしょうがないで片付けるのは早とちりなのではないかと思い、ちゃんと警告文と向き合った。
表示されていた警告文は以下の2つ。
lib/crud_controller.rb:62:3: C: Security/Open: The use of Kernel#open is a serious security risk. open(file_path, 'w') do |file| ^^^^
lib/crud_controller.rb:17:26: C: [Correctable] Security/JSONLoad: Prefer JSON.parse over JSON.load. json_object = JSON.load(json_file) ^^^^
openメソッドはOSコマンドインジェクションの脆弱性があるらしい https://www.lanches.co.jp/blog/5996File.openを使うことで存在しないパスの場合はエラーになるのでOSコマンドインジェクション疑われるようなファイルのパス以外の文字列が渡されてもエラーにして回避できる。JSON.loadで直接ファイルを開かないJSON.parseを推奨される理由が自分の検索能力では調べきれなかったが、なるべくファイルは開かないに越したことはないからなかと推測した。 そのためFile.openで読み込んだファイルオブジェクトをreadして文字列を渡してparseしてもらうように変更した。
json_object = JSON.parse(json_file.read)
上記を行って警告は全解消できた。 と同時に、これ実務でもし修正せずにそのまま本番環境に適用させたら脆弱性を作ったことになるなぁと怖くなった。
警告文を流し読みせず、しっかり向き合うように改めて思えるいい機会だった。
感想など
ところどころハマったところはあったが、かつてのように何が分からないかも分からないのでハマりを解消する手がかりさえ全く不明、というような頭を抱えるようなドハマリはなく、自分で調べて解消できるようになっていたので成長しているのかなと感じた。
