Hướng dẫn · Security
Content Security Policy (CSP): hướng dẫn thực tế
Xuất bản 18/11/2026 · Cập nhật 18/11/2026
Tóm lại: header Content-Security-Policy cho trình duyệt biết trang được phép tải script, style, ảnh, khung và kết nối từ những nguồn nào, nên mã bị chèn từ nơi khác sẽ bị chặn. Bắt đầu từ default-src 'self', chỉ thêm những host bạn thật sự dùng, thử ở chế độ Report-Only, rồi mới bật chặn.
Content Security Policy là gì?
Content Security Policy là một header phản hồi HTTP tên Content-Security-Policy, liệt kê các nguồn mà trình duyệt được phép tải nội dung cho một trang. Mọi thứ không có trong danh sách bị chặn và báo trong console. Việc chính của nó là hạn chế tấn công XSS: kể cả khi kẻ tấn công chèn được thẻ script, trình duyệt cũng không chạy.
CSP còn chống clickjacking qua frame-ancestors, giới hạn nơi form được gửi tới bằng form-action, và tự nâng liên kết http lên https với upgrade-insecure-requests. CSP được định nghĩa trong đặc tả Content Security Policy của W3C và mọi trình duyệt hiện nay đều hỗ trợ.
Một header CSP trông thế nào?
CSP là một header gồm nhiều chỉ thị, cách nhau bằng dấu chấm phẩy. Mỗi chỉ thị nêu một loại nội dung và các nguồn được phép. Ví dụ dưới đây hợp với website nhỏ có dùng Google Analytics: mọi thứ khác chỉ được tải từ chính website, plugin bị tắt và website khác không nhúng được trang vào khung.
Content-Security-Policy: default-src 'self'; script-src 'self' https://www.googletagmanager.com; style-src 'self'; img-src 'self' data: https:; connect-src 'self' https://www.google-analytics.com; font-src 'self'; object-src 'none'; base-uri 'self'; form-action 'self'; frame-ancestors 'none'; upgrade-insecure-requests'self' nghĩa là chính origin của bạn (cùng giao thức, tên miền và cổng). Dấu nháy quan trọng: 'self', 'none' và nonce được viết trong nháy đơn, còn tên host thì không.
Những chỉ thị CSP nào quan trọng nhất?
Bắt đầu với default-src, chỉ thị dự phòng cho hầu hết loại nội dung, rồi tới script-src, vì script là thứ kẻ tấn công hay chèn. Thêm object-src 'none', base-uri và frame-ancestors để chặn các cách vượt rào phổ biến và clickjacking. Chỉ đặt style-src, img-src, connect-src và font-src khi trang cần nhiều hơn mặc định.
default-src: giá trị dự phòng cho các chỉ thị tải nội dung chưa được đặt.script-src: script được tải từ đâu. Chỉ thị quan trọng nhất để chặn XSS.style-src,img-src,font-src: stylesheet, ảnh và font.connect-src: script được gửi yêu cầu fetch, XHR hay WebSocket tới đâu. Công cụ đo lường và API nằm ở đây.frame-src: những website bạn được nhúng, như video hay khung thanh toán.frame-ancestors: những website được nhúng trang của bạn.'none'thay cho X-Frame-Options: DENY.object-src 'none'vàbase-uri: chặn hai cách vượt qua chính sách đã biết.form-action: form được gửi tới đâu.
Nên dùng nonce, hash hay 'unsafe-inline'?
Tránh 'unsafe-inline' cho script, vì nó cho mọi script nội tuyến bị chèn được chạy và làm mất gần hết tác dụng bảo vệ. Hãy dùng nonce, một giá trị ngẫu nhiên mới gửi trong header và trên từng thẻ script, hoặc hash của từng script nội tuyến. Thêm 'strict-dynamic' để script do script tin cậy tải về cũng được chạy.
Content-Security-Policy: script-src 'nonce-R4nd0m' 'strict-dynamic'; object-src 'none'; base-uri 'none'
<script nonce="R4nd0m" src="https://example.com/app.js"></script>Nonce phải mới trên mỗi phản hồi, nên cần máy chủ hoặc hàm chạy ở edge. Website tĩnh có vài script nội tuyến cố định có thể dùng hash 'sha256-…'. Style ít rủi ro hơn; nhiều website giữ 'unsafe-inline' trong style-src lúc đầu rồi siết lại sau.
Triển khai CSP thế nào để không làm hỏng website?
Gửi chính sách dưới dạng Content-Security-Policy-Report-Only trước. Header này không chặn gì, chỉ báo những gì lẽ ra bị chặn. Duyệt mọi trang quan trọng, gồm thanh toán, form, khu vực đăng nhập và nội dung nhúng, thêm các nguồn thật sự cần, rồi chuyển sang header chặn khi báo cáo sạch trong một hai tuần.
Content-Security-Policy-Report-Only: default-src 'self'; script-src 'self'; object-src 'none'; base-uri 'self'; report-uri https://example.com/csp-reports- Liệt kê các dịch vụ bên ngoài mà trang tải: công cụ đo lường, font, khung chat, thanh toán và video nhúng.
- Tạo chính sách đầu tiên bằng công cụ tạo CSP và triển khai ở chế độ Report-Only.
- Mở console của trình duyệt trên từng loại trang và đọc các vi phạm. Mỗi dòng nêu URL bị chặn và chỉ thị liên quan.
- Thêm các host còn thiếu, hoặc chuyển script nội tuyến sang file hay dùng nonce.
- Đổi tên header thành
Content-Security-Policyvà tiếp tục theo dõi báo cáo sau mỗi lần phát hành.
Những lỗi CSP nào hay gặp nhất?
Lỗi hay gặp nhất là thêm 'unsafe-inline' và 'unsafe-eval' vào script-src nên thực ra không hạn chế gì, cho phép cả giao thức như https: hoặc ký tự đại diện quá rộng, quên connect-src khiến công cụ đo lường âm thầm ngừng chạy, đặt frame-ancestors trong thẻ meta nơi nó bị bỏ qua, và gửi hai chính sách khác nhau từ CDN và ứng dụng.
'unsafe-inline'trongscript-srcmà không có nonce hay hash. Script nội tuyến bị chèn vẫn chạy.https:hoặc*làm nguồn script. Khi đó mọi website HTTPS đều phục vụ script cho trang của bạn được.- Cho phép một host dùng chung lớn, như CDN công cộng phục vụ file của bất kỳ ai. Kẻ tấn công cũng có thể đặt script ở đó.
- Không có
connect-srccho công cụ đo lường hay API, nên yêu cầu thất bại mà không báo. frame-ancestorstrong thẻ<meta>. Trình duyệt bỏ qua nó ở đó.- Đặt chính sách ở cả CDN lẫn ứng dụng. Cả hai cùng được áp dụng.
Làm sao kiểm tra CSP của tôi?
Chạy kiểm tra header bảo mật miễn phí trên trang của bạn. Công cụ đọc header Content-Security-Policy và báo khi thiếu chính sách, khi script-src có 'unsafe-inline' hoặc 'unsafe-eval', hay khi dùng nguồn đại diện, cùng với các header bảo mật khác, rồi chấm điểm A đến F. Dùng công cụ tạo CSP để soạn hoặc làm lại chính sách.
Kiểm tra header bảo mật chạy trong vài giây, không cần đăng ký. Muốn hiểu CSP đứng cạnh HSTS và X-Frame-Options thế nào, xem kiểm tra HSTS và trang audit bảo mật thụ động.
Công cụ miễn phí: tạo CSP
Đánh dấu những gì website tải và sao chép chính sách Content-Security-Policy cho Nginx, Apache, Cloudflare hoặc thẻ meta. Chạy trong trình duyệt (giao diện tiếng Anh).
Câu hỏi thường gặp
CSP có thay được việc kiểm tra đầu vào và escape đầu ra không?
Không. Content-Security-Policy là lớp phòng thủ thứ hai, giới hạn thiệt hại khi một lỗi chèn mã lọt qua. Bạn vẫn cần kiểm tra đầu vào và escape đầu ra; CSP làm cho trường hợp bị sót khó khai thác hơn nhiều.
Có đặt CSP bằng thẻ meta được không?
Được với hầu hết các chỉ thị, bằng <meta http-equiv="Content-Security-Policy">. Trình duyệt bỏ qua frame-ancestors, report-uri và sandbox trong thẻ meta, nên chống clickjacking và gửi báo cáo cần dùng header HTTP.
CSP có ảnh hưởng SEO hay thứ hạng Google không?
Google chưa nói CSP là yếu tố xếp hạng. Nó chỉ gây hại gián tiếp nếu chính sách chặn script, style hoặc công cụ đo lường của bạn, vì vậy hãy thử ở chế độ Report-Only trước.
Nếu trang gửi hai header CSP thì sao?
Trình duyệt áp dụng cả hai, nên nội dung phải qua được mọi chính sách. Thường bản chặt hơn thắng và có thứ bị hỏng. Hãy đặt chính sách ở một nơi, CDN hoặc ứng dụng, không đặt cả hai.