Skip to content

Commit 96174a8

Browse files
authored
[Ruleset Eng, Workers] Add new TLS fields (#21445)
1 parent e0d1c38 commit 96174a8

File tree

2 files changed

+31
-1
lines changed

2 files changed

+31
-1
lines changed

src/content/docs/workers/runtime-apis/request.mdx

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -252,6 +252,18 @@ All plans have access to:
252252

253253
* Only set when using Cloudflare Access or API Shield (mTLS). Object with the following properties: `certFingerprintSHA1`, `certFingerprintSHA256`, `certIssuerDN`, `certIssuerDNLegacy`, `certIssuerDNRFC2253`, `certIssuerSKI`, `certIssuerSerial`, `certNotAfter`, `certNotBefore`, `certPresented`, `certRevoked`, `certSKI`, `certSerial`, `certSubjectDN`, `certSubjectDNLegacy`, `certSubjectDNRFC2253`, `certVerified`.
254254

255+
* `tlsClientCiphersSha1` string
256+
257+
* The SHA-1 hash (Base64-encoded) of the cipher suite sent by the client during the TLS handshake, encoded in big-endian format. For example, `"GXSPDLP4G3X+prK73a4wBuOaHRc="`.
258+
259+
* `tlsClientExtensionsSha1` string
260+
261+
* The SHA-1 hash (Base64-encoded) of the TLS client extensions sent during the handshake, encoded in big-endian format. For example, `"OWFiM2I5ZDc0YWI0YWYzZmFkMGU0ZjhlYjhiYmVkMjgxNTU5YTU2Mg=="`.
262+
263+
* `tlsClientExtensionsSha1Le` string
264+
265+
* The SHA-1 hash (Base64-encoded) of the TLS client extensions sent during the handshake, encoded in little-endian format. For example, `"7zIpdDU5pvFPPBI2/PCzqbaXnRA="`.
266+
255267
* `tlsClientHelloLength` string
256268

257269
* The length of the client hello message sent in a [TLS handshake](https://www.cloudflare.com/learning/ssl/what-happens-in-a-tls-handshake/). For example, `"508"`. Specifically, the length of the bytestring of the client hello.

src/content/fields/index.yaml

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -786,10 +786,28 @@ entries:
786786
data_type: String
787787
categories: [Request, SSL/TLS]
788788
keywords: [request, ssl, tls, client, visitor]
789-
summary: The SHA-1 fingerprint of TLS client extensions, encoded in Base64.
789+
summary: The SHA-1 fingerprint of TLS client extensions, encoded in Base64 using big-endian format.
790+
description: For the little-endian version of this field, refer to [`cf.tls_client_extensions_sha1_le`](/ruleset-engine/rules-language/fields/reference/cf.tls_client_extensions_sha1_le/).
790791
example_value: |-
791792
"OWFiM2I5ZDc0YWI0YWYzZmFkMGU0ZjhlYjhiYmVkMjgxNTU5YTU2Mg=="
792793
794+
- name: cf.tls_client_extensions_sha1_le
795+
data_type: String
796+
categories: [Request, SSL/TLS]
797+
keywords: [request, ssl, tls, client, visitor]
798+
summary: The SHA-1 fingerprint of TLS client extensions, encoded in Base64 using little-endian format.
799+
description: For the big-endian version of this field, refer to [`cf.tls_client_extensions_sha1`](/ruleset-engine/rules-language/fields/reference/cf.tls_client_extensions_sha1/).
800+
example_value: |-
801+
"7zIpdDU5pvFPPBI2/PCzqbaXnRA="
802+
803+
- name: cf.tls_ciphers_sha1
804+
data_type: String
805+
categories: [Request, SSL/TLS]
806+
keywords: [request, ssl, tls, client, visitor]
807+
summary: The SHA-1 fingerprint of the client TLS cipher list in received order, encoded in Base64 using big-endian format.
808+
example_value: |-
809+
"GXSPDLP4G3X+prK73a4wBuOaHRc="
810+
793811
- name: cf.tls_client_hello_length
794812
data_type: Number
795813
categories: [Request, SSL/TLS]

0 commit comments

Comments
 (0)