Skip to content

Commit 84c81c3

Browse files
patriciasantaanamaxvp
authored andcommitted
[Bots] update JA3/JA4 fingerprint documentation (#21042)
* update JA3/JA4 fingerprint documentation * Update src/content/partials/bots/ja3-ja4-null.mdx Co-authored-by: Max Phillips <[email protected]> --------- Co-authored-by: Max Phillips <[email protected]>
1 parent b8d84aa commit 84c81c3

File tree

4 files changed

+14
-8
lines changed

4 files changed

+14
-8
lines changed

src/content/docs/bots/concepts/ja3-ja4-fingerprint.mdx

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
pcx_content_type: concept
3-
title: JA3/JA4 Fingerprint
3+
title: JA3/JA4 fingerprint
44

55
---
66

@@ -72,6 +72,8 @@ When JA4 Signals are missing, the output appears as follows:
7272
This sample was generated using [Workers' Cloudflare Object script](/workers/examples/accessing-the-cloudflare-object/).
7373
:::
7474

75+
<Render file="ja3-ja4-null" />
76+
7577
## Analytics
7678

7779
To get more information about potential bot requests, use these JA3 and JA4 fingerprints in:

src/content/docs/bots/troubleshooting.mdx

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -83,13 +83,9 @@ To allow traffic from good bots, use the [Verified Bot](/ruleset-engine/rules-la
8383

8484
---
8585

86-
## Why might the ja3hash be empty in HTTP logs?
86+
## Why might the ja3hash or JA4 be empty in HTTP logs?
8787

88-
The JA3 Fingerprint can be null or empty in some cases. The most common case is for HTTP requests, because JA3 is calculated in TLS, but can also be empty due to the following:
89-
90-
- Orange to Orange zones (Cloudflare Zone proxied to another Cloudflare Zone).
91-
92-
- Worker sending requests within the same zone or to a zone that is not proxied (or a 3rd party).
88+
<Render file="ja3-ja4-null" />
9389

9490
---
9591

src/content/partials/bots/ja3-fingerprint.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,4 +3,4 @@
33

44
---
55

6-
[**JA3**](https://github.com/salesforce/ja3) and [**JA4**](https://github.com/FoxIO-LLC/ja4) **Fingerprints** help you profile specific SSL/TLS clients across different destination IPs, Ports, and X509 certificates.
6+
[**JA3**](https://github.com/salesforce/ja3) and [**JA4**](https://github.com/FoxIO-LLC/ja4) **fingerprints** help you profile specific SSL/TLS clients across different destination IPs, Ports, and X509 certificates.
Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
{}
3+
4+
---
5+
6+
The [JA3/JA4 fingerprint](/bots/concepts/ja3-ja4-fingerprint/) can be null or empty in some cases. The most common case is for HTTP requests because JA3 and JA4 are calculated in TLS. It can also be empty due to the Worker sending requests within the same zone or to a zone that is not proxied (or a third party).
7+
8+
[Orange to Orange (O2O)](/cloudflare-for-platforms/cloudflare-for-saas/saas-customers/) should not cause null or empty JA3 or JA4 fingerprints, unless the eyeball zone is routing traffic to the target zone using a Worker.

0 commit comments

Comments
 (0)