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

字段参考

查看 MarkdownAgent 设置
cf.api_gateway.auth_id_present

指示请求是否包含 API 会话身份验证令牌,该令牌由 API Shield 保存的会话标识符定义。

  • Enterprise add-on
cf.api_gateway.fallthrough_detected

指示请求是否与端点管理中已保存的端点匹配。

cf.api_gateway.request_violates_schema

指示请求是否违反了分配给相应已保存端点的架构。

cf.bot_management.corporate_proxy

指示传入请求是否来自已识别的、仅限 Enterprise 的基于云的企业代理或安全 Web 网关。

  • Enterprise add-on
cf.bot_management.detection_ids

与对请求所做的 Bot Management 启发式检测相关联的 ID 列表。

  • Enterprise add-on
cf.bot_management.ja3_hash

提供 SSL/TLS 指纹,帮助您识别潜在的机器人请求。

  • Enterprise add-on
cf.bot_management.ja4

提供 SSL/TLS 指纹,帮助您识别潜在的机器人请求。

  • Enterprise add-on
cf.bot_management.js_detection.passed

指示访问者之前是否已通过 JS 检测。

  • Enterprise add-on
cf.bot_management.score

使用 1–99 的评分表示请求来自机器人的可能性。

  • Enterprise add-on
cf.bot_management.signed_agent

指示请求是否来自使用 Web Bot Auth 进行自我标识的已知智能体,此类智能体现已被归类为标记为中介的已验证机器人或智能体。

  • Enterprise add-on
cf.bot_management.static_resource

指示在使用 cf.bot_management.score 创建规则时是否应包含静态资源。

  • Enterprise add-on
cf.bot_management.verified_bot

指示请求是否来自已知的良性机器人或爬虫。

  • Enterprise add-on
cf.client.bot

指示请求是否来自已知的良性机器人或爬虫。

cf.edge.client_tcp

指示请求是否通过 TCP 发出。

cf.edge.l4.delivery_rate

客户端连接的最新数据传输速率估算值,以字节/秒为单位。

cf.edge.server_ip

表示 HTTP 请求所解析到的全球网络 IP 地址。

cf.edge.server_port

表示 Cloudflare 全球网络接收请求时所使用的端口号。

cf.hostname.metadata

返回由 SSL for SaaS 客户设置的按主机名自定义元数据 JSON 对象的字符串表示形式。

cf.llm.prompt.custom_topic_categories

请求中 LLM 提示词的自定义主题标签到相关性评分(1–99)的映射。

  • Enterprise
cf.llm.prompt.detected

指示 Cloudflare 是否在传入请求中检测到 LLM 提示词。

  • Enterprise
cf.llm.prompt.injection_score

1–99 的评分,表示请求中的 LLM 提示词试图执行提示词注入攻击的可能性。

  • Enterprise
cf.llm.prompt.pii_categories

字符串值数组,包含在请求所包含的 LLM 提示词中发现的个人身份信息(PII)类别。

  • Enterprise
cf.llm.prompt.pii_detected

指示在请求所包含的 LLM 提示词中是否检测到任何个人身份信息(PII)。

  • Enterprise
cf.llm.prompt.token_count

请求中 LLM 提示词的估算令牌数。

  • Enterprise
cf.llm.prompt.unsafe_topic_categories

字符串值数组,包含在 LLM 提示词中检测到的不安全主题类型。

  • Enterprise
cf.llm.prompt.unsafe_topic_detected

指示传入请求的 LLM 提示词中是否包含任何不安全的主题类别。

  • Enterprise
cf.random_seed

返回每个请求的随机字节,可用于 uuidv4() 函数。

cf.ray_id

当前请求的 Ray ID。

cf.response.1xxx_code

包含 1XXX Cloudflare 错误的具体代码。

cf.response.error_type

一个字符串,表示所返回响应中的错误类型。

cf.threat_score

表示 Cloudflare 威胁评分。

cf.timings.client_quic_rtt_msec

Cloudflare 与客户端之间经过平滑处理的 QUIC 往返时间(RTT),以毫秒为单位。

cf.timings.client_tcp_rtt_msec

Cloudflare 与客户端之间经过平滑处理的 TCP 往返时间(RTT),以毫秒为单位。

cf.timings.edge_msec

在 Cloudflare 全球网络内处理请求所花费的时间,以毫秒为单位。

cf.timings.origin_ttfb_msec

Cloudflare 全球网络与源服务器之间的往返时间(RTT),以毫秒为单位。

cf.timings.worker_msec

执行 Cloudflare Worker 所花费的时间,以毫秒为单位。

cf.tls_cipher

与 Cloudflare 建立连接所使用的密码。

cf.tls_ciphers_sha1

按接收顺序排列的客户端 TLS 密码列表的 SHA-1 指纹,使用大端格式以 Base64 编码。

cf.tls_client_auth.cert_chain_rfc9440

按照 RFC 9440 编码为结构化字段列表的 mTLS 客户端证书链(不包括叶证书)。

cf.tls_client_auth.cert_chain_rfc9440_too_large

当按 RFC 9440 编码的客户端证书链超过 16 KiB 的大小限制时,返回 true。

cf.tls_client_auth.cert_fingerprint_sha1

mTLS 客户端证书的 SHA-1 指纹。

cf.tls_client_auth.cert_fingerprint_sha256

mTLS 客户端证书的 SHA-256 指纹。

cf.tls_client_auth.cert_issuer_dn

颁发 mTLS 客户端证书的证书颁发机构(CA)的可分辨名称(DN)。

cf.tls_client_auth.cert_issuer_dn_legacy

颁发 mTLS 客户端证书的证书颁发机构(CA)的可分辨名称(DN),采用旧版格式。

cf.tls_client_auth.cert_issuer_dn_rfc2253

颁发 mTLS 客户端证书的证书颁发机构(CA)的可分辨名称(DN),采用 RFC 2253 格式。

cf.tls_client_auth.cert_issuer_serial

mTLS 客户端证书直接颁发者的序列号。

cf.tls_client_auth.cert_issuer_ski

mTLS 客户端证书直接颁发者的使用者密钥标识符(SKI)。

cf.tls_client_auth.cert_not_after

mTLS 客户端证书在此日期之后无效。

cf.tls_client_auth.cert_not_before

mTLS 客户端证书在此日期之前无效。

cf.tls_client_auth.cert_presented

当 mTLS 客户端出示证书(无论是否有效)时,返回 true。

cf.tls_client_auth.cert_revoked

指示 mTLS 客户端是否出示了有效但已被吊销的客户端证书。

cf.tls_client_auth.cert_rfc9440

按照 RFC 9440 编码为结构化字段字节序列的 mTLS 客户端证书。

cf.tls_client_auth.cert_rfc9440_too_large

当按 RFC 9440 编码的 mTLS 客户端证书超过 10 KiB 的大小限制时,返回 true。

cf.tls_client_auth.cert_serial

mTLS 客户端证书的序列号。

cf.tls_client_auth.cert_ski

mTLS 客户端证书的使用者密钥标识符(SKI)。

cf.tls_client_auth.cert_subject_dn

mTLS 客户端证书所有者(或申请者)的可分辨名称(DN)。

cf.tls_client_auth.cert_subject_dn_legacy

mTLS 客户端证书所有者(或申请者)的可分辨名称(DN),采用旧版格式。

cf.tls_client_auth.cert_subject_dn_rfc2253

mTLS 客户端证书所有者(或申请者)的可分辨名称(DN),采用 RFC 2253 格式。

cf.tls_client_auth.cert_verified

当 mTLS 客户端出示有效的客户端证书时,返回 true。

cf.tls_client_extensions_sha1

TLS 客户端扩展的 SHA-1 指纹,使用大端格式以 Base64 编码。

cf.tls_client_extensions_sha1_le

TLS 客户端扩展的 SHA-1 指纹,使用小端格式以 Base64 编码。

cf.tls_client_hello_length

在 TLS 握手中发送的 Client Hello 消息的长度。

cf.tls_client_random

客户端在 TLS 握手中提供的 32 字节随机值,以 Base64 编码。

cf.tls_version

与 Cloudflare 建立连接所使用的 TLS 版本。

cf.verified_bot_category

提供已验证机器人的类型和用途。

cf.waf.auth_detected

指示 Cloudflare WAF 是否在请求中检测到身份验证凭据。

  • Enterprise
cf.waf.content_scan.has_failed

指示文件扫描器是否无法扫描请求中检测到的任何内容对象。

  • Enterprise add-on
cf.waf.content_scan.has_malicious_obj

指示请求是否包含至少一个恶意内容对象。

  • Enterprise add-on
cf.waf.content_scan.has_obj

指示请求是否包含至少一个内容对象。

  • Enterprise add-on
cf.waf.content_scan.num_malicious_obj

在请求中检测到的恶意内容对象的数量(零或更多)。

  • Enterprise add-on
cf.waf.content_scan.num_obj

在请求中检测到的内容对象的数量(零或更多)。

  • Enterprise add-on
cf.waf.content_scan.obj_results

扫描结果的数组,按请求中检测到内容对象的顺序排列。

  • Enterprise add-on
cf.waf.content_scan.obj_sizes

文件大小(以字节为单位)的数组,按请求中检测到内容对象的顺序排列。

  • Enterprise add-on
cf.waf.content_scan.obj_types

文件类型的数组,按请求中检测到内容对象的顺序排列。

  • Enterprise add-on
cf.waf.credential_check.password_leaked

指示请求中检测到的密码之前是否已泄露。

cf.waf.credential_check.username_and_password_leaked

指示请求中检测到的身份验证凭据(用户名-密码对)之前是否已泄露。

  • Pro or above
cf.waf.credential_check.username_leaked

指示请求中检测到的用户名之前是否已泄露。

  • Enterprise
cf.waf.credential_check.username_password_similar

指示请求中检测到的用户名和密码凭据的相似版本之前是否已泄露。

  • Enterprise
cf.waf.score

1–99 的全局评分,将每个 WAF 攻击向量的评分合并为单一评分。

  • Enterprise
cf.waf.score.class

基于 WAF 攻击评分得出的当前请求的攻击评分类别。

  • Business or above
cf.waf.score.rce

对命令注入或远程代码执行(RCE)攻击向量进行分类的 1–99 攻击评分。

  • Enterprise
cf.waf.score.sqli

对 SQL 注入(SQLi)攻击向量进行分类的 1–99 攻击评分。

  • Enterprise
cf.waf.score.xss

对跨站脚本(XSS)攻击向量进行分类的 1–99 攻击评分。

  • Enterprise
cf.worker.upstream_zone

标识请求是否来自 Worker。

http.cookie

以字符串形式表示的完整 Cookie。

http.host

完整请求 URI 中使用的主机名。

http.referer

HTTP Referer 请求标头,其中包含链接到当前请求页面的网页地址。

http.request.accepted_languages

Accept-Language HTTP 请求标头中提供的语言标签列表。

http.request.body.form

表单的 HTTP 请求正文,以 Map(或关联数组)形式表示。

  • Enterprise
http.request.body.form.names

HTTP 请求中表单字段的名称。

  • Enterprise
http.request.body.form.values

HTTP 请求中表单字段的值。

  • Enterprise
http.request.body.mime

根据请求正文检测到的请求 MIME 类型。

http.request.body.multipart

请求正文中 multipart 名称到 multipart 值的 Map(或关联数组)表示形式。

  • Enterprise
http.request.body.multipart.content_dispositions

multipart 正文中每个部分的 Content-Disposition 标头列表。

  • Enterprise
http.request.body.multipart.content_transfer_encodings

multipart 正文中每个部分的 Content-Transfer-Encoding 标头列表。

  • Enterprise
http.request.body.multipart.content_types

multipart 正文中每个部分的 Content-Type 标头列表。

  • Enterprise
http.request.body.multipart.filenames

multipart 正文中每个部分的文件名列表。

  • Enterprise
http.request.body.multipart.names

multipart 正文中每个部分的 multipart 名称列表。

  • Enterprise
http.request.body.multipart.values

multipart 正文中每个部分的 multipart 值列表。

  • Enterprise
http.request.body.raw

未经修改的 HTTP 请求正文。

  • Enterprise
http.request.body.size

HTTP 请求正文的总大小(以字节为单位)。

  • Enterprise
http.request.body.truncated

指示 HTTP 请求正文是否被截断。

  • Enterprise
http.request.cookies

与请求关联的 Cookie HTTP 标头,以 Map(关联数组)形式表示。

  • Pro or above
http.request.full_uri

Web 服务器接收到的完整 URI。

http.request.headers

HTTP 请求标头,以 Map(或关联数组)形式表示。

http.request.headers.names

HTTP 请求中标头的名称。

http.request.headers.truncated

指示 HTTP 请求是否包含过多标头。

http.request.headers.values

HTTP 请求中标头的值。

http.request.jwt.claims.aud

aud(受众)声明标识 JSON Web 令牌(JWT)的预期接收方。

  • Enterprise add-on
http.request.jwt.claims.aud.names

aud(受众)声明标识 JSON Web 令牌(JWT)的预期接收方。

  • Enterprise add-on
http.request.jwt.claims.aud.values

aud(受众)声明标识 JSON Web 令牌(JWT)的预期接收方。

  • Enterprise add-on
http.request.jwt.claims.iat.sec

iat(签发时间)声明标识 JWT 的签发时间(秒数)。

  • Enterprise add-on
http.request.jwt.claims.iat.sec.names

iat(签发时间)声明标识 JWT 的签发时间(秒数)。

  • Enterprise add-on
http.request.jwt.claims.iat.sec.values

iat(签发时间)声明标识 JWT 的签发时间(秒数)。

  • Enterprise add-on
http.request.jwt.claims.iss

iss(签发者)声明标识签发 JWT 的主体。

  • Enterprise add-on
http.request.jwt.claims.iss.names

iss(签发者)声明标识签发 JWT 的主体。

  • Enterprise add-on
http.request.jwt.claims.iss.values

iss(签发者)声明标识签发 JWT 的主体。

  • Enterprise add-on
http.request.jwt.claims.jti

jti(JWT ID)声明为 JWT 提供唯一标识符。

  • Enterprise add-on
http.request.jwt.claims.jti.names

jti(JWT ID)声明为 JWT 提供唯一标识符。

  • Enterprise add-on
http.request.jwt.claims.jti.values

jti(JWT ID)声明为 JWT 提供唯一标识符。

  • Enterprise add-on
http.request.jwt.claims.nbf.sec

nbf(生效时间)声明标识一个时间(秒数),在此时间之前不得接受该 JWT 进行处理。

  • Enterprise add-on
http.request.jwt.claims.nbf.sec.names

nbf(生效时间)声明标识一个时间(秒数),在此时间之前不得接受该 JWT 进行处理。

  • Enterprise add-on
http.request.jwt.claims.nbf.sec.values

nbf(生效时间)声明标识一个时间(秒数),在此时间之前不得接受该 JWT 进行处理。

  • Enterprise add-on
http.request.jwt.claims.sub

sub(主题)声明标识作为 JWT 主题的主体。

  • Enterprise add-on
http.request.jwt.claims.sub.names

sub(主题)声明标识作为 JWT 主题的主体。

  • Enterprise add-on
http.request.jwt.claims.sub.values

sub(主题)声明标识作为 JWT 主题的主体。

  • Enterprise add-on
http.request.method

HTTP 方法,以大写字符组成的字符串形式返回。

http.request.timestamp.msec

Cloudflare 接收请求时的毫秒数,介于 0–999 之间。

http.request.timestamp.sec

Cloudflare 接收请求时的时间戳,以秒为单位的 UNIX 时间表示。

http.request.uri

请求的 URI 路径和查询字符串。

http.request.uri.args

与请求关联的 HTTP URI 参数,以 Map(关联数组)形式表示。

http.request.uri.args.names

HTTP URI 查询字符串中参数的名称。

http.request.uri.args.values

HTTP URI 查询字符串中参数的值。

http.request.uri.path

请求的 URI 路径。

http.request.uri.path.extension

URI 路径中小写的文件扩展名,不含点(.)字符。

http.request.uri.query

完整的查询字符串,不含 ? 分隔符。

http.request.version

所使用的 HTTP 协议版本。当需要针对不同版本进行不同检查时,请使用此字段。

http.response.code

返回给客户端的 HTTP 状态码,可能由 Cloudflare 产品设置,也可能由源服务器返回。

http.response.content_type.media_type

基于响应 Content-Type 标头得出的小写内容类型(包括子类型和后缀),不含任何额外参数。

http.response.headers

HTTP 响应标头,以 Map(或关联数组)形式表示。

http.response.headers.names

HTTP 响应中标头的名称。

http.response.headers.values

HTTP 响应中标头的值。

http.user_agent

HTTP User-Agent 请求标头,其中包含用于识别客户端操作系统和 Web 浏览器的特征字符串。

http.x_forwarded_for

X-Forwarded-For HTTP 标头的完整值。

ip.src

客户端 TCP IP 地址,可能会使用 X-Forwarded-For 或 X-Real-IP 等 HTTP 标头进行调整,以反映客户端的实际地址。

ip.src.asnum

表示与客户端 IP 地址关联的自治系统(AS)编号的 16 位或 32 位整数。

ip.src.city

与客户端 IP 地址关联的城市。

ip.src.continent

与客户端 IP 地址关联的大洲代码。

ip.src.country

ISO 3166-1 Alpha 2 格式的 2 字母国家/地区代码。

ip.src.is_in_european_union

请求是否来自欧盟(EU)国家/地区。

  • Business or above
ip.src.lat

与客户端 IP 地址关联的纬度。

ip.src.lon

与客户端 IP 地址关联的经度。

ip.src.metro_code

与传入请求关联的都市区代码或指定市场区域(DMA)代码。

ip.src.postal_code

与传入请求关联的邮政编码。

ip.src.region

与传入请求关联的地区名称。

ip.src.region_code

与传入请求关联的地区代码。

ip.src.subdivision_1_iso_code

与该 IP 地址关联的一级地区的 ISO 3166-2 代码。

  • Business or above
ip.src.subdivision_2_iso_code

与该 IP 地址关联的二级地区的 ISO 3166-2 代码。

  • Business or above
ip.src.timezone.name

与传入请求关联的时区名称。

raw.http.request.full_uri

Web 服务器接收到的未经任何转换的原始完整 URI。

raw.http.request.uri

未经任何转换的请求 URI 路径和查询字符串。

raw.http.request.uri.args

与请求关联的原始 HTTP URI 参数,以 Map(关联数组)形式表示。

raw.http.request.uri.args.names

HTTP URI 查询字符串中参数的原始名称。

raw.http.request.uri.args.values

HTTP URI 查询字符串中参数的原始值。

raw.http.request.uri.path

未经任何转换的请求原始 URI 路径。

raw.http.request.uri.path.extension

请求 URI 路径中未经任何转换的原始文件扩展名。

raw.http.request.uri.query

完整的查询字符串,不含 ? 分隔符,且未经任何转换。

raw.http.response.headers

未经任何转换的 HTTP 响应标头,以 Map(或关联数组)形式表示。

raw.http.response.headers.names

HTTP 响应中未经任何转换的标头名称。

raw.http.response.headers.values

HTTP 响应中未经任何转换的标头值。

ssl

当与客户端之间的 HTTP 连接经过加密时,返回 true。

这篇文档对您有帮助吗?