browser-fingerprint - Client-Side Browser Fingerprinting Examples

项目说明

Client-Side Browser-Fingerprinting

<p align="center">
<a title="Support this Project (Donate, Support-Licenses)" href="
<img src=" alt="Support Badge (Donate, Support-Licenses)"/>
</a>
</p>

This is an example on how to generate a simple browser-fingerprint for your Web-Clients which you can use for traffic analysis.

Test it: fingerprint.oxl.app

Be aware:

* As we have to set this fingerprint as cookie or request-header - the user could manually modify or replace it.
* If attackers are aware of this they are able to work around it. (*p.e. randomize the hash*)
* Clients with noscript or bots without JS-capabilities will not send any fingerprint.

You have to think of those facts when you are analyzing your request-logs.

----

You might want to combine it with ser client-fingerprinting techniques like JA4. See:

* O-X-L/haproxy-ja4
* O-X-L/haproxy-ja4h
* O-X-L/haproxy-ja3n

More information:

* OXL Docs
* Mozilla - Browser Fingerpinting
* github.com/niespodd
* TCP/OS Fingerpinting
* fingerprintjs

----

Example

We utilize the OSS thumbmarkjs library.

Result

* Linux Laptop Chromium 136.x => linux_chrome_1536x864_347e44db7f27cb8c236bec1ae84791ce
* Linux Laptop Chromium 136.x private tab => linux_chrome_1536x864_347e44db7f27cb8c236bec1ae84791ce
* Linux Laptop Firefox 128.x => linux_firefox_1536x864_957bc354b66b5f2def573500c8c0f466
* Linux Laptop Firefox 128.x private tab => linux_firefox_1536x864_957bc354b66b5f2def573500c8c0f466

Minimal Code

项目信息

开发语言：TypeScript

Star 数：4

技术要点

该项目属于防护思路方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Client-Side Browser Fingerprinting Examples展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。