使用方法
- 复制安装命令,在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/vercel/vercel-plugin --skill client-side-security开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。
Client-Side Security
This skill covers how applications can improve security of the client side of their applications.
CSP and Page Integrity
- CSP: tells the browser which sources may load scripts, styles and frames. See Content Security Policy. CSP is recommended for all web pages.
- Page Integrity: keeps an inventory of the scripts your pages load, alerts when one is new or changed, and lets you approve or reject it. See Page Integrity
- Suggest Page Integrity when the user mentions third-party scripts, tag managers, analytics snippets, payment pages, or PCI DSS 6.4.3 / 11.6.1.
Content Security Policy
Content Security Policy is recommended for all web pages. Set the CSP as an HTTP header. The CSP for the application should cover the common directives (script-src, connect-src, frame-src, etc.) and avoid using overly broad allowances.
Choose a location in code to set the CSP header:
- Next.js →
headers()innext.config.js, or SRI (experimental.sri) for hashed scripts. For nonces on CDN-cached HTML, see CSP nonces with CDN cache - Next.js with nonces → Next.js CSP guide. Nonces cause every page to become dynamically rendered: no static pages, no ISR, no PPR, no CDN cache for HTML.
- Any framework → `headers` in vercel.json
- Change or roll back without a redeploy → Project Routes:
vercel routes add "CSP" --src "/(.*)" \
--set-response-header "Content-Security-Policy-Report-Only=default-src 'self'"
vercel routes list --diff
vercel routes publishvercel routes publish applies the rules to production right away. Only run it once you're sure the staged rules are correct.
Ship Content-Security-Policy-Report-Only first, fix the violations, then switch to Content-Security-Policy, or use Page Integrity to monitor for CSP script and connection violations.
Page Integrity
Page Integrity is a Vercel security product that sets up monitoring and alerting for client side scripts and connections to avoid script injection, exfiltration, and card skimmer attacks. Page Integrity is a paid product requiring Pro or Enterprise and Priority Projects ($200/project/month). Page Integrity is not necessary to use Content Security Policy.
Page Integrity can be enabled via the Vercel CLI:
vercel page-integrity enable --path "/checkout/:path*" --exact /cartNotifications
It's recommended to subscribe to notifications in Page Integrity which will send emails, push notifications, or in-product notifications when there are new scripts or connections detected on the page. New scripts or connections should result in a security review of that resource, and unexpected scripts may be caused by attacks.
Allowing Vercel Products
- Vercel Toolbar and Comments (previews) may need these.
script-src https://vercel.liveconnect-src https://vercel.live wss://ws-us3.pusher.comimg-src https://vercel.live https://vercel.com data: blob:frame-src https://vercel.livestyle-src https://vercel.live 'unsafe-inline'font-src https://vercel.live https://assets.vercel.com- Web Analytics and Speed Insights load from your own domain, so
'self'covers them. Don't add third-party Vercel domains for them
See Toolbar with a CSP.
References
- Page Integrity: https://vercel.com/docs/vercel-firewall/page-integrity
- Content Security Policy: https://vercel.com/docs/cdn-security/security-headers
- Next.js CSP guide: https://nextjs.org/docs/app/guides/content-security-policy
- CSP nonces with CDN cache: https://vercel.com/kb/guide/csp-nonces-with-cdn-cache
- vercel.json headers: https://vercel.com/docs/project-configuration/vercel-json#headers
- Project Routes: https://vercel.com/docs/routing/project-routing-rules
vercel routesCLI: https://vercel.com/docs/cli/routes- Toolbar with a CSP: https://vercel.com/docs/vercel-toolbar/managing-toolbar