配置会话标识符以按用户跟踪经过身份验证的 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 个会话标识符。
-
在 Cloudflare 仪表板中,转到 Security Settings(安全设置) 页面。
前往 Settings(设置) ↗ -
按 API abuse 进行筛选。
-
在 Session identifiers(会话标识符) 上,选择 Configure session identifiers(配置会话标识符)。
-
选择 Manage identifiers(管理标识符)。
-
选择会话标识符的类型(cookie、HTTP 标头或 JWT 声明)。
-
输入会话标识符的名称。
-
选择 Save(保存)。
API Shield 为符合条件且已保存的操作生成速率限制建议。建议要求具有 API Shield 访问权限、已配置与操作流量匹配的会话标识符、足够的数据以及已完成的处理。满足这些要求后,你可以查看每个操作和每个会话的建议,并创建速率限制规则。
Discovery 在识别 API 流量时,可以将配置的会话标识符用作一个信号。会话标识符还支持 Sequence Analytics 中的会话流量分析。