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

通过 API 配置 JWT 验证

最后更新 查看 MarkdownAgent 设置

使用 Cloudflare API 配置 JWT 验证。令牌配置定义 Cloudflare 如何查找和验证 JWT。然后您可以使用 WAF 自定义规则或令牌验证规则来根据结果采取操作。

令牌配置

令牌配置定义用于验证 JSON Web 令牌 (JWT) 的 JSON Web 密钥集 (JWKS)。它还定义 Cloudflare 在请求中查找 JWT 的位置。

令牌配置需要以下信息:

字段名称
描述 示例 备注
title 配置的人类可读名称,允许您快速识别配置的目的。 Production JWT configuration 限制为 50 个字符。
description 比 title 给出更多细节的人类可读描述,用作允许客户更好记录配置用途的手段。 This configuration checks the JWT in the authorization header. 限制为 500 个字符。
token_sources 请求中可能包含 JWT 的位置列表。 http.request.headers[\"authorization\"][0]
http.request.cookies[\"Authorization\"][0]
请参阅下面的信息。
token_type 指定要验证的令牌类型。 jwt 目前仅支持 jwt。
credentials 描述应该用于验证 JWT 的加密密钥。每个密钥必须是 JSON Web 密钥 (JWK)。 请参阅下面的示例。 请参阅下面的信息。

令牌来源

每一项都必须是解析为字符串的规则集引擎 (Ruleset Engine) 表达式。

目前支持的字段是 http.request.headers 和 http.request.cookies。

您最多可以设置四个令牌来源。这些来源使用 OR 逻辑:来自任一来源的有效令牌即足够。这支持使用不同令牌位置的客户端,包括在迁移期间。如果请求在多个已配置来源中包含值,Cloudflare 会逐个评估并在找到第一个有效令牌后停止。Cloudflare 不会合并令牌值,也不要求多个来源都有效。

来源可以包含无前缀的 JWT。它也可以使用精确的 Bearer 前缀,其中 B 为大写、没有冒号,并且 Bearer 后面有一个空格。

有关使用规则集引擎字段的详细信息,请参阅规则集引擎文档。

凭据

API Shield 支持非对称 RSA 和椭圆曲线密钥,以及基于哈希的消息身份验证码 (HMAC) 对称密钥:

密钥类型 支持的算法 要求
RSA RS256、RS384、RS512、PS256、PS384 和 PS512 RSA 密钥必须为 2,048、3,072 或 4,096 位。
EC ES256 和 ES384 ES256 使用曲线 P-256,ES384 使用曲线 P-384。
HMAC HS256、HS384 和 HS512 分别使用至少 32、48 或 64 字节的对称密钥。

为每个 JWK 提供 alg 值。每个 JWK 还必须有 kid。有效算法和密钥 ID 必须与 JWT 标头中的 alg 和 kid 值匹配。

为了兼容省略 alg 的身份提供程序,API Shield 会将 RSA 密钥默认为 RS256,将 P-256 EC 密钥默认为 ES256,将 P-384 EC 密钥默认为 ES384。由于 RSA 密钥无法标识其签名算法,如果身份提供程序使用其他受支持的 RSA 算法,请显式指定 alg。HMAC 密钥必须始终指定 alg。

对于 HMAC 密钥,将 kty 设置为 oct。将 k 设置为使用未填充 Base64url 编码的原始对称凭据。解码后的凭据必须满足其算法的最小长度。

Cloudflare 将从每个密钥中删除任何不必要的字段,并将放弃我们不支持的密钥。

强烈建议验证 API 调用的输出,以检查结果密钥是否符合预期。

令牌配置 JSON 对象

下面的示例展示了一个 JSON 对象,其中包含使用 Cloudflare API 创建令牌配置所需的所有信息。如果您想创建用于测试的 JWKs,请参阅 mkjwk JSON Web Key Generator ↗。

示例json
{
	"title": "Production JWT configuration",
	"description": "This configuration checks the JWT in the authorization header or cookie.",
	"token_sources": [
		"http.request.headers[\"authorization\"][0]",
		"http.request.cookies[\"Authorization\"][0]"
	],
	"token_type": "jwt",
	"credentials": {
		"keys": [
			{
				"kty": "EC",
				"use": "sig",
				"crv": "P-256",
				"kid": "93UrzmNu1mqXs5cZcvCPkTlMHB2Jya30vSTkiBb0vhU",
				"x": "QG3VFVwUX4IatQvBy7sqBvvmticCZ-eX5-nbtGKBOfI",
				"y": "A3PXCshn7XcG7Ivvd2K_DerW4LHAlIVKdqhrUnczTD0",
				"alg": "ES256"
			}
		]
	}
}

对称密钥示例

以下示例使用 HS256 对称密钥配置 JWT 验证。将 <BASE64URL_ENCODED_SECRET> 替换为未填充 Base64url 编码、解码后至少包含 32 字节的凭据。

HS256 token configurationjson
{
	"title": "Production HMAC JWT configuration",
	"description": "This configuration checks the JWT in the authorization header.",
	"token_sources": ["http.request.headers[\"authorization\"][0]"],
	"token_type": "jwt",
	"credentials": {
		"keys": [
			{
				"kty": "oct",
				"alg": "HS256",
				"kid": "production-hmac-key",
				"k": "<BASE64URL_ENCODED_SECRET>"
			}
		]
	}
}

响应包含 kty、alg 和 kid,但不包含 k:

Symmetric key responsejson
{
	"credentials": {
		"keys": [
			{
				"kty": "oct",
				"alg": "HS256",
				"kid": "production-hmac-key"
			}
		]
	}
}

使用 Cloudflare API 创建令牌配置

使用 cURL 或任何其他 API 客户端工具将新配置发送到 Cloudflare 的 API 以启用 JWT 验证。确保将 {zone_id} 替换为相关的 zone ID,并添加您的身份验证凭据标头。

使用 cURL 的示例bash
curl "https://api.cloudflare.com/client/v4/zones/{zone_id}/token_validation/config" \
--header 'Content-Type: application/json' \
--data '{
    "title": "Production JWT configuration",
    "description": "This configuration checks the JWT in the authorization header or cookie.",
    "token_sources": [
        "http.request.headers[\"authorization\"][0]",
        "http.request.cookies[\"Authorization\"][0]"
    ],
    "token_type": "jwt",
    "credentials": {
        "keys": [
            {
                "kty": "EC",
                "use": "sig",
                "crv": "P-256",
                "kid": "93UrzmNu1mqXs5cZcvCPkTlMHB2Jya30vSTkiBb0vhU",
                "x": "QG3VFVwUX4IatQvBy7sqBvvmticCZ-eX5-nbtGKBOfI",
                "y": "A3PXCshn7XcG7Ivvd2K_DerW4LHAlIVKdqhrUnczTD0",
                "alg": "ES256"
            }
        ]
    }
}'

响应将包含在 Cloudflare v4 响应信封中,其结果包含已创建的配置。请注意返回的 ID。您可以使用它在 JWT 声明字段或令牌验证规则中引用该令牌配置。

响应示例json
{
	"result": {
		"id": "d5902294-00c3-4aed-b517-57e752e9cd58",
		"token_type": "JWT",
		"title": "Production JWT configuration",
		"description": "This configuration checks the JWT in the authorization header or cookie.",
		"token_sources": [
			"http.request.headers[\"authorization\"][0]",
			"http.request.cookies[\"Authorization\"][0]"
		],
		"credentials": {
			"keys": [
				{
					"x": "QG3VFVwUX4IatQvBy7sqBvvmticCZ-eX5-nbtGKBOfI",
					"y": "A3PXCshn7XcG7Ivvd2K_DerW4LHAlIVKdqhrUnczTD0",
					"alg": "ES256",
					"crv": "P-256",
					"kid": "93UrzmNu1mqXs5cZcvCPkTlMHB2Jya30vSTkiBb0vhU",
					"kty": "EC"
				}
			]
		},
		"created_at": "2023-11-08T16:45:17.236841Z",
		"last_updated": "2023-11-08T16:45:17.236841Z"
	},
	"success": true,
	"errors": [],
	"messages": []
}

如果 API Shield 为省略的算法设置了默认值,响应会在 result 中包含有效算法。messages 数组还会为每个被默认的密钥包含一条消息:

被默认算法的消息示例json
{
	"code": 110003,
	"message": "keys[0].alg was omitted and defaulted to \"RS256\" (kid \"key-1\")"
}

同时检查 result 和 messages 以确认有效凭据。

根据验证结果采取操作

创建令牌配置后,Cloudflare 会检查该 zone 中每个请求在已配置令牌来源是否存在 JWT,并验证找到的任何令牌。验证不需要令牌验证规则或端点管理中的操作。规则决定 Cloudflare 如何对结果采取操作。

WAF 自定义规则支持覆盖整个 zone 的策略以及限定到所选端点的策略。它们还可以将 JWT 验证结果和已验证声明与其他安全信号(例如攻击评分)结合使用。等效的 WAF 自定义规则表达式请参阅 WAF 自定义规则示例。

要在规则表达式中引用自定义声明,您可以将 lookup_json_* 函数(例如 lookup_json_string())与令牌配置 ID 和声明名称一起使用。完整声明示例请参阅根据攻击评分为 JWT 声明中的管理员用户发出质询。所有可用字段和标准声明请参阅 JWT 验证字段参考。

令牌验证规则

令牌验证规则使用现有令牌配置和端点管理中的操作来强制执行安全策略。

令牌验证规则可以使用 Cloudflare API 或仪表板进行配置。

字段名称
描述 示例 备注
title 一个人类可读的名称,允许您快速识别它。 JWT validation on v1 and v2.example.com 限制为 50 个字符。
description 比 title 给出更多细节的人类可读描述,有助于记录它。 Log requests without a valid authorization header. 限制为 500 个字符。
action 对不符合 expression 的请求采取的防火墙操作。 log 可能的值:log 或 block
enabled 启用或禁用该规则。 true 可能的值:true 或 false
expression 规则的安全策略。 is_jwt_valid ("00170473-ec24-410e-968a-9905cf0a7d03") 使用 Cloudflare API 创建规则时,请确保对任何引号进行转义。
请参阅下面的定义安全策略。
selector 配置此规则涵盖哪些操作。 请参阅下面的将规则应用于操作。

选择器

选择器控制 Cloudflare 将令牌验证规则的操作应用于端点管理中的哪些操作。

如果您只需要在顶级域的特定主机名或子域上强制执行,请在选择器中使用该主机名,将匹配的操作包含在 JWT 验证规则中。

如果您需要将端点排除在强制执行之外,请在选择器中使用端点的操作 ID。例如,您可以排除签发或刷新 JWT 的端点。

要找到操作 ID,请参阅端点管理或使用 Cloudflare API。

定义安全策略

令牌验证规则的表达式定义了请求必须满足的安全策略。

例如,如果传入请求不包含至少一个有效的身份验证令牌,表达式 is_jwt_valid("51231d16-01f1-48e3-93f8-91c99e81288e") or is_jwt_valid("fddfc39e-3686-4683-ab23-bf917da6bb43") 将被触发。

这些表达式类似于规则集引擎中使用的表达式,但有一些关键区别:

  • 与规则集表达式相反,如果表达式的评估结果为 false,则会触发令牌验证规则操作。
  • 令牌验证规则可以使用引用令牌配置的专用函数。

运算符(如 or、and、eq 等)在表达式中的使用方式与规则集引擎中使用的表达式相同。

以下函数可用于与请求中的 JWT 令牌进行交互:

这些函数仅在令牌验证规则中可用。它们在 WAF 自定义规则中不可用。

常见用例

请参阅以下示例用例以了解要使用哪种安全策略。对于大多数用例,Cloudflare 建议在您的 API 中要求提供有效的令牌,并使用选择器排除任何用于建立或刷新令牌的路径。

要求提供令牌

如果请求缺少 JWT,表达式 is_jwt_present("51231d16-01f1-48e3-93f8-91c99e81288e") 将触发操作。

它可以与令牌验证规则中的 log 操作结合使用,以记录缺少身份验证标头的请求。

要求提供有效的令牌

如果请求没有有效的 JWT,表达式 is_jwt_valid("51231d16-01f1-48e3-93f8-91c99e81288e") 将触发操作。

它可以与令牌验证规则中的 block 操作结合使用,以阻止没有凭据或凭据无效的请求。

要求提供两个可能令牌中的至少一个

如果请求没有至少一个有效的令牌,表达式 is_jwt_valid("51231d16-01f1-48e3-93f8-91c99e81288e") or is_jwt_valid("fddfc39e-3686-4683-ab23-bf917da6bb43") 将触发操作。

当您的 API 接受来自两个不同身份提供程序的令牌时,可能会发生这种情况。

要求提供有效的令牌,但忽略没有令牌的请求

如果请求包含无效令牌,表达式 is_jwt_valid("51231d16-01f1-48e3-93f8-91c99e81288e") or not is_jwt_present("51231d16-01f1-48e3-93f8-91c99e81288e") 将触发操作,从而忽略完全没有令牌的请求。

将规则应用于操作

一个操作只能应用一个令牌验证规则。如果一个操作被多个规则覆盖,则优先级最高的规则将生效。

您可以使用 selector 字段配置对哪些操作强制执行 JWT 验证。

例如,以下选择器将把规则应用于 v1.example.com 和 v2.example.com 中的所有操作,但这些主机上的两个操作除外:

选择器示例json
{
	"include": [
		{
			"host": ["v1.example.com", "v2.example.com"]
		}
	],
	"exclude": [
		{
			"operation_ids": [
				"f9c5615e-fe15-48ce-bec6-cfc1946f1bec",
				"56828eae-035a-4396-ba07-51c66d680a04"
			]
		}
	]
}

操作可以按主机级别包含,并按操作忽略。

您可以使用 POST /zones/{zone_id}/token_validation/rules/preview 端点查看此规则覆盖的操作。

使用 page 和 per_page 查询参数对操作进行分页。它们默认分别为第 1 页和每页 20 个操作。每个响应在 result.operations 中包含一页,并在 result_info 中包含分页元数据。

使用 cURL 的示例bash
curl --request POST \
'https://api.cloudflare.com/client/v4/zones/{zone_id}/token_validation/rules/preview?page=1&per_page=20' \
--header 'Content-Type: application/json' \
--data '{
    "include": [
        {
            "host": [
                "v1.example.com",
                "v2.example.com"
            ]
        }
    ],
    "exclude": [
        {
            "operation_ids": [
                "f9c5615e-fe15-48ce-bec6-cfc1946f1bec",
                "56828eae-035a-4396-ba07-51c66d680a04"
            ]
        }
    ]
}'

响应包含该 zone 上一页操作以及额外的 state 字段。

state 字段可以是 ignored、excluded 或 included。包含的操作将匹配您指定的主机名选择器。排除的操作将匹配您在选择器中指定的操作 ID。忽略的操作是那些不匹配选择器中任何内容的操作。

结果json
{
	"result": {
		"operations": [
			{
				"operation_id": "ed15fcb6-5a73-41cd-91af-8c61e5bb1cdb",
				"method": "GET",
				"host": "example.com",
				"endpoint": "/api/accounts/{var1}",
				"last_updated": "2023-05-24T14:54:34.806506Z",
				"state": "ignored"
			},
			{
				"operation_id": "e7a582cd-3cfb-4061-ab5b-722e6e42f545",
				"method": "GET",
				"host": "v1.example.com",
				"endpoint": "/api/accounts/{var1}",
				"last_updated": "2023-05-24T14:54:34.806506Z",
				"state": "included"
			},
			{
				"operation_id": "ddd5df5a-795c-40ce-b38c-38e9d7ef9ae8",
				"method": "GET",
				"host": "v2.example.com",
				"endpoint": "/api/accounts/{var1}",
				"last_updated": "2023-05-24T14:54:34.806506Z",
				"state": "included"
			},
			{
				"operation_id": "4d20befb-0120-45d5-9b29-5835fd41b44e",
				"method": "GET",
				"host": "v3.example.com",
				"endpoint": "/api/accounts/{var1}",
				"last_updated": "2023-05-24T14:54:34.806506Z",
				"state": "ignored"
			},
			{
				"operation_id": "f9c5615e-fe15-48ce-bec6-cfc1946f1bec",
				"method": "POST",
				"host": "v1.example.com",
				"endpoint": "/login",
				"last_updated": "2023-05-24T14:54:34.806506Z",
				"state": "excluded"
			},
			{
				"operation_id": "56828eae-035a-4396-ba07-51c66d680a04",
				"method": "POST",
				"host": "v2.example.com",
				"endpoint": "/login",
				"last_updated": "2023-05-24T14:54:34.806506Z",
				"state": "excluded"
			},
			{
				"operation_id": "cf86874c-8d0c-4337-ae14-4e2459b541ac",
				"method": "GET",
				"host": "v3.example.com",
				"endpoint": "login",
				"last_updated": "2023-05-24T14:54:34.806506Z",
				"state": "ignored"
			}
		],
		"total": 7,
		"included": 2,
		"excluded": 2,
		"ignored": 3,
		"selected_hosts": ["v1.example.com", "v2.example.com"],
		"available_hosts": [
			"example.com",
			"v1.example.com",
			"v2.example.com",
			"v3.example.com"
		]
	},
	"success": true,
	"errors": [],
	"messages": [],
	"result_info": {
		"page": 1,
		"per_page": 20,
		"count": 7,
		"total_count": 7
	}
}

state 为 included 的操作将被令牌验证规则覆盖。该响应还在 result.selected_hosts 中显示包含的操作的主机名,并在 result.available_hosts 中显示所有 zone 操作使用的所有主机名。

您也可以在请求正文中发送一个空对象:

使用 cURL 的示例bash
curl --request POST \
'https://api.cloudflare.com/client/v4/zones/{zone_id}/token_validation/rules/preview' \
--header 'Content-Type: application/json' \
--data '{ }'

该响应会显示一页 zone 操作和所有可能的主机,您可以使用它们来构建自己的选择器。

令牌验证规则 JSON 对象

下面的示例展示了一个 JSON 对象,其中包含使用 Cloudflare API 创建令牌验证规则所需的所有必要信息。

将任何令牌配置 ID 和操作 ID 替换为您的 zone 中存在的 ID。

令牌验证规则 JSON 示例json
[
	{
		"title": "JWT Validation on v1 and v2.example.com",
		"description": "Log requests without a valid authorization header.",
		"action": "log",
		"enabled": true,
		"expression": "is_jwt_valid(\"00170473-ec24-410e-968a-9905cf0a7d03\")",
		"selector": {
			"include": [
				{
					"host": ["v1.example.com", "v2.example.com"]
				}
			],
			"exclude": [
				{
					"operation_ids": [
						"f9c5615e-fe15-48ce-bec6-cfc1946f1bec",
						"56828eae-035a-4396-ba07-51c66d680a04"
					]
				}
			]
		}
	}
]

使用 Cloudflare API 创建令牌验证规则

使用 cURL 或任何其他 API 客户端工具将新配置发送到 Cloudflare 的 API 以启用 JWT 验证。确保将 {zone_id} 替换为相关的 zone ID,并添加您的身份验证凭据标头。

将任何令牌配置 ID 和操作 ID 替换为您的 zone 中存在的 ID。

单次请求可以创建多个规则。为此,请在请求正文的 JSON 数组中传递多个规则对象。

使用 cURL 的示例bash
curl "https://api.cloudflare.com/client/v4/zones/{zone_id}/token_validation/rules/bulk" \
--header 'Content-Type: application/json' \
--data '[
    {
        "title": "JWT Validation on v1 and v2.example.com",
        "description": "Log requests without a valid authorization header.",
        "action": "log",
        "enabled": true,
        "expression": "is_jwt_valid(\"00170473-ec24-410e-968a-9905cf0a7d03\")",
        "selector": {
            "include": [
                {
                    "host": [
                        "v1.example.com",
                        "v2.example.com"
                    ]
                }
            ],
            "exclude": [
                {
                    "operation_ids": [
                        "f9c5615e-fe15-48ce-bec6-cfc1946f1bec",
                        "56828eae-035a-4396-ba07-51c66d680a04"
                    ]
                }
            ]
        }
    }
]'

响应将包含在 Cloudflare v4 响应信封中,其结果包含已创建的规则。请注意每个规则返回的 ID,它可以用于编辑或删除现有规则。

结果json
{
	"result": [
		{
			"id": "5ec7c417-6964-4b24-b82c-a23a7ec8f90c",
			"title": "JWT Validation on v1 and v2.example.com",
			"description": "Log requests without a valid authorization header.",
			"action": "log",
			"enabled": true,
			"expression": "is_jwt_valid(\"00170473-ec24-410e-968a-9905cf0a7d03\")",
			"selector": {
				"include": [
					{
						"host": ["v1.example.com", "v2.example.com"]
					}
				],
				"exclude": [
					{
						"operation_ids": [
							"f9c5615e-fe15-48ce-bec6-cfc1946f1bec",
							"56828eae-035a-4396-ba07-51c66d680a04"
						]
					}
				]
			},
			"created_at": "2023-10-18T12:08:09.575388Z",
			"last_updated": "2023-10-18T12:08:09.575388Z",
			"modified_by": "[email protected]"
		}
	],
	"success": true,
	"errors": [],
	"messages": []
}

维护

更新令牌配置

最佳做法是定期轮换密钥。您可以添加新密钥、开始使用该密钥签发 JWT,然后删除旧密钥。

更新密钥的输入与创建配置时提供初始密钥相同,即需要是一个 JWK。

凭据更新使用与创建配置相同的算法默认行为。响应会在 result 中包含规范化凭据,并为每个被默认的算法包含一条消息。

使用 PUT 替换完整密钥集。PUT 请求中的每个对称密钥都必须包含 k。请求中省略的密钥会被移除。

使用 cURL 的示例bash
curl --request PUT \
'https://api.cloudflare.com/client/v4/zones/{zone_id}/token_validation/config/{config_id}/credentials' \
--header 'Content-Type: application/json' \
--data '{
    "keys": [
        {
            "kty": "EC",
            "use": "sig",
            "kid": "test",
            "x": "-0LNzBheJPn-Zy6JmanTIUX7xc3jgqU714IQY0oU6mw",
            "y": "KONxBybUcRsJQmtu17jMAHsILSw009AuU3ulfUGv3FI",
            "alg": "ES256"
        },
        {
            "kty": "EC",
            "crv": "P-256",
            "kid": "test-2",
            "x": "iIbPRbOeLzjGPvv7iwmzCOTU03R0xDqbenp2D6GUcWo",
            "y": "tDkEh95PnfWwIXciCtdBBVA7wfghx_egmZ1Zcvu2lWw",
            "alg": "ES256"
        }
    ]
}'

确保将 {zone_id} 替换为相关的 zone ID,并添加您的身份验证凭据标头。

保留或轮换对称凭据

使用 PATCH 更新完整密钥集,而无需重新提交已存储的对称凭据。Cloudflare 使用 alg 和 kid 值匹配现有密钥。

  • 对于匹配的对称密钥,省略 k 以保留其凭据。
  • 包含新的 k 值以轮换凭据。
  • 添加尚不存在的对称密钥时包含 k。
  • 从 keys 中省略某个密钥可将其从配置中移除。
  • 不要将 k 设置为 null。

此示例在添加 EC 密钥的同时保留 production-hmac-key 的凭据:

保留对称凭据bash
curl --request PATCH \
'https://api.cloudflare.com/client/v4/zones/{zone_id}/token_validation/config/{config_id}/credentials' \
--header 'Content-Type: application/json' \
--data '{
    "keys": [
        {
            "kty": "oct",
            "alg": "HS256",
            "kid": "production-hmac-key"
        },
        {
            "kty": "EC",
            "alg": "ES256",
            "crv": "P-256",
            "kid": "production-ec-key",
            "x": "<BASE64URL_ENCODED_X_COORDINATE>",
            "y": "<BASE64URL_ENCODED_Y_COORDINATE>"
        }
    ]
}'

此示例轮换现有 HMAC 密钥的凭据:

轮换对称凭据bash
curl --request PATCH \
'https://api.cloudflare.com/client/v4/zones/{zone_id}/token_validation/config/{config_id}/credentials' \
--header 'Content-Type: application/json' \
--data '{
    "keys": [
        {
            "kty": "oct",
            "alg": "HS256",
            "kid": "production-hmac-key",
            "k": "<NEW_BASE64URL_ENCODED_SECRET>"
        }
    ]
}'

更新令牌验证规则

可以使用 PATCH 请求更新令牌验证规则。单个 PATCH 请求可以更新多个规则。

PATCH 请求在请求正文中被指定为 JSON 数组。该数组中的每一项都包含对单个规则(由 id 定义)的更新。

以下示例更新了一个规则并禁用了另一个规则:

使用 cURL 的示例bash
curl --request PATCH \
"https://api.cloudflare.com/client/v4/zones/{zone_id}/token_validation/rules/bulk"  \
--header "Content-Type: application/json" \
--data '[
    {
        "id": "714d3dd0-cc59-4911-862f-8a27e22353cc",
        "action": "log",
        "title": "updated title"
    },
    {
        "id": "7124f9bc-d6b5-430d-b488-b6bc2892f2fb",
        "enabled": false
    }
]'

规则可以通过在 PATCH 正文中设置 position 字段来重新排序。

此示例将规则 714d3dd0-cc59-4911-862f-8a27e22353cc 放置在规则 7124f9bc-d6b5-430d-b488-b6bc2892f2fb 之后:

使用 cURL 的示例bash
curl --request PATCH \
"https://api.cloudflare.com/client/v4/zones/{zone_id}/token_validation/rules/bulk" \
--header 'Content-Type: application/json' \
--data '[
    {
        "id": "714d3dd0-cc59-4911-862f-8a27e22353cc",
        "position": {
            "after": "7124f9bc-d6b5-430d-b488-b6bc2892f2fb"
        }
    }
]'

此示例将规则 714d3dd0-cc59-4911-862f-8a27e22353cc 放置在规则 7124f9bc-d6b5-430d-b488-b6bc2892f2fb 之前:

使用 cURL 的示例bash
curl --request PATCH \
"https://api.cloudflare.com/client/v4/zones/{zone_id}/token_validation/rules/bulk" \
--header 'Content-Type: application/json' \
--data '[
    {
        "id": "714d3dd0-cc59-4911-862f-8a27e22353cc",
        "position": {
            "before": "7124f9bc-d6b5-430d-b488-b6bc2892f2fb"
        }
    }
]'

执行 JWT 验证

以下是 JWT 验证如何处理传入请求的概述:

  1. 我们根据传入请求的配置提取 JWT。
  2. 我们解码 JWT 并查找 JWT 标头的 KID 声明。
  3. 我们使用 KID 和 ALG 声明在提供的密钥列表中查找正确的密钥。
  1. 我们通过使用所选密钥检查签名来验证 JWT 的真实性。
  2. 如果 JWT 包含 EXP 声明(过期时间),我们将验证 JWT 是否未过期。
  1. 如果 JWT 包含 NBF 声明(生效时间),我们将验证 JWT 是否已经生效。
  1. Cloudflare 将已验证声明作为 http.request.jwt.claims 字段提供。WAF 自定义规则可以根据这些声明采取操作。令牌验证规则可以根据令牌是否存在以及是否有效采取操作。
  2. Cloudflare 仪表板中针对 API Shield - Token Validation 服务的安全分析事件将在事件的 Token validation violations 部分中说明违规原因。

这篇文档对您有帮助吗?