当前位置：文江博客知识库简体中文文档 Web HTTP Headers Content-Security-Policy default-src

CSP: default-src - HTTP 编辑

在 HTTP 协议中，Content-Security-Policy (CSP) 首部字段中的 default-src 指令可以为其他 CSP 拉取指令（fetch directives）提供备选项。对于以下列出的指令，假如不存在的话，那么用户代理会查找并应用 default-src 指令的值。

CSP 版本	1
指令类型	Fetch directive

语法

default-src 策略允许指定一个或多个源：

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

源

<source> 可以是以下之一：

<host-source>

以域名或者 IP 地址表示的主机名，外加可选的 URL 协议名（URL scheme）以及端口号。站点地址中可能会包含一个可选的前置通配符（星号 '*'），同时也可以将通配符（也是'*'）应用于端口号，表示在这个源中可以使用任意合法的端口号。
举例说明：

http://*.example.com: 匹配从使用 http: 的 example.com 的任意子域的资源加载。
mail.example.com:443:匹配对 mail.example.com 上的 443 端口号的访问。
https://store.example.com: 匹配对使用了 https: 的 store.example.com 的访问。

<scheme-source>

协议名如'http:' 或者 'https:'。必须带有冒号，不要有单引号。同时你还可以指定数据协议（data schema）（不推荐使用）。

data: 允许 data: URIs 作为内容的源。这是不安全的。攻击者可以注入任意 data: URI 。不要轻易使用这种形式的源，尤其是脚本，绝对不要使用。
mediastream: 允许 mediastream: URIs 作为内容的源。
blob: 允许 blob: URIs 作为内容的源。
filesystem: 允许 filesystem: URIs 作为内容的源。

'self'

指向与要保护的文件所在的源，包括相同的 URL scheme 与端口号。必须有单引号。一些浏览器会特意排除 blob 与 filesystem 。需要设定这两种内容类型的站点可以在 Data 属性中进行设定。

'unsafe-inline'

允许使用内联资源，例如内联 <script> 元素（javascript: URL）、内联事件处理器以及内联 <style> 元素。必须有单引号。

'unsafe-eval'

允许使用 eval() 以及相似的函数来从字符串创建代码。必须有单引号。

'none'

不允许任何内容。必须有单引号。

'nonce-<base64值>'

特定使用一次性加密内联脚本的白名单。服务器必须在每一次传输政策时生成唯一的一次性值。否则将存在绕过资源政策的可能。请参见不安全的内联脚本查看示例。

<hash-source>

使用 sha256、sha384 或 sha512 编码过的内联脚本或样式。其由用短划线分隔的两部分组成: 用于创建哈希的加密算法, 以及脚本或样式base64编码的哈希值。当生成哈希值的时候，不要包含 <script> 或 <style> 标签，同时注意字母大小写与空格——包括首尾空格——都是会影响生成的结果的。请参见不安全的内联脚本。

'strict-dynamic'

strict-dynamic 指定对于含有标记脚本(通过附加一个随机数或散列)的信任，应该传播到由该脚本加载的所有脚本。与此同时，任何白名单以及源表达式例如 'self' 或者 'unsafe-inline' 都会被忽略。参见 script-src 。

示例

不继承 default-src 的情况

假如设定了其他指令，那么 default-src 不会对它们起作用。这个首部

Content-Security-Policy: default-src 'self'; script-src https://example.com

与下列代码等价：

Content-Security-Policy: connect-src 'self';
                         font-src 'self';
                         frame-src 'self';
                         img-src 'self';
                         manifest-src 'self';
                         media-src 'self';
                         object-src 'self';
                         script-src https://example.com;
                         style-src 'self';
                         worker-src 'self'

规范

规范	状态	注释
Content Security Policy Level 3 default-src	Working Draft	Added `frame-src`, `manifest-src` and `worker-src` as defaults.
Content Security Policy Level 2 default-src	Recommendation	Initial definition.