Skip to content

fingerprintjs/aws-cloudfront-proxy

Repository files navigation

Fingerprint logo

Current version coverage MIT license Discord server

Fingerprint CloudFront Proxy Integration

Fingerprint is a device intelligence platform offering industry-leading accuracy.

The Fingerprint CloudFront Integration is responsible for

  • Proxying download requests of the latest Fingerprint JS Agent between your site and Fingerprint CDN.
  • Proxying identification requests and responses between your site and Fingerprint's APIs.

This improves both accuracy and reliability of visitor identification and bot detection on your site.

Important

CloudFront integration v1 has been deprecated. This repository now contains the source code for CloudFront Integration v2. If you are currently using v1, see our guide for Migrating CloudFront proxy integration from v1 to v2.

Requirements

  • AWS Account

Important

The AWS CloudFront 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.

Warning

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

How to install

To set up CloudFront integration, you need to:

  1. Create the required resources in your AWS infrastructure — a CloudFormation stack and a CloudFront distribution.
  2. Configure the Fingerprint JS Agent on your site to communicate with your created Lambda@Edge function using the endpoints parameter.

See CloudFront Proxy Integration guide in our documentation for step-by-step instructions. If you have any questions, reach out to our support team.

Deployment using Terraform

If you prefer to deploy the integration using Terraform, see the Terraform module repository and the related Terraform guide.

License

This project is licensed under the MIT license. See the LICENSE file for more info.

About

Fingerprint Pro CloudFront Integration is responsible for proxying identification and JavaScript agent download requests that are performed on your AWS infrastructure.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Contributors