跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

会话标识符

最后更新 查看 MarkdownAgent 设置

配置会话标识符以按用户跟踪经过身份验证的 API 流量。

虽然不是严格要求,但建议您在开始使用 API Shield 时配置您的 会话标识符。当 Cloudflare 检查您的 API 流量以识别单个会话时,我们可以提供更多用于可见性、管理和控制的工具。

如果您不确定您的 API 使用哪些会话标识符,请咨询您的开发团队。

会话标识符应能唯一标识 API 客户端。API 流量常用的会话标识符是 Authorization 标头。当 API 使用 JSON Web Token(JWT)进行客户端身份验证时,其值可能随时间变化。你可以使用 JWT 中的 sub 或 email 等声明值作为会话标识符,在不同时间唯一标识会话。

如果未配置会话标识符,且超过 1% 的符合条件的采样客户端 2xx 响应请求包含 Authorization 标头,Cloudflare 会自动将此标头配置为 API Shield 会话标识符。Cloudflare 不会覆盖现有会话标识符配置。

设置会话标识符

最多可以配置 10 个会话标识符。

  1. 在 Cloudflare 仪表板中,转到 Security Settings(安全设置) 页面。

    前往 Settings(设置) ↗
  2. 按 API abuse 进行筛选。

  3. 在 Session identifiers(会话标识符) 上,选择 Configure session identifiers(配置会话标识符)。

  4. 选择 Manage identifiers(管理标识符)。

  5. 选择会话标识符的类型(cookie、HTTP 标头或 JWT 声明)。

  6. 输入会话标识符的名称。

  7. 选择 Save(保存)。

API Shield 为符合条件且已保存的操作生成速率限制建议。建议要求具有 API Shield 访问权限、已配置与操作流量匹配的会话标识符、足够的数据以及已完成的处理。满足这些要求后,你可以查看每个操作和每个会话的建议,并创建速率限制规则。

Discovery 在识别 API 流量时,可以将配置的会话标识符用作一个信号。会话标识符还支持 Sequence Analytics 中的会话流量分析。

这篇文档对您有帮助吗?