Fingerprint is a device intelligence platform offering 99.5% accurate visitor identification.
Fingerprint Pro CloudFront Integration is responsible for
- Proxying download requests of the latest Fingerprint Pro JS Agent between your site and Fingerprint CDN.
- Proxying identification requests and responses between your site and Fingerprint Pro's APIs.
This improves both accuracy and reliability of visitor identification and bot detection on your site.
You can install the CloudFront proxy integration using a CloudFormation template or as a Terraform module included in this repository. For more details, see the full documentation.
- AWS Account.
- Access to an IAM role in AWS with privileges to manage IAM roles, CloudFront distributions, Secrets Manager, Lambda Functions, and S3 Read Only access.
- Terraform project using the AWS provider with the IAM role described above.
- Terraform CLI.
Important
The AWS CloudFront Proxy Integration is 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.
To set up CloudFront integration using Terraform, you need to:
- Add the Fingerprint Terraform module to your Terraform project.
- Use the module in the configuration of your CloudFront distribution.
- Deploy your Terraform project.
- Configure the Fingerprint JavaScript Agent on your site to communicate with your created Lambda@Edge function.
See CloudFront Proxy Integration guide in our documentation for step-by-step instructions and follow the Terraform installation method. If you have any questions, reach out to our support team.
This repository also includes the following Terraform project examples. Use these examples as a reference, and make sure to follow best practices when provisioning CloudFront distributions:
- Adding the Fingerprint proxy integration to an existing CloudFront distribution (recommended)
- Creating a new CloudFront distribution just for the Fingerprint proxy integration
The Terraform module does include any mechanism for automatic updates. To keep your integration up to date, please run terraform apply
regularly.
This project is licensed under the MIT license. See the LICENSE file for more info.