知らないうちに僕たちは Ruby on Rails に CSRF から守られている

# 前提

[Cloud CIRCUS Meetup](https://startialab.connpass.com/event/237357/) に登壇した際に話した内容を記事にしました.
Meetup のアーカイブは以下に上がっています.

https://youtu.be/IRf6kFdd43Y

本記事は, Ruby on Rails で作成したプロジェクトが, どのように CSRF から私たちを守ってくれているのかの全体像を **なんとなく** 掴むところをゴールとして構成されています.
そのため, Rails 自体のソースコードの詳しい解説や, その他のセキュリティ対策に関することはスコープ外とします.

:::note info
登壇した際に使用したスライドは以下で公開しています.
:::

https://docs.google.com/presentation/d/1UvTnPyWGguUz0zzVKLJKYqejmjl9F2LJwXL3HaNXulw/edit#slide=id.g12edc3510ab_0_0

# CSRF とは

**Cross Site Request Forgery** の頭文字を取ったもので, 利用者が意図しないリクエストを攻撃対象の Web サーバに送ってしまう脆弱性及びその脆弱性を利用した攻撃方法のことを指します.

具体的な例としては, ユーザがなにかの EC サイトにログインしている状態で
攻撃者が用意した Web アプリケーションに訪問すると, EC サイトに保持されているセッション情報を使用して, 意図しない商品の購入などが実行されてしまうなどが挙げられます.

## 図解

### 本来のながれ

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/889476/baa107f8-03f7-0790-a45d-949c1ef1583e.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/889476/ea4e5abe-bf66-d5ec-7e6e-522447453dca.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/889476/026aef8f-1901-9d5f-375d-f58890232c31.png)

### 攻撃のながれ

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/889476/2c094f76-46ea-feba-c4f5-48b3e1abd2c8.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/889476/41e7420c-755a-52de-c5b1-9d8c74e73a8b.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/889476/a7f2f2f7-a7af-4326-e9b1-85a05f1b9438.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/889476/0fab6db1-31ec-27f8-703c-e33baa29284e.png)

# Rails はどのように僕たちを守っているのか

Rails では, HTML - セッション Cookie に **一意のトークン ( `csrf_token` )** を埋め込むことで CSRF 対策をしています.

一意のトークンは, デフォルトで `authenticity_token` というキー名で使用されます.

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/889476/48e1b384-d221-7dee-6eb5-fa0a5f05b19c.png)

## 発行のながれ

`app/views/layouts/application.html.erb` の `head` 内で HTML へ埋め込んでいます.

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/889476/6645d0de-2593-8baf-da57-30aae903507e.png)

rails の `csrf_meta_tags` メソッドは `actionview/lib/action_view/helpers/csrf_helper.rb` 内に定義されており, トークン発行処理は `form_authenticity_token` に実装されています (登壇資料作成に当たってそれなりに潜りましたが詳細の解説は本記事では割愛します) . 

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/889476/f9524c1e-f31f-4c21-ed83-eccbd99cc15e.png)

`form_authenticity_token` が呼び出されると, 以下のような流れでトークン発行を実行します.

1. ランダムな文字列を Base64 形式で生成し, セッションに格納します.
1. ランダムなバイト列でワンタイムパッドを生成.
1. ワンタイムパッドとセッションに格納された文字列をデコードした値を XOR 操作することによって暗号化します.
1. ワンタイムパッドを暗号化した文字列の先頭に付加します (先頭にワンタイムパッドを仕込むことで復号可能な文字列となります) .
1. view に埋め込むため, 先程生成した文字列をエンコードします.

以上の手順で csrf_token の view への埋め込みと, セッション cookie への格納を実行しています.

## 照合のながれ

Rails5 以降はデフォルトでオンになっているため, このような記述はされていませんが, `protect_from_forgery` メソッドを呼び出すことで リクエストごと[^1] に `csrf_token` の照合を実行します.

[^1]:POST リクエストのみ検証するなどの条件があります.

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/889476/e927d3b6-673d-a327-21cc-56bf20100cba.png)

`protect_from_forgery` が呼び出されると, 以下のような流れでトークン照合を実行します.

1. パラメータのトークン ( `authenticity_token` ) をデコードします.
1. トークン先頭のワンタイムパッドを使用して発行時と同じロジックでマスクを解除します.
1. マスク解除した文字列とセッション cookie をデコードした値で照合します.
1. 照合が通過すれば以降の処理が実行されます.

上記のような処理をリクエストごとに実行することで, CSRF からアプリケーションを守ってくれるような仕組みとなっています.

# まとめ

今回は Rails の CSRF 対策の全体像について執筆しましたが, Rails 以外の Web フレームワークでも同様に様々な機能が実装されています.

「なぜこのような記述がされているのか？」というところを
突き詰めてみると面白いですし, 実際の開発でも役に立つことがあるかもしれません.