CORS

どのようなものか

CORSはCross-Origin Resource
Sharingの略で、別のウェブサイトのページが応答を読んでもよいと、サー
バーからブラウザーへ伝えるための規則です。ブラウザーは、オリジンを分
けて扱います。オリジンは、スキーム、ホスト、ポートの組み合わせです。
そのため、`https://app.example.com`、`https://api.example.com`、
`http://app.example.com`は、それぞれ異なる三つのオリジンになります。
一つのオリジンで動くスクリプトは、相手の許可がなければ、ほかのオリジ
ンの応答を読めません。CORSは、その許可を伝える方法です。サーバーが応
答に加える少数のHTTPヘッダー群で、ほとんどは`Access-Control-`で始ま
ります。ブラウザーは、呼び出したスクリプトへ何かを渡す前に、これらを
確認します。

プロトコルは、ブラウザーによるリソース取得を定め、随時更新される
WHATWGのFetch
Standardにあります。その理由も明記されています。ページは、別のオリジ
ンのデータを使い、HTMLフォームで送れるものより多様なリクエストを送れ
るべきですが、それは相手が明示的に許可した場合だけです。この明示的な
許可を求める仕組みがなければ、公開ウェブのページが企業のファイア
ウォールの内側のサーバーを読んだり、利用者のCookieを付けて別のサイト
の利用者の非公開データを読んだりできてしまいます。

中心となるやり取りは短いものです。スクリプトが別のオリジンのリソース
を要求すると、ブラウザーは、ページ自身のオリジンを示す`Origin`ヘッ
ダーを加えます。サーバーは`Access-Control-Allow-Origin`で答え、値に
は、そのオリジンを正確に記すか、誰でもよいことを示す`*`を使います。
一致すれば、スクリプトは応答を受け取ります。一致しなければ、ネット
ワークエラーが渡され、本文は一切受け取れません。

送信自体の前に許可が必要なリクエストもあります。`GET`、`HEAD`、
`POST`で、少数の一般的なヘッダーだけを持ち、本文が
`application/x-www-form-urlencoded`、`multipart/form-data`、
`text/plain`のいずれかなら、そのまま送ります。HTMLフォームでも、どの
サイトからでも既に同じものを送れるからです。それを超える`PUT`、
`DELETE`、JSONの本文、`Authorization`ヘッダーなどには、プリフライト
が先行します。`OPTIONS`リクエストを送り、
`Access-Control-Request-Method`でメソッドを、
`Access-Control-Request-Headers`で追加のヘッダーを示します。実際のリ
クエストを送るのは、応答が200や204などの成功ステータスを持ち、両方を
許可している場合だけです。

なぜ重要なのか

APIを分離したウェブアプリケーションのほぼすべてが、初日にCORSに出会
います。フロントエンドは一つのオリジン、APIは別のオリジンから配信さ
れます。最初の`fetch`は、APIが適切なヘッダーを送るまで失敗し、エラー
がブラウザーのコンソールに出ます。この形で出会うチームは、CORSを開発
の妨げと捉え、エラーを消すためなら何でも許可するように設定しがちで
す。そこにリスクがあります。

ヘッダーが決めるのは、利用者のブラウザーを通して、誰がその利用者の
データを読めるかです。アプリケーションにログインした利用者は、セッ
ションCookieを持っています。APIが、どのオリジンからでも認証情報付き
のリクエストを送り、その答えを読むことを許せば、利用者が訪れたどの
ページでも、その人になり代わってAPIを呼び、結果を読めます。Fetch
Standardは、認証情報付きの応答の共有について、「混乱した代理人の問題
を避けるには、極めて慎重に扱う必要がある」と明言しています。利用者の
認証情報を持つブラウザーが代理人であり、不注意なCORSポリシーは、見知
らぬ相手のページがブラウザーに指図できるようにしてしまいます。

CORSが何をしないかを知ることも、同じように重要です。サーバーを保護す
るものではありません。単純なリクエストは、後から応答を共有するかどう
かに関係なく、サーバーに到達して実行されます。そのため、データを書き
換える`POST`は、ブラウザーがCORSヘッダーを一つでも見る前に、データを
変更しています。ブラウザーの外では、`Origin`ヘッダーは呼び出し元が書
いたとおりの値であり、OWASPのテストガイドも偽装可能だと注意していま
す。誰がエンドポイントを呼べるか、そこで何ができるかは、毎回、サー
バー上の認証と認可で決めます。CORSが決めるのは、ブラウザー内で、どの
ウェブページが応答を読めるかだけです。

実際の活用例

`https://app.example.com`のシングルページアプリケーションが、ログイ
ン時にAPIの設定したセッションCookieを使い、`https://api.example.com`
のAPIを通してノートを保存するとします。

```js
await fetch("https://api.example.com/v1/notes/42", {
  method: "PUT",
  credentials: "include",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ text: "金曜日にリリースする" }),
});
```

JSONの本文を持つ`PUT`は、フォームが送れる範囲を超えるため、ブラウ
ザーは先に尋ねます。プリフライトにはCookieを付けず、実際のリクエスト
が使うものだけを示します。

```http
OPTIONS /v1/notes/42 HTTP/1.1
Host: api.example.com
Origin: https://app.example.com
Accept: */*
Access-Control-Request-Method: PUT
Access-Control-Request-Headers: content-type
```

APIは、自分の一覧に照らしてオリジンを確認し、答えます。

```http
HTTP/1.1 204 No Content
Access-Control-Allow-Origin: https://app.example.com
Access-Control-Allow-Credentials: true
Access-Control-Allow-Methods: PUT
Access-Control-Allow-Headers: content-type
Access-Control-Max-Age: 600
Vary: Origin
```

ブラウザーは`PUT`を、Cookieと`Origin`ヘッダーを付けて送ります。APIの
応答も、`Access-Control-Allow-Origin`と
`Access-Control-Allow-Credentials:
true`を繰り返し含めます。どちらか一方でも欠けると、ノートはサーバー
に保存されても、スクリプトはそのことを知れません。
`Access-Control-Max-Age`によって、ブラウザーは毎回尋ねる代わりに、最
大600秒、プリフライトの答えを再利用できます。このヘッダーがなけれ
ば、標準では五秒保持します。`Vary:
Origin`が重要なのは、要求元のオリジンによって応答が変わるからです。
それを無視するキャッシュは、あるオリジン向けの答えを別のオリジンへ渡
す可能性があります。

職業や組織に関するデータを持つプラットフォームでは、データベースに何
かが届く前に、API層でレート制限、CORS、リクエストサイズの制限、入力
検証を行います。同じページは、CORSがこの一覧の一項目であり、防御全体
ではない理由も説明しています。プラットフォームはクライアントが悪意を
持つと仮定し、ブラウザーが何を許可したかに関係なく、サーバーで各リク
エストの権限を改めて確認します。

問題が起きるところ

サーバーが、どの`Origin`もそのまま`Access-Control-Allow-Origin`へコ
ピーします。
コンソールのエラーを消す最短の方法ですが、
`Access-Control-Allow-Credentials:
true`も加えると、インターネット上のすべてのウェブサイトに、利用者か
ら見えるAPIの内容を渡してしまいます。アクセスを認めるオリジンの一覧
を明示的に持ち、届いた`Origin`と完全一致で比較します。一致したときだ
け、ヘッダーを送ります。

一覧を前方一致や部分文字列で確認します。
`https://app.example.com`で始まるすべてのオリジンを認める規則は、
`https://app.example.com.attacker.example`も認めます。部分文字列の一
致はさらに危険です。シリアライズされたオリジン全体を比較します。シリ
アライズしたオリジンには、パスも末尾のスラッシュもありません。そのた
め、一覧に`https://app.example.com/`を記しても、何にも一致しません。

i**認証情報があっても`*`が使えると思ってしまいます。**		engineer.company	70
リクエストが認証情報を含むと、ブラウザーは`*`を受け付けません。これ
は、`Access-Control-Allow-Origin`、`Access-Control-Allow-Methods`、
`Access-Control-Allow-Headers`、`Access-Control-Expose-Headers`のす
べてに当てはまります。`Access-Control-Allow-Credentials`は、小文字の
`true`と正確に一致する必要もあります。Cookieのない、公開された読み取
り専用APIは、安全に`*`を返せます。セッションに依存するAPIは、オリジ
ンを指定しなければなりません。

許可する一覧に`null`があります。 `data:`
URLから読み込んだページは、不透明なオリジンを持ちます。オリジンをま
たいでリダイレクトされたリクエストも`Origin:
null`を報告するため、互いに無関係な多数の文書が同じ値を示します。
`null`を認めれば、そのすべてを認めることになります。一覧に含めないよ
うにします。

`Vary: Origin`がありません。
APIが`Access-Control-Allow-Origin`を送るのが、一致する`Origin`を持つ
リクエストに限られる場合、キャッシュは、そのヘッダーのない応答を保存
して後のCORSリクエストに返すか、あるオリジンの応答を保存して別のオリ
ジンに返す可能性があります。Fetch
Standardは、応答がオリジンによって変わるときは常に`Vary:
Origin`を求めています。許可するオリジンの値が`*`か、一つの固定された
オリジンなら、すべての応答に送り、`Vary`は省きます。

i**`Access-Control-Allow-Headers: *`がすべてを含むと思ってしまいま		engineer.company	70
iす。		engineer.company	70
ワイルドカードは`Authorization`を一切含まず、名前を明示する必要があ
ります。認証情報付きのリクエストでは、何も含みません。クライアントが
実際に送るヘッダーを指定します。

CORSをアクセス制御として扱います。**
`Origin`が不適切に見えるとリクエストを拒み、そうでなければ受け入れる
サーバーの検査は、ブラウザーの外のスクリプトならどれでも通り抜けられ
ます。呼び出し元を認証し、サーバーで操作を認可します。CORSには、ブラ
ウザーがページに何を見せるかを決めるという、一つの役割を任せます。

参考資料

  * Fetch Standard：CORSプロトコル —
リクエストと応答のヘッダー、プリフライト、認証情報の表、`Vary`に関す
る助言を含む定義です。

  * RFC 6454：ウェブのオリジンという概念 —
オリジンの意味、スキーム、ホスト、ポートによる決定と、`Origin`ヘッ
ダーへのシリアライズ方法を説明します。

  * OWASPウェブセキュリティテストガイド：オリジン間リソース共有のテ
スト —
ワイルドカードのオリジンや、確認せずにそのまま返すオリジンを、テスト
担当者がどう調べるかを説明します。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/cors/	engineer.company	70
