GiaoThuc.comGiao Thức
HTTP và cách web nói chuyện

CORS là gì: chính sách cùng nguồn, preflight và vì sao lỗi chỉ có trên trình duyệt

CORS là gì, chính sách cùng nguồn chặn điều gì, khi nào trình duyệt gửi yêu cầu preflight, cookie đi kèm ra sao và cách gỡ lỗi CORS theo đúng thứ tự.

Apartment building lobby in Thu Duc at evening, security guard at a desk seen from behind checking a resident card, glass doors, neat rows of mailboxes, warm interior light

CORS (Cross-Origin Resource Sharing – chia sẻ tài nguyên khác nguồn) là cơ chế để máy chủ báo cho trình duyệt biết những trang nào, từ nguồn khác, được phép đọc phản hồi của mình. Mặc định, trình duyệt áp dụng chính sách cùng nguồn: mã JavaScript của trang này không đọc được dữ liệu trả về từ một nguồn khác. CORS không dựng thêm hàng rào mà mở cửa có kiểm soát trên hàng rào sẵn có đó, bằng vài header Access-Control.

Vì CORS là luật do trình duyệt thực thi, lỗi CORS chỉ xuất hiện trong trình duyệt: cùng một yêu cầu gửi bằng curl hay từ máy chủ khác thì chạy bình thường. Bài này giải thích nguồn là gì, yêu cầu đơn giản và yêu cầu kiểm tra trước khác nhau ra sao, cookie đi kèm thế nào, và gỡ một lỗi CORS theo thứ tự nào. Cơ chế CORS hiện được mô tả trong tiêu chuẩn Fetch của nhóm WHATWG.

Chính sách cùng nguồn: hàng rào mà CORS mở cửa

Hình dung một toà chung cư có hệ thống hộp thư ở sảnh. Ai cũng có thể bỏ thư vào hộp của bất kỳ căn hộ nào, nhưng bảo vệ chỉ cho bạn mở hộp của chính mình. Chủ căn hộ khác muốn cho bạn lấy thư hộ thì phải dặn bảo vệ trước. Chính sách cùng nguồn của trình duyệt giống hệt: trang của bạn gửi được yêu cầu đi nhiều nơi, nhưng không được đọc thứ trả về từ nơi khác, trừ khi nơi đó đã dặn trước bằng header CORS.

Nguồn (origin) gồm ba phần: giao thức, tên máy và cổng. Hai địa chỉ cùng nguồn khi cả ba phần trùng khớp; lệch một phần là khác nguồn. Đường dẫn không tính. Vì thế trang ở cổng 3000 trên máy phát triển gọi API ở cổng 8000 cùng máy là gọi khác nguồn, và đó là lần đầu tiên rất nhiều lập trình viên gặp lỗi CORS.

Điều quan trọng nhất cần nhớ: chính sách cùng nguồn chủ yếu chặn việc đọc, không chặn việc gửi. Một trang lạ vẫn có thể khiến trình duyệt gửi biểu mẫu, tải ảnh, nhúng tệp script từ nguồn khác; đó là cách web vẫn hoạt động từ trước khi có CORS. Thứ bị chặn là mã JavaScript đọc nội dung phản hồi. Lý do: nếu đọc được, một trang lạ có thể âm thầm lấy hộp thư, sao kê ngân hàng của bạn ở trang khác, nhờ cookie đăng nhập trình duyệt tự gửi kèm.

Cùng nguồn hay khác nguồn: so từng phần

Lấy trang gốc là giao thức https, tên máy app.vidu.vn, cổng 443 (cổng mặc định của https). Bảng dưới so một số địa chỉ giả định với trang gốc đó:

Địa chỉ được gọiKết quảLý do
https, app.vidu.vn, đường dẫn /api/don-hangCùng nguồnBa phần trùng; đường dẫn không tính
http, app.vidu.vnKhác nguồnKhác giao thức, kéo theo khác cổng mặc định
https, api.vidu.vnKhác nguồnKhác tên máy, dù cùng tên miền gốc
https, vidu.vnKhác nguồnTên máy khác, không có tiền tố app
https, app.vidu.vn, cổng 8443Khác nguồnKhác cổng
https, app.vidu.vn, cổng 443 ghi rõCùng nguồnCổng ghi rõ trùng cổng mặc định

Dòng thứ ba hay gây bất ngờ nhất: trang app và API api cùng thuộc một công ty, cùng tên miền gốc, nhưng với trình duyệt chúng là hai nguồn khác nhau. Khái niệm cùng site rộng hơn, xét theo tên miền đăng ký, được dùng cho cookie SameSite chứ không dùng cho chính sách cùng nguồn.

Yêu cầu đơn giản: hỏi bằng Origin, trả lời bằng Access-Control-Allow-Origin

Với yêu cầu thoả điều kiện "đơn giản" (bàn ở mục sau), trình duyệt không hỏi trước mà gửi thẳng. Trình tự như sau:

  1. Mã JavaScript trên trang app gọi hàm fetch tới API ở nguồn khác.
  2. Trình duyệt gửi yêu cầu, tự thêm header Origin ghi nguồn của trang đang chạy mã. Mã JavaScript không sửa được header này.
  3. Máy chủ API xử lý yêu cầu như mọi yêu cầu khác. Nếu đồng ý cho nguồn đó đọc, nó thêm vào phản hồi Access-Control-Allow-Origin với giá trị là đúng nguồn ấy, hoặc dấu sao để cho mọi nguồn.
  4. Trình duyệt nhận phản hồi, so header Access-Control-Allow-Origin với nguồn của trang. Khớp thì giao phản hồi cho mã JavaScript. Không khớp hoặc thiếu header, trình duyệt giữ phản hồi lại, báo lỗi CORS trong bảng điều khiển, và mã JavaScript chỉ nhận một lỗi mạng chung chung.
  5. Ngay cả khi được đọc, mã JavaScript chỉ thấy một nhóm header phản hồi an toàn như Content-Type, Content-Length, Cache-Control. Muốn lộ thêm header riêng, máy chủ phải liệt kê chúng trong Access-Control-Expose-Headers.

Để ý bước ba: máy chủ đã xử lý yêu cầu rồi mới tới lượt trình duyệt quyết định cho đọc hay không. Nếu yêu cầu đơn giản đó là một POST làm thay đổi dữ liệu, thay đổi đã xảy ra dù trang không đọc được kết quả. Đó là lý do CORS không thay được biện pháp chống giả mạo yêu cầu liên trang.

Yêu cầu kiểm tra trước (preflight): khi nào xảy ra và trông ra sao

Một yêu cầu được coi là đơn giản khi phương thức là GET, HEAD hoặc POST; chỉ dùng các header nằm trong danh sách an toàn như Accept, Accept-Language, Content-Language; và nếu có Content-Type thì chỉ là một trong ba giá trị mà biểu mẫu HTML vốn gửi được: application/x-www-form-urlencoded, multipart/form-data, text/plain. Ý tưởng là: những gì một biểu mẫu HTML thời xưa đã làm được thì CORS không bắt hỏi thêm, vì máy chủ vốn đã phải chịu được chúng.

Vượt ra ngoài điều kiện đó, ví dụ gửi PUT hay DELETE, gửi JSON với Content-Type application/json, hay thêm header Authorization, trình duyệt phải hỏi trước. Nó gửi một yêu cầu OPTIONS tới cùng địa chỉ, kèm Origin, Access-Control-Request-Method nêu phương thức định dùng và Access-Control-Request-Headers nêu các header định gửi. Yêu cầu hỏi trước không mang thân và không mang cookie.

Máy chủ đồng ý thì trả một phản hồi mã 2xx, thường là 204, với Access-Control-Allow-Origin, Access-Control-Allow-Methods, Access-Control-Allow-Headers, và tuỳ chọn Access-Control-Max-Age cho biết kết quả hỏi trước được nhớ bao nhiêu giây. Chỉ khi câu trả lời đạt, trình duyệt mới gửi yêu cầu thật. Trình duyệt tự đặt trần cho thời gian nhớ, nên đặt Max-Age rất lớn cũng không có tác dụng vượt trần đó.

Hỏi trước tốn thêm một lượt đi và về cho mỗi tổ hợp địa chỉ và header chưa được nhớ. Với ứng dụng gọi API dày đặc, đó là độ trễ cộng thêm đáng kể, và là lý do có đội ngũ đặt API cùng nguồn với trang qua proxy ngược để tránh CORS hoàn toàn.

Cookie và CORS: Allow-Credentials và vì sao không được dùng dấu sao

Mặc định, yêu cầu fetch khác nguồn không gửi kèm cookie và không nhận Set-Cookie. Muốn gửi, mã JavaScript phải bật chế độ credentials: "include", và máy chủ phải đồng ý bằng header Access-Control-Allow-Credentials: true. Thiếu một trong hai, trình duyệt hoặc không gửi cookie, hoặc gửi nhưng không cho mã đọc phản hồi.

Khi có cookie, quy tắc chặt hơn: Access-Control-Allow-Origin không được là dấu sao, mà phải ghi đúng một nguồn cụ thể. Lý do là cookie mang danh tính người dùng; cho mọi trang trên Internet đọc phản hồi có danh tính là quá nguy hiểm để cho phép bằng một ký tự. Máy chủ phục vụ nhiều nguồn thường đọc header Origin, so với danh sách cho phép, rồi phản chiếu lại đúng nguồn đó.

Phản chiếu nguồn kéo theo hai việc phải làm. Thứ nhất, thêm Vary: Origin để bộ nhớ đệm không đưa phản hồi đã ghi nguồn A cho trang ở nguồn B. Thứ hai, so với danh sách chính xác, không so kiểu "chuỗi có chứa vidu.vn", vì một tên miền như vidu.vn.trang-la.com cũng chứa chuỗi đó. Phản chiếu mọi nguồn kèm Allow-Credentials là một lỗi cấu hình nghiêm trọng: nó tái tạo đúng lỗ hổng mà chính sách cùng nguồn sinh ra để chặn.

Cuối cùng, cookie còn chịu luật SameSite riêng. Cookie Lax hoặc Strict sẽ không đi kèm yêu cầu fetch từ trang khác site, dù CORS đã cho phép, nên cookie dùng cho API khác site thường phải đặt SameSite=None kèm Secure.

Vì sao lỗi CORS chỉ có trên trình duyệt, và vài hiểu lầm

CORS là luật của trình duyệt, không phải của máy chủ. Máy chủ chỉ gửi header; trình duyệt mới là bên chặn. curl, ứng dụng di động, mã chạy trên máy chủ không thực thi CORS, nên cùng yêu cầu chạy bình thường ở đó. Thấy curl chạy được không chứng minh máy chủ cấu hình CORS đúng.

CORS không bảo vệ máy chủ. Kẻ tấn công dùng công cụ ngoài trình duyệt gọi API của bạn thoải mái. CORS bảo vệ người dùng của trình duyệt khỏi việc một trang lạ đọc dữ liệu của họ ở trang khác. Xác thực và phân quyền phía máy chủ vẫn phải làm đầy đủ.

Chế độ no-cors không phải cách vượt CORS. Đặt mode no-cors trong fetch làm lỗi biến mất nhưng phản hồi trở thành mờ đục: mã không đọc được thân, không thấy mã trạng thái. Chế độ này dành cho việc tải tài nguyên để trình duyệt tự dùng, không dành cho đọc dữ liệu API.

Tắt kiểm tra bảo mật của trình duyệt không phải cách chữa. Mở trình duyệt với tuỳ chọn tắt bảo mật web chỉ che lỗi trên máy của bạn; người dùng thật vẫn gặp lỗi. Cách chữa là sửa header ở máy chủ, hoặc đặt API cùng nguồn qua proxy.

Lỗi CORS đôi khi che một lỗi khác. Khi máy chủ gặp lỗi 500 và trả trang lỗi mặc định không có header CORS, trình duyệt báo lỗi CORS thay vì lỗi 500. Hãy xem thẻ Network để biết mã trạng thái thật trước khi sửa cấu hình CORS.

Gỡ một lỗi CORS theo đúng thứ tự

Lỗi CORS trong bảng điều khiển của trình duyệt thường ghi khá rõ thiếu gì. Làm theo thứ tự dưới đây trên hệ thống của bạn, mỗi bước loại được một nhóm nguyên nhân:

  1. Đọc kỹ thông báo lỗi trong bảng điều khiển: thiếu Access-Control-Allow-Origin, nguồn không khớp, header không được phép, hay vướng chuyện cookie với dấu sao.
  2. Mở thẻ Network, tìm xem có yêu cầu OPTIONS đi trước không. Có thì kiểm mã trạng thái của nó: phải là 2xx. Hỏi trước bị 401, 404 hay chuyển hướng là thất bại ngay, vì yêu cầu hỏi trước không mang thông tin đăng nhập.
  3. So header Access-Control-Allow-Origin trong phản hồi với nguồn của trang, từng ký tự: giao thức, tên máy, cổng, kể cả dấu gạch chéo thừa ở cuối.
  4. Nếu yêu cầu gửi header riêng hoặc Content-Type JSON, kiểm Access-Control-Allow-Headers có liệt kê đủ chưa; nếu dùng PUT, DELETE thì kiểm Access-Control-Allow-Methods.
  5. Nếu cần cookie, kiểm cả ba: credentials include ở phía mã, Allow-Credentials true, và Allow-Origin là nguồn cụ thể, không phải dấu sao. Kiểm thêm thuộc tính SameSite của cookie.
  6. Kiểm mã trạng thái của yêu cầu thật. Nếu là 4xx, 5xx, hãy bảo đảm cả phản hồi lỗi cũng mang header CORS, để mã của trang đọc được thông báo lỗi thay vì một lỗi mạng mù mờ.

Phần lớn lỗi CORS thực tế rơi vào bước hai và bước ba: yêu cầu hỏi trước bị một lớp xác thực hay tường lửa chặn trước khi tới phần mã xử lý CORS, hoặc nguồn khai báo lệch một chi tiết nhỏ.

Câu hỏi thường gặp

CORS có cần cấu hình ở phía trang gọi không?

Hầu như không. Trang gọi chỉ quyết định có gửi kèm cookie hay không và gửi header gì; toàn bộ quyền cho phép nằm ở header phản hồi của máy chủ đích. Nếu bạn không kiểm soát máy chủ đích, cách hợp lệ là gọi qua máy chủ của chính mình thay vì gọi thẳng từ trình duyệt.

Ảnh và tệp script từ nguồn khác có bị CORS chặn không?

Thẻ ảnh, thẻ script, thẻ link CSS từ nguồn khác vẫn tải và dùng được như trước khi có CORS. CORS chỉ vào cuộc khi mã cần đọc nội dung, ví dụ vẽ ảnh lên canvas rồi lấy dữ liệu điểm ảnh, hoặc khi thẻ được gắn thuộc tính crossorigin. Phông chữ web tải từ nguồn khác thì trình duyệt luôn yêu cầu CORS.

Đặt Access-Control-Allow-Origin là dấu sao có nguy hiểm không?

Với dữ liệu công khai, không cần đăng nhập, như một API tra cứu mở, dấu sao là hợp lý. Nguy hiểm nằm ở dữ liệu riêng tư dựa vào thứ khác ngoài cookie để xác thực, như địa chỉ IP nội bộ: dấu sao cho phép mọi trang đọc dữ liệu đó qua trình duyệt của người dùng trong mạng nội bộ.

Vì sao yêu cầu OPTIONS xuất hiện trong nhật ký máy chủ nhiều như vậy?

Mỗi tổ hợp địa chỉ, phương thức và header chưa được trình duyệt nhớ đều cần một lượt hỏi trước. Ứng dụng gọi nhiều đường dẫn khác nhau với header Authorization sẽ sinh rất nhiều OPTIONS. Đặt Access-Control-Max-Age hợp lý và hạn chế header tuỳ biến giúp giảm số lượt này.

WebSocket có chịu CORS không?

Không theo cùng cơ chế. Bắt tay WebSocket gửi kèm header Origin nhưng trình duyệt không chặn kết nối dựa trên header phản hồi. Máy chủ WebSocket phải tự kiểm Origin và từ chối nguồn không được phép; quên bước này là để trang lạ mở kết nối tới máy chủ bằng cookie của người dùng.

Đặt API và trang web cùng tên máy có hết lo CORS không?

Có, nếu cùng giao thức, tên máy và cổng thì không còn khác nguồn, nên không cần header CORS và không có yêu cầu hỏi trước. Nhiều hệ thống làm vậy bằng cách để proxy ngược chuyển các đường dẫn bắt đầu bằng /api vào máy chủ API. Đổi lại, bạn mất khả năng tách API sang tên máy riêng.

Cần tư vấn cụ thể cho trường hợp của bạn?

Chúng tôi sẽ liên hệ trong vòng 24 giờ.

Đăng ký tư vấn ngay

Bài viết liên quan

Bạn cần hỗ trợ thêm?

Để lại thông tin, chúng tôi sẽ liên hệ trong 24 giờ.

hoặc
Gọi ngay 0926 138 138