Fingerprint Pro Fastly Compute Proxy Integration

Fingerprint is a device intelligence platform offering highly accurate visitor identification.

The Fastly Compute Proxy Integration is responsible for proxying identification and agent-download requests between your application and Fingerprint through your Fastly infrastructure. This integration uses Fastly Compute services.

🚧 Requirements and expectations

• Integration in Beta: Please report any issues to our support team.

• Limited to Enterprise customers: At this point, this proxy integration is accessible and exclusively supported for customers on the Enterprise Plan. Other customers are encouraged to use Custom subdomain setup or Cloudflare Proxy Integration.

• Manual updates occasionally required: The underlying data contract in the identification logic can change to keep up with browser updates. Using the Fastly Compute Proxy Integration might require occasional manual updates on your side. Ignoring these updates will lead to lower accuracy or service disruption.

Getting started

This is a quick overview of the installation setup. For detailed step-by-step instructions, see the Fastly Compute proxy integration guide in our documentation.

1. Go to the Fingerprint Dashboard > API Keys and click Create Proxy Key to create a proxy secret. You will use it later to authenticate your requests to Fingerprint APIs.

2. Create an empty Compute Service in your Fastly account.

3. Add a backend named fingerprint to your Compute service, pointing to the regional Fingerprint API host for your workspace:

   Region	Host
   Global (US)	api.fpjs.io
   EU	eu.api.fpjs.io
   Asia	ap.api.fpjs.io

   The proxy integration expects the backend to be named exactly fingerprint.

4. Create a Secret store named Fingerprint_Compute_Secret_Store_<SERVICE_ID>, where the suffix is your proxy integration's Compute Service ID. Add your proxy secret:

   Key	Example Value	Description
   PROXY_SECRET	6XI9CLf3C9oHSB12TTaI	Fingerprint proxy secret generated in Step 1.

5. Go to Releases to download the latest fingerprint-fastly-compute-proxy-integration.tar.gz package file.

6. Upload package to your Fastly Compute Service's Package.

7. Configure the Fingerprint JavaScript Agent on your website:

   import * as Fingerprint from '@fingerprint/agent';
   
   const fp = Fingerprint.start({
     apiKey: 'PUBLIC_API_KEY',
     endpoints: 'https://metrics.yourwebsite.com/',
     region: 'us',
   });

   JavaScript agent v3: If you are still using the v3 agent (@fingerprintjs/fingerprintjs-pro), you need to also create a Config store named Fingerprint_Compute_Config_Store_<SERVICE_ID> with AGENT_SCRIPT_DOWNLOAD_PATH and GET_RESULT_PATH entries, and configure scriptUrlPattern and endpoint accordingly. See the v3 to v4 migration guide for details.

See the Fastly Compute proxy integration guide in our documentation for more details.

Feedback and support

Please reach out to our Customer Success team if run into any issues with the integration.

License

This project is licensed under the MIT license.