CSP: frame-src - [ HTTP 中文开发手册 ] - 在线原生手册

简体中文(ZH-CN) English(EN) 繁体中文(ZH-TW) 日本語(JA) 한국어(KO) Melayu(MS) Français(FR) Deutsch(DE)

directory search

Guides Access control CORS Authentication Browser detection using the user agent Caching Caching FAQ Compression Conditional requests Connection management in HTTP 1.x Content negotiation Content negotiation: List of default Accept values Cookies CSP Messages Overview Protocol upgrade mechanism Proxy servers and tunneling Proxy servers and tunneling: Proxy Auto-Configuration (PAC) file Public Key Pinning Range requests Redirections Resources and specifications Resources and URIs Response codes Server-Side Access Control Session Guides: Basics Basics of HTTP Choosing between www and non-www URLs Data URIs Evolution of HTTP Identifying resources on the Web MIME Types MIME types: Complete list of MIME types CSP Content-Security-Policy Content-Security-Policy-Report-Only CSP: base-uri CSP: block-all-mixed-content CSP: child-src CSP: connect-src CSP: default-src CSP: font-src CSP: form-action CSP: frame-ancestors CSP: frame-src CSP: img-src CSP: manifest-src CSP: media-src CSP: object-src CSP: plugin-types CSP: referrer CSP: report-uri CSP: require-sri-for CSP: sandbox CSP: script-src CSP: style-src CSP: upgrade-insecure-requests CSP: worker-src Headers Accept Accept-Charset Accept-Encoding Accept-Language Accept-Ranges Access-Control-Allow-Credentials Access-Control-Allow-Headers Access-Control-Allow-Methods Access-Control-Allow-Origin Access-Control-Expose-Headers Access-Control-Max-Age Access-Control-Request-Headers Access-Control-Request-Method Age Allow Authorization Cache-Control Connection Content-Disposition Content-Encoding Content-Language Content-Length Content-Location Content-Range Content-Type Cookie Cookie2 Date DNT ETag Expect Expires Forwarded From Headers Host If-Match If-Modified-Since If-None-Match If-Range If-Unmodified-Since Keep-Alive Large-Allocation Last-Modified Location Origin Pragma Proxy-Authenticate Proxy-Authorization Public-Key-Pins Public-Key-Pins-Report-Only Range Referer Referrer-Policy Retry-After Server Set-Cookie Set-Cookie2 SourceMap Strict-Transport-Security TE Tk Trailer Transfer-Encoding Upgrade-Insecure-Requests User-Agent User-Agent: Firefox Vary Via Warning WWW-Authenticate X-Content-Type-Options X-DNS-Prefetch-Control X-Forwarded-For X-Forwarded-Host X-Forwarded-Proto X-Frame-Options X-XSS-Protection Methods CONNECT DELETE GET HEAD Methods OPTIONS PATCH POST PUT Status 100 Continue 101 Switching Protocols 200 OK 201 Created 202 Accepted 203 Non-Authoritative Information 204 No Content 205 Reset Content 206 Partial Content 300 Multiple Choices 301 Moved Permanently 302 Found 303 See Other 304 Not Modified 307 Temporary Redirect 308 Permanent Redirect 400 Bad Request 401 Unauthorized 403 Forbidden 404 Not Found 405 Method Not Allowed 406 Not Acceptable 407 Proxy Authentication Required 408 Request Timeout 409 Conflict 410 Gone 411 Length Required 412 Precondition Failed 413 Payload Too Large 414 URI Too Long 415 Unsupported Media Type 416 Range Not Satisfiable 417 Expectation Failed 426 Upgrade Required 428 Precondition Required 429 Too Many Requests 431 Request Header Fields Too Large 451 Unavailable For Legal Reasons 500 Internal Server Error 501 Not Implemented 502 Bad Gateway 503 Service Unavailable 504 Gateway Timeout 505 HTTP Version Not Supported 511 Network Authentication Required Status

characters

HTTP Content-Security-Policy（CSP）指令为frame-src使用元素（如<frame>和<iframe>）加载的嵌套浏览上下文指定有效来源。

CSP版本	1
指令类型	Fetch指令
倒退	如果此指令不存在，用户代理将查找child-src指令（该指令回退到default-src指令）。

句法

frame-src政策可以允许一个或多个来源：

Content-Security-Policy: frame-src <source>;Content-Security-Policy: frame-src <source> <source>;

来源

<source>可以是以下之一：

<host-source> 通过名称或IP地址的Internet主机，以及可选的URL方案 and/or 端口号。该站点的地址可能包含一个可选的前导通配符（星号字符'*'），并且可以使用通配符（再次'*'）作为端口号，表示所有合法端口对于源都有效。

示例：

http://*.example.com：匹配使用http:URL方案从example.com的任何子域加载的所有尝试。

mail.example.com:443：匹配所有尝试访问mail.example.com上的端口443的尝试。

https://store.example.com：匹配所有尝试访问store.example.com使用https:。

<scheme-source>一种模式，如'http：'或'https：'。冒号是必需的，不应使用单引号。您也可以指定数据模式（不推荐）。

data:允许将data:URI用作内容源。这是不安全的；攻击者也可以注入任意数据：URI。谨慎使用这一点，绝对不适用于脚本。

mediastream:允许将mediastream:URI用作内容源。

blob:允许将blob:URI用作内容源。

filesystem:允许将filesystem:URI用作内容源。

'self'指受保护文档的来源，包括相同的URL方案和端口号。你必须包括单引号。一些浏览器特别排除blob和filesystem从源指令。需要允许这些内容类型的网站可以使用Data属性来指定它们。

'unsafe-inline'允许使用内联资源，如内联<script>元素，javascript:URL，内联事件处理程序和内联<style>元素。你必须包括单引号。

'unsafe-eval'允许使用eval()和类似的方法从字符串创建代码。你必须包括单引号。'none'指空集；也就是说，没有URL匹配。单引号是必需的。'nonce- <base64-value>'使用加密随机数（使用一次的数字）的特定内联脚本的白名单。每次发送策略时，服务器都必须生成唯一的随机数值。提供一个无法猜测的随机数是非常重要的，因为绕过资源的策略是微不足道的。例如，查看不安全的内联脚本。

<hash-source>内联脚本或样式的sha256，sha384或sha512。生成散列时，不要包含<script>或<style>标记，并注意大小写和空白字符，包括前导或尾随空格。请参阅不安全的内联脚本。

“strict-dynamic”strict-dynamic源表达式指定显式给予标记中存在的脚本的信任，通过附加一个随机数或散列值，应该传播给由该脚本加载的所有脚本。与此同时，任何白名单或源表达式（例如'self'或'unsafe-inline'将被忽略）。有关示例，请参阅script-src。

示例

违规示例

鉴于此CSP标题：

Content-Security-Policy: frame-src https://example.com/

以下<frame>内容已被阻止，无法加载：

<iframe src="https://not-example.com/"></iframe>

规格

规范	状态	评论
内容安全策略级别3该规范中'frame-src'的定义。	编辑草稿	取消不推荐使用frame-src。
内容安全策略级别2该规范中'frame-src'的定义。	建议	弃用frame-src。

浏览器兼容性

特征	Chrome	Firefox	Edge	Internet Explorer	Opera	Safari
基本支持	25	23.0	14	(No)	15	7

特征	Android	Chrome for Android	Edge mobile	Firefox for Android	IE mobile	Opera Android	iOS Safari
基本支持	4.4	(Yes)	?	23.0	(No)	?	7.1

Previous article： Next article：