Cloudflare
The Cloudflare Integration deploys a Cloudflare Worker in your Cloudflare account. This Worker serves the OverpoweredJS fingerprinting agent and proxies identification requests through paths on your domain, so every call executes in a first‑party context.
Benefits
- Higher accuracy & extended cookies – First‑party execution improves detection in Safari/Firefox and allows cookies to persist beyond normal third‑party limits.
- Ad‑blocker resilience & edge caching – Requests originate from your domain, bypassing most ad‑blockers; Cloudflare’s global cache lowers latency.
Architecture Overview
- A pre‑configured Worker is installed under a base route (e.g.
/fingerprint/*). - The Worker serves the fingerprinting script from Cloudflare’s edge.
- POST requests with fingerprint data are relayed upstream, signed with
PROXY_SECRETfor authentication.
Cloudflare Workers in Brief
- Lightweight JavaScript executed in Cloudflare’s global data centers.
- Route‑based: a pattern like
/base/*onexample.comdirects matching traffic to the Worker. - Can return a response directly or use
fetch()to proxy upstream.
Deployment Details
| Step | Action |
|---|---|
| 1. Provision Worker | Enabling the integration deploys the Worker to your selected zone and assigns a base route (default /fingerprint/*). |
| 2. Environment Variables | The Worker is provisioned with: |
| Variable | Description |
| --------------------- | --------------------------------------------- |
FINGERPRINT_PATH | Route that receives POSTs |
PROXY_SECRET | Shared secret for request signing |
| 3. Load Script | |
html<br/><script src="https://yourdomain.com/${WORKER_BASE}/${SCRIPT_PATH}"></script><br/> | |
| 4. Invoke API | javascript<br/>opjs({<br/> API_KEY: 'my-api-key',<br/> ENDPOINT: `https://yourdomain.com/${WORKER_BASE}/${FINGERPRINT_PATH}`<br/>}).then(fp => console.log(fp));<br/> |
Activation Guide
- Open Integrations in the dashboard.
- Click Connect under Cloudflare.
- Provide your Cloudflare Account ID and an API Token with Worker permissions.
- Select the target domain (zone) and confirm. The Worker deploys in a few minutes.