Access-Control-Allow-Credentials 响应标头告诉浏览器服务器是否允许 HTTP 跨源请求携带凭据。
凭据包括 cookie、TLS 客户端证书,或包含用户名和密码的认证标头。默认情况下,这些凭据不会在跨源请求中发送,因为这样做可能会使站点容易受到CSRF攻击。
客户端可以通过以下两种方式之一在跨站请求中包含凭据:
- 使用 fetch() 时,通过将 Request.Request() 构造函数中的
credentials选项设置为"include"。 - 使用 XMLHttpRequest 时,通过将 XMLHttpRequest.withCredentials 属性设置为
true。
如果客户端已请求时包含凭据:
- 如果请求是Preflight_request,那么在预检请求时不会包含凭据。如果服务器对预检请求的响应将
Access-Control-Allow-Credentials标头设置为true,则实际请求时将包含凭据;否则,浏览器将报告网络错误。 - 如果请求时未经过预检,则请求将包含凭据;如果服务器的响应没有将
Access-Control-Allow-Credentials标头设置为true,浏览器将报告网络错误。
<table class="properties"> <tbody> <tr> <th scope="row">标头类型</th> <td>Response header</td> </tr> <tr> <th scope="row">Forbidden header name</th> <td>否</td> </tr> </tbody> </table>
语法
Access-Control-Allow-Credentials: true
指令
true- : 此标头的有效值仅为
true(区分大小写)。如果你不需要此凭据,请完全省略此标头(而不是将其值设置为false)。
- : 此标头的有效值仅为
示例
允许凭据:
Access-Control-Allow-Credentials: true
使用 fetch() 并携带凭据:
fetch(url, {
credentials: "include",
});
使用 XMLHttpRequest 并携带凭据:
const xhr = new XMLHttpRequest();
xhr.open("GET", "http://example.com/", true);
xhr.withCredentials = true;
xhr.send(null);
规范
浏览器兼容性
参见
- XMLHttpRequest.withCredentials
- Request.Request()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
