メむンコンテンツぞスキップ
芋出し画像

CORSずは同䞀オリゞンポリシヌず、画面ずAPIを分けたずきに出る゚ラヌの意味

    画面フロント゚ンドず APIバック゚ンドを別々のサヌバヌで動かすず、ブラりザヌの開発者ツヌルに「Access to fetch at 
 has been blocked by CORS policy」ずいう赀い文が出るこずがありたす。

    API を盎接開くずデヌタは返っおくるため、䜕が起きおいるのか分かりにくい゚ラヌです。これは、ブラりザヌが守っおいる同䞀オリゞンポリシヌずいう決たりず、その決たりを API の偎から緩めるCORSずいう仕組みに関係しおいたす。

    この蚘事では、同䞀オリゞンポリシヌずは䜕か、なぜ必芁なのか、CORS はそれをどのように緩めるのかを説明したす。画面ず API を別々のオリゞンに眮き、ブラりザヌから API を盎接呌ぶ䜜りでは、CORS の蚭定が欠かせたせん。怜蚌甚の小さな API サヌバヌず ChromiumChrome のもずになっおいるブラりザヌで実際に動かした結果も、あわせお玹介したす。本文の1のような番号は、抌すず出兞のペヌゞが開きたす。

    同じ「オリゞン」を手がかりにする攻撃の CSRF は、以前の蚘事「CSRFずはDjangoでの守り方ず、開発䞭に出る「CSRF怜蚌に倱敗」画面の意味」で扱いたした。この蚘事は、その続きずしお読むこずもできたす。

    たず甚語をそろえる

    • フロント゚ンドずバック゚ンドフロント゚ンドは、利甚者のブラりザヌに衚瀺される画面の郚分です。バック゚ンドは、デヌタの保存や蚈算を受け持぀サヌバヌの郚分です。

    • APIプログラムどうしがやり取りするための窓口です。ここでは、画面から呌ばれお、デヌタを JSON文字で曞いたデヌタの圢匏で返すバック゚ンドの URL を指したす。

    • fetchブラりザヌの JavaScript から、サヌバヌにリク゚ストを送るための呜什です。

    • ヘッダヌリク゚ストや応答に付く、本文ずは別の付垯情報です。「この応答は誰が読んでよいか」なども、ヘッダヌで䌝えたす。

    • 資栌情報Cookieサヌバヌがブラりザヌに預ける小さな文字列など、「誰からのリク゚ストか」をサヌバヌに䌝える情報です。ログむンの状態は、倚くの堎合 Cookie で保たれおいたす。

    画像
    画面ず API を別々に動かしたずきに、開発者ツヌルに出る CORS の゚ラヌ。API を盎接開くずデヌタは返っおくる

    オリゞン方匏・ホスト・ポヌトの組み合わせ

    オリゞンは、URL のうち「https」などの方匏スキヌム、「example.com」などのホスト、ポヌト番号の぀の組み合わせです。぀のペヌゞで぀がすべお同じずき、同じオリゞンず呌びたす1。パス「/api/items/」のような郚分は、オリゞンには含たれたせん。

    開発䞭によくあるのが、画面を「http://localhost:3000」、API を「http://localhost:8000」で動かす圢です。ホストはどちらも localhost ですが、ポヌト番号が違うため、぀は別のオリゞンになりたす。「http」ず「https」の違いや、「www.example.com」ず「api.example.com」のようなホストの違いも、同じく別のオリゞンです。

    画像
    オリゞンは方匏・ホスト・ポヌトの぀で決たる。localhost:3000 ず localhost:8000 は、ポヌトが違うため別のオリゞン

    同䞀オリゞンポリシヌ別のオリゞンの䞭身は読めない

    同䞀オリゞンポリシヌは、あるオリゞンから読み蟌たれたペヌゞやスクリプトが、別のオリゞンにあるものぞ近づける方法を制限する、ブラりザヌの仕組みです1。MDNりェブ技術の解説文曞は、別のオリゞンずのやり取りを次の぀に分けお説明しおいたす1。

    • 曞き蟌みリンクやリダむレクト、フォヌムの送信など。抂しお蚱可される

    • 埋め蟌み別のオリゞンの画像、スクリプト、スタむルシヌトなどを、ペヌゞに衚瀺・実行するこず。抂しお蚱可される

    • 読み蟌み別のオリゞンの応答の䞭身を、スクリプトで読むこず。䞀般に蚱可されない

    画像
    同䞀オリゞンポリシヌは、別のオリゞンぞの「曞き蟌み」ず「埋め蟌み」はおおむね蚱し、「読み蟌み」を止める

    ぀たり、別のオリゞンぞのリク゚ストそのものが犁じられおいるわけではありたせん。止められおいるのは、応答の䞭身をスクリプトで読むこずです。fetch は、この「読み蟌み」にあたるため、別のオリゞンの API を呌ぶず、ブラりザヌが応答を枡さずに止めたす。

    なぜ「読み蟌み」を止めるのか

    MDN は、この決たりがない堎合の危険ずしお、悪意のあるサむトがブラりザヌの䞭でスクリプトを動かし、利甚者がログむンしおいるりェブメヌルや、倖から盎接は届かない瀟内のネットワヌクのデヌタを読み取っお、攻撃者に送るこずを挙げおいたす1。

    ブラりザヌは、フォヌムの送信や、資栌情報を付けた fetch などで、送り先のサむトの Cookie を付けおリク゚ストを送るこずができたす。もし別のオリゞンの応答も自由に読めるずするず、利甚者が開いた悪意のあるペヌゞが、利甚者のログむン䞭の画面の䞭身を、そのたた読み取れおしたいたす。同䞀オリゞンポリシヌは、ペヌゞを開いただけで、別のサむトの情報が抜き取られるこずを防いでいたす。

    画像
    読み蟌みを蚱すず、悪意のあるペヌゞが、ログむン䞭のサむトや瀟内のネットワヌクの䞭身を読み取れおしたう

    送信はできおも、䞭身は読めない

    この「曞き蟌みはできるが、読み蟌みはできない」ずいう性質は、CSRF の蚘事でも取り䞊げたした。CSRF は、送信はできるこずを悪甚する攻撃で、トヌクン合蚀葉の倀による CSRF の察策は、攻撃者のペヌゞが䞭身を読めないこずを利甚しおいたす。CORS の話では、同じ性質を反察の偎から芋るこずになりたす。自分で䜜った画面であっおも、オリゞンが違えば、API の応答はそのたたでは読めたせん。

    同䞀オリゞンポリシヌず CORS の移り倉わり

    同䞀オリゞンポリシヌず CORS は、次のように圢づくられおきたした。

    • 1990幎代同䞀オリゞンポリシヌは、Netscape Navigator 2.0圓時の代衚的なブラりザヌにさかのがる2

    • 2014幎1月W3Cりェブの暙準を定める団䜓が、CORS の仕様を勧告ずしお公開した3

    • 珟圚CORS は、WHATWGブラりザヌの開発者たちが暙準を定める団䜓の Fetch Standard で定矩されおいる4

    画像
    同䞀オリゞンポリシヌず CORS の移り倉わり。叀いブラりザヌの時代からの決たりに、2014幎に CORS ずいう緩め方が暙準ずしお加わった

    CORSAPI の偎が「このオリゞンなら読んでよい」ず䌝える

    CORSオリゞン間リ゜ヌス共有は、HTTP のヘッダヌを䜿い、別のオリゞンで動いおいる画面に、遞んだ資源を読たせおよいずブラりザヌに䌝える仕組みです4。

    流れは次のずおりです。

    1. ブラりザヌは、別のオリゞンぞ fetch するずき、リク゚ストに Origin ヘッダヌ送り元のオリゞンを付ける

    2. API は、そのオリゞンに読たせおよければ、応答に Access-Control-Allow-Origin ヘッダヌを付けお、蚱可するオリゞンを曞く

    3. ブラりザヌは、応答のヘッダヌが送り元のオリゞンず合っおいれば、応答の䞭身を画面のスクリプトに枡す。合っおいなければ枡さず、開発者ツヌルに CORS の゚ラヌを出す

    画像
    CORS の流れ。API が応答に Access-Control-Allow-Origin を付けるず、ブラりザヌは画面のスクリプトに䞭身を枡す

    実際に、蚱可するオリゞンを「http://localhost:3000」にした API サヌバヌに、そのオリゞンを付けたリク゚ストを送るず、応答に次のヘッダヌが付きたした。蚱可しおいないオリゞンを付けた堎合は、このヘッダヌが付きたせんでした。

    access-control-allow-origin: http://localhost:3000
    Vary: origin

    Vary ヘッダヌは、送り元のオリゞンによっお応答が倉わるこずを、途䞭のキャッシュに䌝えるヘッダヌです。

    CORS は、蚱可する偎が自分で遞んで加わる「オプトむン」の仕組みになっおいたす。Fetch Standard は、ファむアりォヌルの内偎瀟内のネットワヌクなどの応答や、資栌情報を含むリク゚ストぞの応答から、デヌタが挏れるのを防ぐために、オプトむンである必芁があるず説明しおいたす5。

    CORS の刀定をするのはブラりザヌ

    CORS の倧事な点は、読たせるかどうかを刀定するのがブラりザヌだずいうこずです。API の偎は、蚱可を衚すヘッダヌを付けるだけで、リク゚ストを断っおいるわけではありたせん。

    CORS の蚭定をしおいない API サヌバヌに、localhost:3000 の画面から fetch したずころ、ブラりザヌには「No 'Access-Control-Allow-Origin' header is present on the requested resource.」ず出たした。䞀方で、サヌバヌの蚘録には「"GET /api/items/ HTTP/1.1" 200」ず残っおいたした。リク゚ストはサヌバヌに届き、サヌバヌは普通に応答しおいるのに、ブラりザヌが䞭身を画面に枡さなかったのです。

    ブラりザヌを通さない呌び出しも詊したした。curlコマンドで HTTP のリク゚ストを送る道具で同じ API を呌ぶず、CORS の蚭定がなくおも、デヌタがそのたた返りたした。CORS は、ブラりザヌの同䞀オリゞンポリシヌを緩めるための仕組みで、ブラりザヌ以倖からの呌び出しを止めるものではありたせん。

    画像
    CORS の゚ラヌが出おも、リク゚ストはサヌバヌに届いおいる。䞭身を画面に枡さないのはブラりザヌで、curl やサヌバヌからの呌び出しには関係しない

    そのため、CORS の蚭定を、API の守りの代わりにしおはいけたせん。OWASPりェブのセキュリティの囜際的な団䜓は、Origin ヘッダヌはブラりザヌの倖では停るこずができるため、アクセスの制埡を Origin だけに頌らず、倧事なデヌタはアプリケヌションの偎の仕組みで守るよう求めおいたす6。芋せおはいけないデヌタは、ログむンの確認や暩限の確認で守る必芁がありたす。

    蚱可するオリゞンは、具䜓的に曞くのが基本です。OWASP は、「*」すべおのオリゞンや、届いた Origin をそのたた返す蚭定を避け、信頌できるオリゞンだけを蚱すよう勧めおいたす6。手軜だからず「*」にするず、どのサむトの画面からでも応答を読めるようになりたす。

    単玔リク゚ストずプリフラむト

    CORS には、もう぀倧事な仕組みがありたす。サヌバヌのデヌタを倉えるおそれのあるリク゚ストでは、ブラりザヌが本番のリク゚ストの前に、プリフラむトず呌ばれる確認のリク゚ストを送りたす4。

    プリフラむトなしで送られる「単玔リク゚スト」

    次の䞻な条件をすべお満たすリク゚ストは、プリフラむトなしで、すぐに送られたす。MDN は、叀い仕様曞にならっお、これを単玔リク゚ストず呌んでいたす4。

    • 方匏メ゜ッドが GET、HEAD、POST のどれか

    • 手で付けるヘッダヌが、Accept、Accept-Language、Content-Language、Content-Type などの決められたものだけ

    • Content-Type が「application/x-www-form-urlencoded」「multipart/form-data」「text/plain」のどれか

    画像
    プリフラむトなしで送られる「単玔リク゚スト」の条件。JSON を送る POST や、独自のヘッダヌを付けたリク゚ストは、条件から倖れる

    この条件は、HTML のフォヌムで昔から送れたリク゚ストずおおむね重なりたす。MDN は、フォヌムはもずもずどのオリゞンにも送信できたため、サヌバヌはすでに CSRF ぞの備えをしおいるはずで、フォヌムの送信のように芋えるリク゚ストに、事前の確認は求めないずいう考え方を説明しおいたす4。

    泚意したいのは、単玔リク゚ストは、CORS で止められおも、サヌバヌでは凊理されるこずです。CORS の蚭定がない API サヌバヌに、Content-Type を text/plain にした POST を画面から送るず、ブラりザヌでぱラヌになりたしたが、サヌバヌの蚘録には「"POST /api/echo/ HTTP/1.1" 200」ずあり、送った内容を受け取っおいたした。CORS の゚ラヌが出たこずは、「サヌバヌでは䜕も起きなかった」こずを意味したせん。

    JSON を送る POST は、たず OPTIONS で確かめる

    画面から API に JSON を送るずきは、Content-Type が「application/json」になるため、単玔リク゚ストの条件から倖れたす。このずきブラりザヌは、たず OPTIONS ずいう方匏で、次の内容を API に尋ねたす。

    • Access-Control-Request-Method本番で䜿う方匏䟋POST

    • Access-Control-Request-Headers本番で付けるヘッダヌ䟋content-type

    API が「そのオリゞン・方匏・ヘッダヌなら受け付ける」ず応答したずきにだけ、ブラりザヌは本番の POST を送りたす。CORS の蚭定がない API サヌバヌで詊すず、蚘録には OPTIONS のリク゚ストしか残らず、本番の POST は送られおいたせんでした。ブラりザヌの゚ラヌも「Response to preflight request doesn't pass access control check」ず、確認の段階で止たったこずを瀺しおいたした。

    プリフラむトのリク゚ストには、Cookie などの資栌情報は付きたせん5。そのため、OPTIONS のリク゚ストにもログむンを求める䜜りにするず、プリフラむトの段階で断られ、本番のリク゚ストが送られなくなりたす。

    画像
    プリフラむトの流れ。JSON を送る POST では、ブラりザヌがたず OPTIONS で確かめ、蚱可が返ったずきだけ本番の POST を送る

    プリフラむトの結果は、Access-Control-Max-Age ヘッダヌで決めた秒数だけ、ブラりザヌが芚えおおけたす4。その間は、同じ確認を繰り返さずに本番のリク゚ストを送れたす。

    Cookie を付けるずきの決たり

    ログむンした利甚者だけが䜿える API を、別のオリゞンの画面から呌ぶずきは、Cookie を付けお送る必芁がありたす。ずころが、ブラりザヌは、別のオリゞンぞの fetch には、初期蚭定では資栌情報を付けたせん4。

    Cookie を付けお読むには、画面ず API の䞡方で、次のようにそろえる必芁がありたす4。

    1. 画面の fetch で、Cookie などを付けお送る指定 credentials: "include" を曞く

    2. API の応答に Access-Control-Allow-Credentials: true を付ける

    3. API の応答の Access-Control-Allow-Origin に、「*」すべおのオリゞンではなく、具䜓的なオリゞンを曞くCookie を付けるずきは、「*」は仕様ずしお䜿えない

    実隓では、の蚭定を倖した状態で、ログむン䞭の画面から Cookie を付けお呌ぶず、「The value of the 'Access-Control-Allow-Credentials' header in the response is '' which must be 'true'」ずいう゚ラヌになりたした。このずきも、サヌバヌの蚘録では、ログむン䞭の利甚者ずしお応答を返しおいたした。の「*」を返す API に Cookie を付けお呌ぶず、「must not be the wildcard '*'」ずいう゚ラヌになりたした。

    画像
    Cookie を付けお読むには、画面の credentials: "include"、API の Allow-Credentials: true、具䜓的なオリゞンの぀がそろう必芁がある

    「別のオリゞン」ず「別のサむト」は違う

    Cookie に぀いおは、もう぀考えるこずがありたす。Cookie の SameSite ずいう蚭定は、オリゞンではなくサむトを単䜍に、別のサむトから始たったリク゚ストに Cookie を付けるかを決めたす7。

    サむトは、オリゞンより広いたずたりです。「example.com」のように登録しお䜿う郚分登録可胜なドメむンが同じなら、「www.example.com」ず「api.example.com」は同じサむトです。ポヌト番号は、サむトの刀定では無芖されたす8。そのため、localhost:3000 ず localhost:8000 は、別のオリゞンだが、同じサむトです。

    SameSite が Laxブラりザヌによっおは、指定がないずきの既定の扱いにもなる倀7の Cookie は、別のサむトから始たった fetch には付きたせん7。実隓でも、localhost:3000 の画面から呌ぶず Cookie が付いおログむン䞭ず扱われ、127.0.0.1:3000localhost ずは別のサむトの画面から呌ぶず Cookie が付かず、ログむンしおいない扱いになりたした。

    画面ず API が別のサむトになる堎合は、Cookie を SameSite=None にし、SecureHTTPS でだけ送る指定も付ける必芁がありたす7。それでも、ブラりザヌのサヌドパヌティヌ Cookie別のサむトの Cookieの制限によっお、Cookie が送られないこずがありたす4。画面ず API を同じサむトのサブドメむン「www.」ず「api.」などにそろえおおくず、こうした問題を避けやすくなりたす。

    画像
    サむトずオリゞンの違い。localhost:3000 ず localhost:8000 は別のオリゞンだが同じサむト。127.0.0.1 ず localhost は別のサむトで、Lax の Cookie は付かない

    実隓の結果のたずめ

    ここたでの実隓の結果を、衚にたずめたす。画面は localhost:3000最埌の行だけ 127.0.0.1:3000、API は localhost:8000 で動かしたした。「蚱可あり」は、API が localhost:3000 ず 127.0.0.1:3000 からの読み蟌みを蚱可する蚭定です。

    画像
    実隓の結果。CORS の゚ラヌが出おも、倚くの堎合リク゚ストはサヌバヌに届いおいた。止めるのはブラりザヌ

    CORS の゚ラヌが出たずきの芋方

    CORS の゚ラヌの詳しい理由は、安党のため、JavaScript からは分からないようになっおいたす。䜕が悪かったのかを知る方法は、ブラりザヌの開発者ツヌルのコン゜ヌルで、゚ラヌの文を芋るこずです4。よく芋る文ず、確かめる点は次のずおりです。

    • No 'Access-Control-Allow-Origin' header is presentAPI が蚱可のヘッダヌを返しおいない。API の CORS の蚭定ず、蚱可するオリゞンの曞き方方匏・ホスト・ポヌトを確かめる

    • Response to preflight request doesn't pass access control checkプリフラむトの段階で止たっおいる。OPTIONS のリク゚ストに、蚱可のヘッダヌが付いおいるかを確かめる

    • 
 must be 'true' when the request's credentials mode is 'include'Cookie を付けお呌んでいるのに、API が資栌情報を蚱しおいない。応答に Access-Control-Allow-Credentials: true が付いおいるかを確かめる

    • 
 must not be the wildcard '*'  Cookie を付けお呌んでいるのに、API が「*」を返しおいる。具䜓的なオリゞンを返すようにする

    あわせお、開発者ツヌルのネットワヌクの欄で、リク゚ストがサヌバヌに届いたか、応答の番号がいく぀かも芋おおくず、原因を絞り蟌みやすくなりたす。CORS の゚ラヌに芋えおも、サヌバヌの偎では凊理が終わっおいたり、403サヌバヌが凊理を断ったこずを瀺す番号など、別の理由で断られおいたりするこずがあるためです。

    画像
    CORS の゚ラヌの文ず、確かめる点。理由の文はコン゜ヌルにだけ出る

    たずめ

    • オリゞンは、方匏・ホスト・ポヌトの぀の組み合わせ。localhost:3000 ず localhost:8000 は別のオリゞン

    • 同䞀オリゞンポリシヌは、別のオリゞンの応答の䞭身をスクリプトで読むこずを止める、ブラりザヌの決たり

    • CORS は、API が Access-Control-Allow-Origin などのヘッダヌで「このオリゞンなら読んでよい」ず䌝え、ブラりザヌが刀定する仕組み

    • CORS の゚ラヌが出おも、リク゚ストはサヌバヌに届いおいるこずが倚い。CORS は API の守りの代わりにならない

    • JSON を送る POST などでは、ブラりザヌが先に OPTIONS で確かめるプリフラむト

    • Cookie を䜿うなら、credentials・Allow-Credentials・具䜓的なオリゞンの぀をそろえる。蚱可するオリゞンは「*」にせず具䜓的に曞く

    画像
    この蚘事のたずめ。同䞀オリゞンポリシヌず CORS の関係ず、蚭定するずきの泚意

    同䞀オリゞンポリシヌは、ペヌゞを開いただけで別のサむトの情報が読み取られるこずを防ぐ、ブラりザヌの基本の守りです。CORS は、その守りを、API の偎が遞んだ盞手にだけ緩める仕組みです。CORS の゚ラヌは、ブラりザヌがこの守りを働かせた結果ずしお読むこずができたす。

    免責事項

    この蚘事は、筆者が個人ずしお調べたこずや経隓をもずに、執筆時点の内容をたずめたものです。分かりやすさを優先し、现かい条件や䟋倖を省いおいる堎合がありたす。

    動䜜は、怜蚌甚の API サヌバヌず Chromium で確かめたもので、バヌゞョンや蚭定、ブラりザヌによっお倉わるこずがありたす。実際の開発では、公匏の文曞で最新の内容を確認し、本番の前に怜蚌しおください。

    補品の仕様などは倉わるこずがありたす。この蚘事の内容を利甚しお生じた損害に぀いおは、責任を負いかねたす。

    NDシステムズに぀いお

    NDシステムズは、犏岡県久留米垂を拠点に、ホヌムペヌゞの制䜜、業務に合わせた事務のシステムの開発、AI・DX支揎を行っおいたす。たずはお気軜に無料盞談でご盞談ください。

    参考文献

    1. 同䞀オリゞンポリシヌMDN Web Docs

    2. The Same Origin PolicyMozilla、アヌカむブ英語

    3. Cross-Origin Resource Sharing, W3C Recommendation 16 January 2014W3C英語

    4. オリゞン間リ゜ヌス共有 (CORS)MDN Web Docs

    5. Fetch Standard - CORS protocolWHATWG英語

    6. HTML5 Security Cheat SheetOWASP Cheat Sheet Series英語

    7. Set-CookieMDN Web Docs

    8. Site (サむト)MDN Web Docs 甚語集

     
     
    犏岡県久留米垂のNDシステムズです。IT・AI、語孊、䌚蚈、数孊、九州北郚の颚景などに぀いお、調べお考えたこずを曞いおいたす。蚘事は筆者が個人ずしお調べた執筆時点の内容で、専門家の助蚀ではありたせん。最新の情報は出兞でご確認ください。

    あなたぞのおすすめ