大网数据广告活动
Web 标准与前端开发

Access-Control-Allow-Credentials

· 52CE 我爱测

**`Access-Control-Allow-Credentials`** 响应标头告诉浏览器服务器是否允许 HTTP 跨源请求携带凭据。

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。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。